Open in
Savienošana no Talkdesk
Nosūtiet Talkdesk zvanus ThunderPhone balss aģentam, izmantojot Connect to Autopilot Voice, un eskalējiet tos atpakaļ, izmantojot UUI norādīto pārsūtīšanas ID.
Jūsu Talkdesk Studio plūsma nosūta zvanītāju balss aģentam ar mijiedarbības
ID un UUI. Kad zvanītājam nepieciešams cilvēks, balss aģents pāradresē zvanu
uz Talkdesk ar SIP REFER, un nodošanas ID nonāk Studio mainīgajā.
Pirms sākat
- ThunderPhone balss aģents un organizācijas API atslēga.
- Talkdesk Conversation Orchestrator licence, kas ietver Studio komponentu Savienot ar Autopilot Voice režīmā Ārējā balss straume (Talkdesk raksts). Talkdesk par to norēķina par minūti, kamēr balss aģents uztur zvanu.
1. Izveidojiet SIP galapunktu
Talkdesk dokumentācijā ir norādīts tikai IP atļauju saraksts, tāpēc izveidojiet galapunktu, kas pieņem zvanus pēc avota adreses:
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"
}'Talkdesk rakstā teikts, ka tas sūta audio pa SRTP, un "srtp": "optional"
atbild ar SRTP, kad Talkdesk to piedāvā. Rakstā nav norādīts, vai Talkdesk
pieprasa SRTP; ja Talkdesk jums norāda, ka tas ir nepieciešams, iestatiet
srtp uz required, kas noraida zvanus bez tā.
Saņemiet Talkdesk SIP signalizācijas diapazonus no Talkdesk. Katram jābūt
publiskam IPv4 diapazonam ar /16 vai šaurāku masku (IPv6 — ar /48 vai
šaurāku masku). Skatiet
Platformas, kas autentificē pēc avota IP.
Talkdesk sūta SIP no Twilio tīkla, kura adreses koplieto visi Twilio klienti,
tāpēc galapunkta adrese ir tas, kas neļauj piekļūt citiem zvanītājiem:
nepublicējiet to.
Saglabājiet atbildes sip_uri, piemēram,
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. Sūtiet zvanus ar kontekstu
Savā Studio plūsmā pievienojiet Savienot ar Autopilot Voice režīmā
Ārējā balss straume un iestatiet tā mērķi uz galapunkta sip_uri, kam pievienots ;transport=tls, piemēram,
sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls. Galapunkts
noraida zvanus pa UDP, ko Twilio SIP izmanto, ja nav norādīts citādi.
Talkdesk sūta:
X-Talkdesk-Interaction-Id, kas tiek saglabāts kā zvanaexternal_call_id;User-to-User, heksadecimāli kodētu, piemēram,business_hours=open. Tas uzvednē nonāk atkodēts kā{{sip_uui}}.
Komponenta versija 2.1 var sūtīt arī Definētās galvenes. Talkdesk iestatījumu lapā tās ir aprakstītas kā JSON, kas tiek sūtīts pa WebSocket, tāpēc pirms paļaujaties uz tām, apstipriniet ar Talkdesk, vai tās tiek saņemtas kā SIP galvenes.
3. Saņemiet zvanu atpakaļ
Aģents eskalē ar REFER uz Talkdesk eskalācijas adresi, kurā nodošanas ID ir kā heksadecimāls UUI — tā ir vienīgā vieta, kur Talkdesk to nolasa.
Pievienojiet šo pārsūtīšanas numuru (skatiet
Pievienojiet pārsūtīšanas numuru
un Galvenes pārsūtīšanas adresē):
{
"name": "Talkdesk escalation",
"number": "sip:escalation@talkdesk.com",
"headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}Izmantojiet Talkdesk rakstā norādīto adresi. Komponenta versija 2.1
nolasa autopilot_result=; versija 1.7 nolasa escalate_to=, tāpēc versijā
1.7 izmantojiet šo atslēgu. REFER izskatās šādi:
Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>
Talkdesk ievieto vērtību Studio mainīgajā. Lai iegūtu kopsavilkumu un nolūku, pievienojiet darbību Izpildīt darbību pielāgotā integrācijā, kas izveidota ar Savienojumiem:
- Autentifikācijas veids — API atslēga, galvenes nosaukums
Authorization, vērtībaBearer sk_live_…. - Pieprasījums:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=un pēc tam ID no mainīgā. Zvanu varat arī uzmeklēt pēcexternal_call_id, izmantojot mijiedarbības ID. - Veidojiet maršrutēšanu pēc
handoff.intentun rādiethandoff.summarypersonai, kura pārņem zvanu.
Skatiet Uzmeklējiet nodotu zvanu.
Pārbaudiet
Sāciet zvanu, izmantojot Studio plūsmu, palūdziet aģentam savienot ar personu un pārbaudiet,
vai plūsma turpinās aiz komponenta, kura mainīgajā ir nodošanas ID. Pēc tam atveriet zvanu ar GET /v1/calls/{call_id}:
external_call_id jābūt Talkdesk mijiedarbības ID.
Ierobežojumi
- Talkdesk nolasa ne vairāk kā 256 UUI baitus un neatļauj vērtības, kas atdalītas ar
|vai;, tāpēc sūtiet vienu vērtību. Nodošanas ID tajā ietilpst. - Talkdesk API nevar nolasīt aģenta transkripciju. Tā vietā izmantojiet nodošanas uzmeklēšanu vai
GET /v1/calls/{call_id}.