ThunderPhone v3 je tu.Začnite sami, už od 2 ¢/min.Prečítať oznámenie

Contact centers

Pripojenie zo služby Zoom Contact Center

Presmerujte hovory zo služby Zoom Contact Center na agenta ThunderPhone pomocou konektora hlasového bota tretej strany a vráťte ich späť ľudskému agentovi pomocou SIP REFER.

Widget Bot vo vašom toku Zoom Contact Center odošle volajúceho agentovi s identifikátorom hovoru Zoom. Keď volajúci potrebuje človeka, agent odošle SIP REFER na adresu ľudského agenta Zoom a váš tok načíta presmerovanie podľa identifikátora hovoru.

Pred začatím

  • Agent ThunderPhone a organizačný kľúč API.
  • Všeobecná aplikácia Zoom Marketplace spravovaná vaším administrátorom a sprístupnená pre Contact Center s konektorom pre widget Bot (príručka Zoom pre hlasové boty tretích strán).
  • SIP trunk zo Zoom k poskytovateľovi bota. Tím ISV Zoom ho vytvára postupne (zistenie požiadaviek, testovací trunk, potom produkcia) a názov spoločnosti aplikácie musí presne zodpovedať záznamu trunku. Toto nastavenie začína s podporou ThunderPhone a Zoom, nie iba vo vašom účte Zoom.

1. Vytvorte koncový bod SIP

Konektor Zoom vytáča 15-miestne číslo začínajúce na 999, nie SIP adresu. Uložením konektora sa toto číslo vygeneruje. Trunk Zoom používa TLS 1.2 na porte 5061 so SRTP pre zvuk a je povolený podľa podsietí Zoom namiesto hesla. Preto vytvorte koncový bod ip_allowlist s číslom konektora ako číslom na vytáčanie a s vyžadovaným SRTP (pozrite si Platformy, ktoré vytáčajú telefónne číslo):

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: podsiete SIP signalizácie Zoom získané od Zoom. Každá musí byť verejný rozsah IPv4 s maskou /16 alebo užšou (IPv6 /48 alebo užšou).
  • dial_in_numbers: číslo konektora presne v podobe, v akej ho odosiela Zoom, bez +.
  • srtp: required, pretože trunk Zoom vždy používa SRTP.

Adresy Zoom sú zdieľané všetkými jeho zákazníkmi, takže akýkoľvek iný zákazník Zoom, ktorý vytočí toto číslo, sa spojí s vaším agentom. Číslo prideľuje Zoom; nezverejňujte ho.

2. Odosielajte hovory s kontextom

Pridajte do svojho toku widget Bot a priraďte ho ku konektoru. Požiadajte tím ISV Zoom, aby trunk nasmeroval na sip.thunderphone.com, s TLS na porte 5061 a s číslom konektora v identifikátore URI požiadavky aj v hlavičke To. Koncový bod odmieta UDP, preto sa uistite, že sa naň trunk neprepne späť.

Zoom odosiela:

  • X-ZOOM-Call-Sid, uložený ako external_call_id hovoru. Vlastná stránka Zoom na mapovanie údajov ho neuvádza; dokumentácia integrácie Zoom iného poskytovateľa AI ho uvádza, preto ho skontrolujte pri prvom testovacom hovore.
  • X-ZOOM-DNIS, číslo vytočené volajúcim, ako {{sip_x_zoom_dnis}}.
  • X-ZOOM-WEBHOOK, statickú URL konektora.

3. Získanie hovoru späť

Hlasový agent odošle REFER na adresu pracovníka v SBC Zoomu. Pridajte toto číslo na presmerovanie (pozrite si Pridanie čísla na presmerovanie) s adresou SBC, ktorú vám poskytne Zoom:

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

Príručka Zoomu opisuje dva spôsoby, ako bot odovzdáva kontext: požiadavku POST na statickú adresu URL konektora pred REFER (udalosti voicebot_metadata a podobné) a hlavičky SIP namapované v časti Prichádzajúce od bota. ThunderPhone neodosiela požiadavky na statickú adresu URL. Príručka Zoomu neuvádza, či číta namapované hlavičky z REFER; ak to chcete vyskúšať, pridajte do záznamu headers, napríklad "X-Handoff-Id": "{{handoff_id}}", a overte to pri testovacom hovore. Tiež si u Zoomu potvrďte, že prijíma REFER bez predchádzajúcej požiadavky POST s metadátami.

Ak chcete získať odovzdanie bez spoliehania sa na ktorýkoľvek z týchto spôsobov, nechajte svoj tok vyhľadať údaje po miniaplikácii Bot pomocou miniaplikácie Volanie HTTP alebo Skript:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= nasledované sid hovoru.
  • Hlavička Authorization: Bearer sk_live_….
  • Použite handoff.summary a handoff.intent na smerovanie volajúceho a stručné oboznámenie osoby, ktorá hovor prevezme.

Zoom nezverejňuje dokumentáciu na úrovni polí pre tieto miniaplikácie, preto si vo svojom účte overte, že miniaplikácia môže odosielať hlavičku Authorization. Pozrite si Vyhľadanie odovzdaného hovoru.

Otestujte ho

Zavolajte na číslo, ktoré vedie do miniaplikácie Bot, požiadajte hlasového agenta o spojenie s pracovníkom a overte, že sa volajúci dovolá pracovníkovi kontaktného centra a miniaplikácia vráti údaje o odovzdaní. Potom otvorte hovor pomocou GET /v1/calls/{call_id}: sip_headers by mali obsahovať x-zoom-call-sid a external_call_id by sa malo zhodovať so sid hovoru, ktoré používa váš tok.

Obmedzenia

  • ThunderPhone neodosiela požiadavky na statickú adresu URL konektora, preto Zoom získa údaje o odovzdaní prostredníctvom vyhľadania alebo cez namapované hlavičky, ak váš test ukáže, že ich Zoom číta z REFER.
  • Trunk vytvára tím ISV Zoomu, takže ho nemôžete sami nastaviť ani otestovať.