Open in
Povezivanje iz Talkdeska
Usmjerite Talkdesk pozive glasovnom agentu ThunderPhonea putem opcije Poveži s Autopilot Voiceom, a zatim ih eskalirajte natrag s ID-om prijenosa u UUI-ju.
Vaš Talkdesk Studio tijek šalje pozivatelja glasovnom agentu s ID-jem
interakcije i UUI-jem. Kada pozivatelj treba osobu, glasovni agent eskalira s SIP
REFER porukom prema Talkdesku, a ID predaje završava u varijabli Studija.
Prije početka
- Glasovni agent ThunderPhone i organizacijski API ključ.
- Licenca Talkdesk Orkestrator razgovora, koja obuhvaća komponentu Studija Povezivanje s Autopilot Voiceom u načinu rada Vanjski glasovni tok (članak Talkdeska). Talkdesk je naplaćuje po minuti dok glasovni agent drži poziv.
1. Izradite SIP krajnju točku
Talkdesk dokumentira samo popis dopuštenih IP adresa, stoga izradite krajnju točku koja prihvaća pozive prema izvornoj adresi:
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"
}'U članku Talkdeska navodi se da zvuk šalje putem SRTP-a, a "srtp": "optional"
odgovara SRTP-om kada ga Talkdesk ponudi. U članku se ne navodi zahtijeva li Talkdesk
SRTP; ako Vam Talkdesk kaže da ga zahtijeva, postavite srtp na required, što
odbija pozive bez njega.
Dohvatite SIP signalizacijske raspone Talkdeska od Talkdeska. Svaki mora biti javni raspon
IPv4 adresa od /16 ili uži (IPv6 /48 ili uži). Pogledajte
Platforme koje se autentificiraju prema izvornoj IP adresi.
Talkdesk šalje SIP iz Twilio mreže, čije adrese dijele svi korisnici Twilija,
stoga je adresa krajnje točke ono što sprječava druge pozivatelje: nemojte je
objaviti.
Sačuvajte sip_uri iz odgovora, na primjer
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. Šaljite pozive s kontekstom
U svom Studio tijeku dodajte Povezivanje s Autopilot Voiceom u načinu rada Vanjski glasovni
tok i postavite njegovo odredište na sip_uri krajnje točke s dodanim ;transport=tls, na
primjer sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls. Krajnja
točka odbija pozive putem UDP-a, koji Twiliojev SIP koristi ako nije drukčije navedeno.
Talkdesk šalje:
X-Talkdesk-Interaction-Id, pohranjen kaoexternal_call_idpoziva;User-to-User, heksadekodiran, kao što jebusiness_hours=open. Do prompta stiže dekodiran, kao{{sip_uui}}.
Verzija 2.1 komponente može slati i Definirana zaglavlja. Stranica s postavkama Talkdeska opisuje ih kao JSON poslan putem WebSocketa, stoga potvrdite s Talkdeskom stižu li kao SIP zaglavlja prije nego što se na njih oslonite.
3. Preuzmite poziv natrag
Agent prosljeđuje eskalaciju pomoću REFER zahtjeva na Talkdeskovu adresu za
eskalaciju, s ID-jem preusmjeravanja kao heksadekadskim UUI-jem unutar te
adrese, jedinog mjesta na kojem ga Talkdesk čita. Dodajte ovaj broj za prijenos
(pogledajte
Dodajte broj za prijenos
i Zaglavlja unutar adrese za prijenos):
{
"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 ona iz Talkdeskova članka. Verzija 2.1 komponente
čita autopilot_result=; verzija 1.7 čita escalate_to=, stoga na verziji 1.7
upotrijebite taj ključ. REFER izgleda ovako:
Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>
Talkdesk stavlja vrijednost u varijablu Studio. Da biste dohvatili sažetak i namjeru, dodajte korak Izvrši radnju u prilagođenu integraciju izrađenu pomoću Connections:
- Vrsta autentikacije API ključ, naziv zaglavlja
Authorization, vrijednostBearer sk_live_…. - Zahtjev:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=nakon kojeg slijedi ID iz varijable. Poziv možete potražiti i premaexternal_call_idpomoću ID-ja interakcije. - Usmjerite tijek prema
handoff.intenti prikažitehandoff.summaryosobi koja preuzima poziv.
Pogledajte Potražite preusmjereni poziv.
Testirajte
Pokrenite poziv putem tijeka Studio, zatražite od agenta razgovor s osobom i provjerite
nastavlja li se tijek nakon komponente s ID-jem preusmjeravanja u svojoj
varijabli. Zatim otvorite poziv pomoću GET /v1/calls/{call_id}:
external_call_id trebao bi biti ID Talkdesk interakcije.
Ograničenja
- Talkdesk čita najviše 256 bajtova UUI-ja i ne dopušta vrijednosti odvojene
znakovima
|ili;, stoga pošaljite jednu vrijednost. ID preusmjeravanja stane. - Talkdeskovi API-ji ne mogu pročitati transkript agenta. Umjesto toga upotrijebite
pretraživanje preusmjerenog poziva ili
GET /v1/calls/{call_id}.