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

Contact centers

Conectați din Zoom Contact Center

Trimiteți apelurile Zoom Contact Center către un agent ThunderPhone cu un conector de voicebot terț și redirecționați-le înapoi către un agent uman cu un SIP REFER.

Un widget Bot din fluxul Zoom Contact Center trimite apelantul către agent cu ID-ul apelului Zoom. Când apelantul are nevoie de o persoană, agentul trimite un SIP REFER către adresa agentului uman din Zoom, iar fluxul dumneavoastră preia transferul după ID-ul apelului.

Înainte de a începe

  • Un agent ThunderPhone și o cheie API a organizației.
  • O aplicație generală Zoom Marketplace, gestionată de administratorul dumneavoastră și pusă la dispoziția Contact Center, cu un conector pentru widgetul Bot (ghidul Zoom pentru roboți vocali terți).
  • Un trunk SIP de la Zoom către furnizorul robotului. Echipa ISV Zoom îl construiește în etape (analiză, un trunk de test, apoi producție), iar câmpul Numele companiei al aplicației trebuie să corespundă exact înregistrării trunkului. Această configurare începe cu asistența ThunderPhone și Zoom, nu doar în contul dumneavoastră Zoom.

1. Creați endpointul SIP

Conectorul Zoom apelează un număr de 15 cifre care începe cu 999, nu o adresă SIP. Salvarea conectorului generează acel număr. Trunkul Zoom folosește TLS 1.2 pe portul 5061 cu SRTP pentru audio și este permis prin lista de adrese Zoom, nu printr-o parolă. Prin urmare, creați un endpoint ip_allowlist cu numărul conectorului ca număr de apelare și cu SRTP obligatoriu (consultați Platforme care apelează un număr de telefon):

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": "Zoom Contact Center",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["ZOOM_SIGNALLING_RANGE_1", "ZOOM_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["999123456789012"],
    "srtp": "required"
  }'
  • allowed_source_cidrs: subrețelele de semnalizare SIP Zoom, furnizate de Zoom. Fiecare trebuie să fie un interval IPv4 public de /16 sau mai restrâns (IPv6 /48 sau mai restrâns).
  • dial_in_numbers: numărul conectorului exact așa cum îl trimite Zoom, fără +.
  • srtp: required, deoarece trunkul Zoom folosește întotdeauna SRTP.

Adresele Zoom sunt partajate de toți clienții săi, astfel încât orice alt client Zoom care apelează numărul ajunge la agentul dumneavoastră. Zoom atribuie numărul; nu îl publicați.

2. Trimiteți apeluri cu context

Adăugați un widget Bot în fluxul dumneavoastră și asociați-l cu conectorul. Cereți echipei ISV Zoom să direcționeze trunkul către sip.thunderphone.com, prin TLS pe portul 5061, cu numărul conectorului atât în URI-ul cererii, cât și în antetul To. Endpointul respinge UDP, așa că asigurați-vă că trunkul nu revine la acesta.

Zoom trimite:

  • X-ZOOM-Call-Sid, stocat ca external_call_id al apelului. Pagina proprie Zoom de mapare a datelor nu îl enumeră; integrarea Zoom a unui alt furnizor AI îl documentează, așa că verificați-l la primul apel de test.
  • X-ZOOM-DNIS, numărul apelat de apelant, ca {{sip_x_zoom_dnis}}.
  • X-ZOOM-WEBHOOK, URL-ul static al conectorului.

3. Primiți apelul înapoi

Agentul vocal trimite un REFER către adresa agentului uman de pe SBC-ul Zoom. Adăugați acest număr de transfer (consultați Adăugați numărul de transfer), cu adresa SBC furnizată de Zoom:

{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}

Ghidul Zoom descrie două modalități prin care un bot transmite contextul: un POST către URL-ul static al conectorului înainte de REFER (evenimentele voicebot_metadata și similare) și antete SIP mapate în Intrare de la Bot. ThunderPhone nu trimite un POST către URL-ul static. Ghidul Zoom nu precizează dacă citește antetele mapate dintr-un REFER; dacă doriți să încercați, adăugați headers, cum ar fi "X-Handoff-Id": "{{handoff_id}}", la intrare și verificați printr-un apel de test. De asemenea, confirmați cu Zoom că acceptă un REFER fără un POST cu metadate înaintea acestuia.

Pentru a obține transferul fără a vă baza pe niciuna dintre acestea, configurați fluxul să îl caute după widgetul Bot, cu un widget Apel HTTP sau Script:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= urmat de SID-ul apelului.
  • Antetul Authorization: Bearer sk_live_….
  • Utilizați handoff.summary și handoff.intent pentru a direcționa apelantul și a informa persoana care preia apelul.

Zoom nu publică documentație la nivel de câmp pentru aceste widgeturi, așadar confirmați în contul dumneavoastră că widgetul poate trimite un antet Authorization. Consultați Consultați un apel transferat.

Testați

Apelați un număr care ajunge la widgetul Bot, cereți agentului vocal să vorbească cu o persoană și verificați că apelantul ajunge la un agent uman și că widgetul returnează transferul. Apoi deschideți apelul cu GET /v1/calls/{call_id}: sip_headers ar trebui să includă x-zoom-call-sid, iar external_call_id ar trebui să corespundă SID-ului apelului pe care îl utilizează fluxul dumneavoastră.

Limitări

  • ThunderPhone nu trimite un POST către URL-ul static al conectorului, astfel încât Zoom primește transferul prin căutare sau prin antete mapate dacă testul dumneavoastră arată că Zoom le citește din REFER.
  • Trunchiul este construit de echipa ISV a Zoom, așadar nu îl puteți configura sau testa pe cont propriu.