Open in
Prisijungimas iš Talkdesk
Nukreipkite Talkdesk skambučius į ThunderPhone agentą naudodami Connect to Autopilot Voice ir peradresuokite juos atgal naudodami perėmimo ID UUI.
Jūsų Talkdesk Studio srautas siunčia skambintoją agentui kartu su sąveikos
identifikatoriumi ir UUI. Kai skambintojui reikia žmogaus, agentas perduoda
skambutį Talkdesk naudodamas SIP REFER, o perdavimo identifikatorius patenka į
Studio kintamąjį.
Prieš pradedant
- ThunderPhone agentas ir organizacijos API raktas.
- Talkdesk Pokalbių orkestratoriaus licencija, apimanti Studio komponentą Prisijungti prie Autopilot Voice režimu Išorinis balso srautas (Talkdesk straipsnis). Talkdesk už jį skaičiuoja mokestį už minutę, kol agentas palaiko skambutį.
1. Sukurkite SIP galinį tašką
Talkdesk nurodo tik IP leidžiamųjų adresų sąrašą, todėl sukurkite galinį tašką, kuris priima skambučius pagal šaltinio adresą:
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 straipsnyje nurodyta, kad garsas siunčiamas per SRTP, o "srtp": "optional"
atsako naudodamas SRTP, kai Talkdesk jį siūlo. Straipsnyje nenurodyta, ar Talkdesk
reikalauja SRTP; jei Talkdesk nurodo, kad reikalauja, nustatykite srtp į required,
kad būtų atmetami skambučiai be jo.
Gaukite Talkdesk SIP signalizavimo diapazonus iš Talkdesk. Kiekvienas turi būti
viešasis IPv4 diapazonas /16 arba siauresnis (IPv6 /48 arba siauresnis). Žr.
Platformos, kurios autentifikuoja pagal šaltinio IP.
Talkdesk siunčia SIP iš Twilio tinklo, kurio adresais dalijasi visi Twilio klientai,
todėl būtent galinio taško adresas neleidžia prisijungti kitiems skambintojams:
neskelbkite jo.
Išsaugokite atsakyme pateiktą sip_uri, pavyzdžiui,
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. Siųskite skambučius su kontekstu
Studio sraute pridėkite Prisijungti prie Autopilot Voice režimu Išorinis balso
srautas ir nustatykite jo tikslą į galinio taško sip_uri, pridėję ;transport=tls,
pavyzdžiui, sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls. Galinis
taškas atmeta skambučius per UDP, kurį Twilio SIP naudoja, jei nenurodyta kitaip.
Talkdesk siunčia:
X-Talkdesk-Interaction-Id, saugomą kaip skambučioexternal_call_id;User-to-User, užkoduotą šešioliktainiu formatu, pvz.,business_hours=open. Jis patenka į raginimą iškoduotas kaip{{sip_uui}}.
Komponento 2.1 versija taip pat gali siųsti Apibrėžtas antraštes. Talkdesk nuostatų puslapyje jos aprašomos kaip JSON, siunčiamas per WebSocket, todėl prieš jomis pasikliaudami patvirtinkite su Talkdesk, ar jos pateikiamos kaip SIP antraštės.
3. Priimkite perduotą skambutį
Agentas eskaluoja skambutį naudodamas REFER į Talkdesk eskalavimo adresą, o
perdavimo ID kaip šešioliktainis UUI yra šiame adrese – vienintelėje vietoje,
kur Talkdesk jį nuskaito. Pridėkite šį perdavimo numerį (žr.
Pridėkite perdavimo numerį
ir Antraštės perdavimo adrese):
{
"name": "Talkdesk escalation",
"number": "sip:escalation@talkdesk.com",
"headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}Adresas yra nurodytas Talkdesk straipsnyje. Komponento 2.1 versija
nuskaito autopilot_result=; 1.7 versija nuskaito escalate_to=, todėl 1.7
versijoje naudokite šį raktą. REFER atrodo taip:
Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>
Talkdesk įrašo reikšmę į Studio kintamąjį. Norėdami gauti suvestinę ir ketinimą, pridėkite veiksmą Vykdyti veiksmą pasirinktinėje integracijoje, sukurtoje naudojant Connections:
- Autentifikavimo tipas API raktas, antraštės pavadinimas
Authorization, reikšmėBearer sk_live_…. - Užklausa:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=ir po jos nurodykite ID iš kintamojo. Skambutį taip pat galite rasti pagalexternal_call_id, naudodami sąveikos ID. - Nukreipkite pagal
handoff.intentir parodykitehandoff.summaryskambutį perimančiam asmeniui.
Žr. Perduoto skambučio paieška.
Išbandykite
Pradėkite skambutį per Studio srautą, paprašykite agento sujungti su žmogumi ir
patikrinkite, ar srautas tęsiasi už komponento ribų, o jo kintamajame yra
perdavimo ID. Tada atidarykite skambutį naudodami GET /v1/calls/{call_id}:
external_call_id turėtų būti Talkdesk sąveikos ID.
Ribojimai
- Talkdesk nuskaito ne daugiau kaip 256 UUI baitus ir neleidžia reikšmių,
atskirtų
|arba;, todėl siųskite vieną reikšmę. Perdavimo ID telpa. - Talkdesk API negali nuskaityti agento pokalbio transkripcijos. Vietoje to
naudokite perduoto skambučio paiešką arba
GET /v1/calls/{call_id}.