ThunderPhone v3 este disponibil.Self-service, de la 2 ¢/min.Citiți anunțul

Contact centers

Conectați din Talkdesk

Trimiteți apelurile Talkdesk către un agent vocal ThunderPhone cu Connect to Autopilot Voice și escaladați-le înapoi folosind ID-ul de transfer în UUI.

Fluxul dvs. Talkdesk Studio trimite apelantul către agent cu ID-ul interacțiunii și UUI. Când apelantul are nevoie de o persoană, agentul escaladează cu un SIP REFER către Talkdesk, iar ID-ul transferului ajunge într-o variabilă Studio.

Înainte de a începe

  • Un agent ThunderPhone și o cheie API a organizației.
  • O licență Talkdesk Orchestrator de conversații, care acoperă componenta Studio Conectare la vocea Autopilot în modul Flux vocal extern (articolul Talkdesk). Talkdesk facturează pe minut cât timp agentul menține apelul.

1. Creați endpointul SIP

Talkdesk documentează doar o listă de permisiuni IP, așadar creați un endpoint care acceptă apeluri după adresa sursă:

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

Articolul Talkdesk precizează că trimite audio prin SRTP, iar "srtp": "optional" răspunde cu SRTP când Talkdesk îl oferă. Articolul nu precizează dacă Talkdesk necesită SRTP; dacă Talkdesk vă spune că îl necesită, setați srtp la required, ceea ce refuză apelurile fără acesta.

Obțineți intervalele de semnalizare SIP ale Talkdesk de la Talkdesk. Fiecare trebuie să fie un interval IPv4 public de /16 sau mai restrâns (IPv6 /48 sau mai restrâns). Consultați Platforme care se autentifică după IP-ul sursă. Talkdesk trimite SIP din rețeaua Twilio, ale cărei adrese sunt partajate de fiecare client Twilio, așadar adresa endpointului este cea care îi ține pe ceilalți apelanți în afară: nu o publicați. Păstrați sip_uri din răspuns, de exemplu sip:agent-12-jhxmginwjx@sip.thunderphone.com.

2. Trimiteți apeluri cu context

În fluxul dvs. Studio, adăugați Conectare la vocea Autopilot în modul Flux vocal extern și setați-i ținta la sip_uri al endpointului cu ;transport=tls adăugat, de exemplu sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls. Endpointul refuză apelurile prin UDP, pe care SIP-ul Twilio îl utilizează dacă nu este instruit altfel.

Talkdesk trimite:

  • X-Talkdesk-Interaction-Id, stocat ca external_call_id al apelului;
  • User-to-User, codificat hexazecimal, cum ar fi business_hours=open. Ajunge în prompt decodificat, ca {{sip_uui}}.

Versiunea 2.1 a componentei poate trimite și Antete definite. Pagina de preferințe Talkdesk le descrie ca JSON trimis printr-un WebSocket, așadar confirmați cu Talkdesk dacă ajung ca antete SIP înainte de a vă baza pe ele.

3. Preluați apelul înapoi

Agentul vocal escaladează cu un REFER către adresa de escaladare Talkdesk, cu ID-ul de predare ca UUI hexazecimal în acea adresă, singurul loc din care Talkdesk îl citește. Adăugați acest număr de transfer (consultați Adăugați numărul de transfer și Antete în interiorul adresei de transfer):

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

Adresa este cea din articolul Talkdesk. Versiunea 2.1 a componentei citește autopilot_result=; versiunea 1.7 citește escalate_to=, deci utilizați acea cheie în 1.7. REFER arată astfel:

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

Talkdesk introduce valoarea într-o variabilă Studio. Pentru a obține rezumatul și intenția, adăugați un pas Executați acțiunea într-o integrare personalizată creată cu Connections:

  • Tip de autentificare Cheie API, nume antet Authorization, valoare Bearer sk_live_….
  • Cerere: GET https://api.thunderphone.com/v1/calls/handoff?handoff_id= urmat de ID-ul din variabilă. De asemenea, puteți căuta apelul după external_call_id folosind ID-ul interacțiunii.
  • Direcționați în funcție de handoff.intent și afișați handoff.summary persoanei care preia apelul.

Consultați Căutați un apel predat.

Testați

Inițiați un apel prin fluxul Studio, solicitați agentului vocal să vă transfere la o persoană și verificați că fluxul continuă după componentă cu ID-ul de predare în variabila sa. Apoi deschideți apelul cu GET /v1/calls/{call_id}: external_call_id trebuie să fie ID-ul interacțiunii Talkdesk.

Limite

  • Talkdesk citește cel mult 256 de octeți de UUI și nu permite valori separate prin | sau ;, deci trimiteți o singură valoare. ID-ul de predare se încadrează.
  • API-urile Talkdesk nu pot citi transcrierea agentului vocal. Utilizați în schimb căutarea apelului predat sau GET /v1/calls/{call_id}.