ThunderPhone v3 je dostupan.Postavite sve sami, već od 2 ¢/min.Pročitajte objavu

Contact centers

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 kao external_call_id poziva;
  • User-to-User, heksadekodiran, kao što je business_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, vrijednost Bearer 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 prema external_call_id pomoću ID-ja interakcije.
  • Usmjerite tijek prema handoff.intent i prikažite handoff.summary osobi 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}.