ThunderPhone v3 je zdaj na voljo.Začnite sami, že od 2 ¢/min.Preberite obvestilo

Contact centers

Povežite se iz Talkdesk

Klice Talkdesk usmerite do agenta ThunderPhone s funkcijo Connect to Autopilot Voice in jih z ID-jem predaje v UUI eskalirajte nazaj.

Vaš tok Talkdesk Studio pošlje klicatelja agentu z ID-jem interakcije in UUI. Ko klicatelj potrebuje osebo, agent eskalira s SIP REFER v Talkdesk, ID predaje pa se shrani v spremenljivko Studio.

Preden začnete

  • Agent ThunderPhone in organizacijski ključ API.
  • Licenca Talkdesk Conversation Orchestrator, ki vključuje komponento Studio Poveži z Autopilot Voice v načinu Zunanji glasovni tok (članek Talkdesk). Talkdesk jo zaračunava na minuto, medtem ko agent zadrži klic.

1. Ustvarite končno točko SIP

Talkdesk dokumentira le seznam dovoljenih naslovov IP, zato ustvarite končno točko, ki sprejema klice glede na izvorni naslov:

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"
  }'

Članek Talkdesk navaja, da zvok pošilja prek SRTP, in "srtp": "optional" odgovori s SRTP, ko ga Talkdesk ponudi. Članek ne navaja, ali Talkdesk zahteva SRTP; če vam Talkdesk pove, da ga zahteva, nastavite srtp na required, kar zavrne klice brez njega.

Obsege SIP-signalizacije Talkdesk pridobite pri Talkdesk. Vsak mora biti javni obseg IPv4 /16 ali ožji (IPv6 /48 ali ožji). Oglejte si platforme, ki preverjajo pristnost z izvornim IP-jem. Talkdesk pošilja SIP iz omrežja Twilio, katerega naslove uporabljajo vse stranke Twilio, zato naslov končne točke preprečuje dostop drugim klicateljem: ne objavite ga. Shranite sip_uri iz odgovora, na primer sip:agent-12-jhxmginwjx@sip.thunderphone.com.

2. Pošljite klice s kontekstom

V toku Studio dodajte Poveži z Autopilot Voice v načinu Zunanji glasovni tok in nastavite njegov cilj na sip_uri končne točke z dodanim ;transport=tls, na primer sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls. Končna točka zavrne klice prek UDP, ki ga SIP Twilio uporablja, če ni določeno drugače.

Talkdesk pošlje:

  • X-Talkdesk-Interaction-Id, shranjen kot external_call_id klica;
  • User-to-User, šestnajstiško kodiran, na primer business_hours=open. Do poziva prispe dekodiran kot {{sip_uui}}.

Različica 2.1 komponente lahko pošlje tudi Določene glave. Stran z nastavitvami Talkdesk jih opisuje kot JSON, poslan prek WebSocket, zato pri Talkdesk potrdite, ali prispejo kot glave SIP, preden se nanje zanesete.

3. Prejmite klic nazaj

Agent eskalira z REFER na Talkdeskov naslov za eskalacijo, pri čemer je ID predaje kot šestnajstiški UUI v tem naslovu, saj je to edino mesto, kjer ga Talkdesk prebere. Dodajte to številko za preusmeritev (glejte Dodajte številko za preusmeritev in Glave v naslovu za preusmeritev):

{
  "name": "Talkdesk escalation",
  "number": "sip:escalation@talkdesk.com",
  "headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}

Naslov je naveden v Talkdeskovem članku. Različica komponente 2.1 prebere autopilot_result=; različica 1.7 prebere escalate_to=, zato pri različici 1.7 uporabite ta ključ. REFER je videti tako:

Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>

Talkdesk vrednost shrani v spremenljivko Studio. Če želite pridobiti povzetek in namen, dodajte korak Izvedite dejanje v integracijo po meri, izdelano s Connections:

  • Vrsta preverjanja pristnosti ključ API, ime glave Authorization, vrednost Bearer sk_live_….
  • Zahteva: GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=, ki ji sledi ID iz spremenljivke. Klic lahko poiščete tudi po external_call_id z ID-jem interakcije.
  • Usmerite glede na handoff.intent in osebi, ki prevzame klic, prikažite handoff.summary.

Glejte Poiščite predani klic.

Preizkusite

Začnite klic prek toka Studio, agenta prosite, naj vas poveže z osebo, in preverite, da se tok nadaljuje mimo komponente z ID-jem predaje v njeni spremenljivki. Nato odprite klic z GET /v1/calls/{call_id}: external_call_id mora biti ID interakcije Talkdesk.

Omejitve

  • Talkdesk prebere največ 256 bajtov UUI-ja in ne dovoljuje vrednosti, ločenih z | ali ;, zato pošljite eno vrednost. ID predaje ustreza.
  • API-ji Talkdesk ne morejo prebrati prepisa agenta. Namesto tega uporabite iskanje predanega klica ali GET /v1/calls/{call_id}.