Open in
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/16alebo užšou (IPv6/48alebo 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ý akoexternal_call_idhovoru. 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.summaryahandoff.intentna 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ť.