ThunderPhone v3 on julkaistu.Ota käyttöön itse – alkaen 2 ¢/min.Lue lisää julkistuksesta

Contact centers

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 puhelun external_call_id-arvoksi;
  • User-to-User, heksakoodattuna, kuten business_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, arvo Bearer sk_live_….
  • Pyyntö: GET https://api.thunderphone.com/v1/calls/handoff?handoff_id= ja sen jälkeen muuttujan tunnus. Voit myös hakea puhelun external_call_id-arvolla interaktion tunnuksen avulla.
  • Reititä handoff.intent-kentän perusteella ja näytä handoff.summary puhelun 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}.