Open in
Povežite se iz Talkdesk
Klice Talkdesk usmerite do agenta ThunderPhone s funkcijo Connect to Autopilot Voice in jih z ID-jem predaje v UUI eskalirajte nazaj.
Vaš tok Talkdesk Studio pošlje klicatelja agentu z ID-jem interakcije in UUI. Ko klicatelj potrebuje osebo, agent eskalira s SIP REFER v Talkdesk, ID predaje pa se shrani v spremenljivko Studio.
Preden začnete
- Agent ThunderPhone in organizacijski ključ API.
- Licenca Talkdesk Conversation Orchestrator, ki vključuje komponento Studio Poveži z Autopilot Voice v načinu Zunanji glasovni tok (članek Talkdesk). Talkdesk jo zaračunava na minuto, medtem ko agent zadrži klic.
1. Ustvarite končno točko SIP
Talkdesk dokumentira le seznam dovoljenih naslovov IP, zato ustvarite končno točko, ki sprejema klice glede na izvorni naslov:
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"
}'Članek Talkdesk navaja, da zvok pošilja prek SRTP, in "srtp": "optional"
odgovori s SRTP, ko ga Talkdesk ponudi. Članek ne navaja, ali Talkdesk
zahteva SRTP; če vam Talkdesk pove, da ga zahteva, nastavite srtp na required, kar
zavrne klice brez njega.
Obsege SIP-signalizacije Talkdesk pridobite pri Talkdesk. Vsak mora biti javni obseg IPv4
/16 ali ožji (IPv6 /48 ali ožji). Oglejte si
platforme, ki preverjajo pristnost z izvornim IP-jem.
Talkdesk pošilja SIP iz omrežja Twilio, katerega naslove uporabljajo vse stranke Twilio,
zato naslov končne točke preprečuje dostop drugim klicateljem: ne
objavite ga.
Shranite sip_uri iz odgovora, na primer
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. Pošljite klice s kontekstom
V toku Studio dodajte Poveži z Autopilot Voice v načinu Zunanji glasovni
tok in nastavite njegov cilj na sip_uri končne točke z dodanim ;transport=tls, na
primer sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls. Končna
točka zavrne klice prek UDP, ki ga SIP Twilio uporablja, če ni določeno drugače.
Talkdesk pošlje:
X-Talkdesk-Interaction-Id, shranjen kotexternal_call_idklica;User-to-User, šestnajstiško kodiran, na primerbusiness_hours=open. Do poziva prispe dekodiran kot{{sip_uui}}.
Različica 2.1 komponente lahko pošlje tudi Določene glave. Stran z nastavitvami Talkdesk jih opisuje kot JSON, poslan prek WebSocket, zato pri Talkdesk potrdite, ali prispejo kot glave SIP, preden se nanje zanesete.
3. Prejmite klic nazaj
Agent eskalira z REFER na Talkdeskov naslov za eskalacijo, pri čemer je ID
predaje kot šestnajstiški UUI v tem naslovu, saj je to edino mesto, kjer ga
Talkdesk prebere. Dodajte to številko za preusmeritev (glejte
Dodajte številko za preusmeritev
in Glave v naslovu za preusmeritev):
{
"name": "Talkdesk escalation",
"number": "sip:escalation@talkdesk.com",
"headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}Naslov je naveden v Talkdeskovem članku. Različica komponente 2.1 prebere
autopilot_result=; različica 1.7 prebere escalate_to=, zato pri različici
1.7 uporabite ta ključ. REFER je videti tako:
Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>
Talkdesk vrednost shrani v spremenljivko Studio. Če želite pridobiti povzetek in namen, dodajte korak Izvedite dejanje v integracijo po meri, izdelano s Connections:
- Vrsta preverjanja pristnosti ključ API, ime glave
Authorization, vrednostBearer sk_live_…. - Zahteva:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=, ki ji sledi ID iz spremenljivke. Klic lahko poiščete tudi poexternal_call_idz ID-jem interakcije. - Usmerite glede na
handoff.intentin osebi, ki prevzame klic, prikažitehandoff.summary.
Glejte Poiščite predani klic.
Preizkusite
Začnite klic prek toka Studio, agenta prosite, naj vas poveže z osebo, in
preverite, da se tok nadaljuje mimo komponente z ID-jem predaje v njeni
spremenljivki. Nato odprite klic z GET /v1/calls/{call_id}:
external_call_id mora biti ID interakcije Talkdesk.
Omejitve
- Talkdesk prebere največ 256 bajtov UUI-ja in ne dovoljuje vrednosti, ločenih z
|ali;, zato pošljite eno vrednost. ID predaje ustreza. - API-ji Talkdesk ne morejo prebrati prepisa agenta. Namesto tega uporabite
iskanje predanega klica ali
GET /v1/calls/{call_id}.