ThunderPhone v3 je tu.Začnite sami, už od 2 ¢/min.Prečítať oznámenie

Contact centers

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é ako external_call_id hovoru;
  • User-to-User, kódované hexadecimálne, napríklad business_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, hodnota Bearer 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ľa external_call_id pomocou ID interakcie.
  • Smerujte podľa handoff.intent a zobrazte handoff.summary osobe, 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}.