Open in
Pripojenie z Talkdesk
Odosielajte hovory z Talkdesk hlasovému agentovi ThunderPhone pomocou funkcie Connect to Autopilot Voice a eskalujte ich späť pomocou ID odovzdania v UUI.
Váš tok Talkdesk Studio odošle volajúceho agentovi s ID interakcie
a UUI. Keď volajúci potrebuje človeka, agent hovor eskaluje pomocou SIP
REFER do Talkdesk a ID odovzdania sa uloží do premennej Studio.
Skôr než začnete
- Agent ThunderPhone a kľúč API organizácie.
- Licenciu Talkdesk Conversation Orchestrator, ktorá zahŕňa komponent Studio Pripojiť k Autopilot Voice v režime Externý hlasový prúd (článok Talkdesk). Talkdesk ju účtuje za minútu, počas ktorej agent vedie hovor.
1. Vytvorte koncový bod SIP
Talkdesk dokumentuje iba zoznam povolených IP adries, preto vytvorte koncový bod, ktorý prijíma hovory podľa zdrojovej adresy:
curl -X POST https://api.thunderphone.com/v1/sip-endpoints \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"agent_id": 12,
"name": "Talkdesk",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["TALKDESK_SIGNALLING_RANGE_1", "TALKDESK_SIGNALLING_RANGE_2"],
"srtp": "optional"
}'Článok Talkdesk uvádza, že zvuk odosiela cez SRTP, a "srtp": "optional"
odpovie cez SRTP, keď ho Talkdesk ponúkne. Článok neuvádza, či Talkdesk
vyžaduje SRTP; ak vám Talkdesk oznámi, že áno, nastavte srtp na required,
čím odmietnete hovory bez SRTP.
Rozsahy signalizačných SIP adries Talkdesk získate od Talkdesk. Každý musí byť
verejný rozsah IPv4 s maskou /16 alebo užšou (IPv6 /48 alebo užšou). Pozrite si
platformy overujúce podľa zdrojovej IP adresy.
Talkdesk odosiela SIP zo siete Twilio, ktorej adresy zdieľa každý zákazník Twilio,
preto je adresa koncového bodu tým, čo zabraňuje prístupu iných volajúcich: nezverejňujte ju.
Uschovajte si hodnotu sip_uri z odpovede, napríklad
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. Odosielajte hovory s kontextom
Do toku Studio pridajte Pripojiť k Autopilot Voice v režime Externý hlasový
prúd a nastavte jeho cieľ na sip_uri koncového bodu s pridaným ;transport=tls, napríklad
sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls. Koncový bod
odmieta hovory cez UDP, ktoré SIP Twilio používa, ak nie je uvedené inak.
Talkdesk odosiela:
X-Talkdesk-Interaction-Id, uložené akoexternal_call_idhovoru;User-to-User, kódované hexadecimálne, napríkladbusiness_hours=open. Do výzvy sa dostane dekódované ako{{sip_uui}}.
Verzia 2.1 komponentu môže odosielať aj Definované hlavičky. Stránka nastavení Talkdesk ich opisuje ako JSON odosielaný cez WebSocket, preto si pred ich použitím overte u Talkdesk, či prichádzajú ako hlavičky SIP.
3. Získanie hovoru späť
Agent eskaluje pomocou REFER na eskalačnú adresu Talkdesk, pričom ID
odovzdania je vo forme hexadecimálneho UUI v tejto adrese, čo je jediné miesto,
kde ho Talkdesk číta. Pridajte toto číslo na prenos (pozrite si
Pridanie čísla na prenos
a Hlavičky v adrese na prenos):
{
"name": "Talkdesk escalation",
"number": "sip:escalation@talkdesk.com",
"headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}Adresa je tá, ktorá je uvedená v článku Talkdesk. Komponent vo verzii 2.1
číta autopilot_result=; verzia 1.7 číta escalate_to=, preto vo verzii 1.7
použite tento kľúč. REFER vyzerá takto:
Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>
Talkdesk uloží hodnotu do premennej Studio. Ak chcete získať súhrn a zámer, pridajte krok Spustiť akciu do vlastnej integrácie vytvorenej pomocou Pripojení:
- Typ overenia Kľúč API, názov hlavičky
Authorization, hodnotaBearer sk_live_…. - Požiadavka:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=nasledovaná ID z premennej. Hovor môžete vyhľadať aj podľaexternal_call_idpomocou ID interakcie. - Smerujte podľa
handoff.intenta zobraztehandoff.summaryosobe, ktorá hovor prevezme.
Pozrite si Vyhľadanie odovzdaného hovoru.
Otestujte to
Spustite hovor prostredníctvom toku Studio, požiadajte agenta o spojenie s
osobou a overte, že tok pokračuje za komponentom s ID odovzdania v jeho
premennej. Potom otvorte hovor pomocou GET /v1/calls/{call_id}:
external_call_id by malo byť ID interakcie Talkdesk.
Limity
- Talkdesk prečíta najviac 256 bajtov UUI a nepovoľuje hodnoty oddelené
znakom
|ani;, preto odošlite jednu hodnotu. ID odovzdania sa zmestí. - Rozhrania API Talkdesk nedokážu čítať prepis agenta. Použite namiesto toho
vyhľadanie odovzdaného hovoru alebo
GET /v1/calls/{call_id}.