Open in
Povezivanje iz Zoom Contact Centera
Usmjerite pozive iz Zoom Contact Centera glasovnom agentu ThunderPhone putem poveznikâ glasovnih botova trećih strana i vratite ih ljudskom agentu pomoću SIP REFER-a.
Widget Bot u Vašem Zoom Contact Center tijeku usmjerava pozivatelja agentu sa
Zoomovim SID-om poziva. Kada pozivatelj treba osobu, agent šalje SIP REFER
na Zoomovu adresu ljudskog agenta, a Vaš tijek dohvaća preusmjeravanje prema SID-u poziva.
Prije početka
- ThunderPhone agent i organizacijski API ključ.
- Zoom Marketplace Opća aplikacija, kojom upravlja Vaš administrator i koja je dostupna za Contact Center, s konektorom za widget Bot (Zoomov vodič za glasovne botove trećih strana).
- SIP trunk od Zooma do pružatelja bota. Zoomov ISV tim izrađuje ga u fazama (inicijalna analiza, testni trunk, zatim produkcija), a polje Naziv tvrtke aplikacije mora se točno podudarati sa zapisom trunka. Ovo postavljanje započinje uz podršku ThunderPhonea i Zooma, a ne samo na Vašem Zoom računu.
1. Izradite SIP krajnju točku
Zoomov konektor bira 15-znamenkasti broj koji počinje s 999, a ne SIP
adresu. Spremanje konektora generira taj broj. Zoomov trunk koristi TLS 1.2
na priključku 5061 sa SRTP-om za zvuk te je na popisu dopuštenih prema Zoomovim podmrežama, a ne lozinkom. Stoga izradite krajnju točku ip_allowlist s brojem konektora kao brojem za pozivanje i obaveznim SRTP-om (pogledajte
Platforme koje biraju telefonski broj):
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: Zoomove SIP signalizacijske podmreže, koje dobivate od Zooma. Svaka mora biti javni IPv4 raspon/16ili uži (IPv6/48ili uži).dial_in_numbers: broj konektora točno onako kako ga Zoom šalje, bez znaka+.srtp:required, jer Zoomov trunk uvijek koristi SRTP.
Zoomove adrese dijele svi njegovi korisnici, pa svaki drugi Zoomov korisnik koji bira taj broj dolazi do Vašeg agenta. Zoom dodjeljuje broj; nemojte ga objavljivati.
2. Šaljite pozive s kontekstom
Dodajte widget Bot u svoj tijek i povežite ga s konektorom. Zatražite od Zoomova ISV
tima da trunk usmjeri na sip.thunderphone.com, uz TLS na priključku 5061, s brojem
konektora u URI-ju zahtjeva i zaglavlju To. Krajnja točka
odbija UDP, stoga provjerite da trunk ne prijeđe na njega.
Zoom šalje:
X-ZOOM-Call-Sid, pohranjen kaoexternal_call_idpoziva. Zoomova vlastita stranica za mapiranje podataka ne navodi ga; dokumentira ga Zoomova integracija drugog pružatelja AI-ja, stoga ga provjerite pri prvom testnom pozivu.X-ZOOM-DNIS, broj koji je pozivatelj birao, kao{{sip_x_zoom_dnis}}.X-ZOOM-WEBHOOK, statični URL konektora.
3. Preuzmite poziv natrag
Agent šalje REFER na adresu ljudskog agenta na Zoomovu SBC-u. Dodajte ovaj
broj za preusmjeravanje (pogledajte
Dodajte broj za preusmjeravanje),
s adresom SBC-a koju vam Zoom navede:
{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}Zoomov vodič opisuje dva načina na koja bot prenosi kontekst: POST na
statički URL konektora prije REFER zahtjeva (voicebot_metadata i slični
događaji) te SIP zaglavlja mapirana u odjeljku Dolazno od bota. ThunderPhone
ne šalje podatke na statički URL. Zoomov vodič ne navodi čita li mapirana
zaglavlja iz REFER zahtjeva; ako želite pokušati, dodajte headers poput
"X-Handoff-Id": "{{handoff_id}}" u unos i provjerite to testnim pozivom. Također
potvrdite sa Zoomom da prihvaća REFER bez POST zahtjeva s metapodacima prije
njega.
Da biste dobili predaju bez oslanjanja na bilo koji od tih načina, postavite da je vaš tok dohvaća nakon widgeta Bot pomoću widgeta HTTP poziv ili Skripta:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=nakon kojeg slijedi SID poziva.- Zaglavlje
Authorization: Bearer sk_live_…. - Upotrijebite
handoff.summaryihandoff.intentza usmjeravanje pozivatelja i informiranje osobe koja preuzima poziv.
Zoom ne objavljuje dokumentaciju na razini polja za ove widgete, stoga u svom
računu potvrdite da widget može poslati zaglavlje Authorization. Pogledajte
Dohvat predanog poziva.
Testirajte
Nazovite broj koji vodi do widgeta Bot, zatražite od agenta razgovor s osobom i
provjerite dolazi li pozivatelj do ljudskog agenta te vraća li widget predaju.
Zatim otvorite poziv pomoću GET /v1/calls/{call_id}: sip_headers bi trebao
navesti x-zoom-call-sid, a external_call_id trebao bi odgovarati SID-u
poziva koji vaš tok upotrebljava.
Ograničenja
- ThunderPhone ne šalje podatke na statički URL konektora, pa Zoom predaju dobiva
putem dohvata ili putem mapiranih zaglavlja ako vaš test pokaže da ih Zoom čita
iz
REFERzahtjeva. - Trunk izrađuje Zoomov ISV tim, stoga ga ne možete samostalno postaviti ni testirati.