Open in
Yhdistä Talkdeskistä
Ohjaa Talkdesk-puhelut ThunderPhone-agentille Connect to Autopilot Voice -toiminnolla ja eskaloi ne takaisin käyttämällä UUI:ssa olevaa siirtotunnusta.
Talkdesk Studio -työnkulkusi lähettää soittajan agentille interaktiotunnuksen
ja UUI:n kanssa. Kun soittaja tarvitsee ihmistä, agentti eskaloi SIP
REFER -pyynnöllä Talkdeskiin, ja siirtotunnus tallentuu Studio-muuttujaan.
Ennen aloittamista
- ThunderPhone-agentti ja organisaation API-avain.
- Talkdesk Conversation Orchestrator -lisenssi, joka kattaa Studio- komponentin Yhdistä Autopilot Voiceen Ulkoisen äänivirran tilassa (Talkdeskin artikkeli). Talkdesk laskuttaa siitä minuuttiperusteisesti, kun agentti pitää puhelua.
1. Luo SIP-päätepiste
Talkdesk dokumentoi vain IP-sallittujen osoitteiden luettelon, joten luo päätepiste, joka hyväksyy puhelut lähdeosoitteen perusteella:
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"
}'Talkdeskin artikkelin mukaan se lähettää äänen SRTP:n kautta, ja "srtp": "optional"
vastaa SRTP:llä, kun Talkdesk tarjoaa sitä. Artikkelissa ei kerrota, vaatiiko Talkdesk
SRTP:tä; jos Talkdesk kertoo, että se vaatii sitä, aseta srtp arvoksi required, mikä
hylkää puhelut ilman sitä.
Hanki Talkdeskin SIP-signalointialueet Talkdeskiltä. Jokaisen on oltava julkinen IPv4-
alue, jonka koko on /16 tai pienempi (IPv6 /48 tai pienempi). Katso
Alustat, jotka todentavat lähde-IP:n perusteella.
Talkdesk lähettää SIP-liikenteen Twilion verkosta, jonka osoitteet ovat kaikkien Twilio-
asiakkaiden yhteisiä, joten päätepisteen osoite estää muut soittajat: älä
julkaise sitä.
Säilytä vastauksen sip_uri, esimerkiksi
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. Lähetä puhelut kontekstin kanssa
Lisää Studio-työnkulkuusi Yhdistä Autopilot Voiceen Ulkoisen äänivirran
tilassa ja aseta sen kohteeksi päätepisteen sip_uri, johon on lisätty ;transport=tls,
esimerkiksi sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls. Päätepiste
hylkää UDP:n kautta tulevat puhelut, jota Twilion SIP käyttää, ellei toisin määritetä.
Talkdesk lähettää:
X-Talkdesk-Interaction-Id, joka tallennetaan puhelunexternal_call_id-arvoksi;User-to-User, heksakoodattuna, kutenbusiness_hours=open. Se saapuu kehotteeseen purettuna muodossa{{sip_uui}}.
Komponentin versio 2.1 voi lähettää myös Määritetyt otsakkeet. Talkdeskin asetussivulla ne kuvataan WebSocketin kautta lähetettäväksi JSONiksi, joten varmista Talkdeskiltä, että ne saapuvat SIP-otsakkeina ennen kuin luotat niihin.
3. Palauta puhelu
Agentti eskaloi REFER-pyynnöllä Talkdeskin eskalointiosoitteeseen siten, että
siirtotunnus on heksamuotoisena UUI-arvona kyseisessä osoitteessa, joka on ainoa
paikka, josta Talkdesk lukee sen. Lisää tämä siirtonumero (katso
Lisää siirtonumero
ja Otsakkeet siirto-osoitteen sisällä):
{
"name": "Talkdesk escalation",
"number": "sip:escalation@talkdesk.com",
"headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}Osoite on sama kuin Talkdeskin artikkelissa. Komponentin versio 2.1
lukee autopilot_result=-arvon; versio 1.7 lukee escalate_to=-arvon, joten käytä
versiossa 1.7 tätä avainta. REFER näyttää tältä:
Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>
Talkdesk sijoittaa arvon Studio-muuttujaan. Saat yhteenvedon ja tarkoituksen lisäämällä Suorita toiminto -vaiheen Connectionsilla rakennettuun mukautettuun integraatioon:
- Todennustyyppi API-avain, otsakkeen nimi
Authorization, arvoBearer sk_live_…. - Pyyntö:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=ja sen jälkeen muuttujan tunnus. Voit myös hakea puhelunexternal_call_id-arvolla interaktion tunnuksen avulla. - Reititä
handoff.intent-kentän perusteella ja näytähandoff.summarypuhelun vastaanottavalle henkilölle.
Katso Siirretyn puhelun haku.
Testaa
Aloita puhelu Studio-virran kautta, pyydä agentilta henkilöä ja tarkista,
että virta jatkuu komponentin jälkeen ja että siirtotunnus on sen
muuttujassa. Avaa sitten puhelu pyynnöllä GET /v1/calls/{call_id}:
external_call_id-arvon tulee olla Talkdeskin interaktion tunnus.
Rajoitukset
- Talkdesk lukee enintään 256 tavua UUI-dataa eikä salli
|- tai;-merkeillä erotettuja arvoja, joten lähetä yksi arvo. Siirtotunnus mahtuu siihen. - Talkdeskin API:t eivät voi lukea agentin transkriptiota. Käytä sen sijaan
siirtopuhelun hakua tai
GET /v1/calls/{call_id}.