Open in
Povežite se iz Zoom Contact Center
Klice iz Zoom Contact Center usmerite k agentu ThunderPhone s priključkom za glasovnega robota drugega ponudnika, nato pa jih s SIP REFER vrnite človeškemu agentu.
Gradnik Bot v vašem toku Zoom Contact Center klicatelja z
Zoomovim ID-jem klica pošlje agentu. Ko klicatelj potrebuje osebo, agent v
Zoomov naslov človeškega agenta pošlje SIP REFER, vaš tok pa po ID-ju klica pridobi predajo.
Preden začnete
- Agent ThunderPhone in ključ API organizacije.
- Splošna aplikacija Zoom Marketplace, ki jo upravlja vaš skrbnik in je na voljo za Contact Center, s povezovalnikom za gradnik Bot (Zoomov vodnik za glasovne bote tretjih ponudnikov).
- SIP-trunk iz Zooma do ponudnika bota. Zoomova ekipa ISV ga vzpostavi v fazah (odkrivanje, trunk za preizkusno okolje, nato produkcija), ime podjetja aplikacije pa se mora natančno ujemati z zapisom trunka. Ta nastavitev se začne s podporo ThunderPhone in Zoomom, ne samo v vašem računu Zoom.
1. Ustvarite končno točko SIP
Zoomov povezovalnik kliče 15-mestno številko, ki se začne z 999, ne naslova SIP.
S shranitvijo povezovalnika se ustvari ta številka. Zoomov trunk uporablja TLS 1.2
na vratih 5061 s SRTP za zvok in je uvrščen na seznam dovoljenih po Zoomovih podomrežjih
namesto z geslom. Zato ustvarite končno točko ip_allowlist s številko
povezovalnika kot številko za dohodne klice in zahtevanim SRTP (glejte
Platforme, ki kličejo telefonsko številko):
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: Zoomova podomrežja za signalizacijo SIP, ki jih zagotovi Zoom. Vsako mora biti javni obseg IPv4/16ali ožji (IPv6/48ali ožji).dial_in_numbers: številka povezovalnika točno tako, kot jo pošlje Zoom, brez+.srtp:required, ker Zoomov trunk vedno uporablja SRTP.
Zoomove naslove si delijo vse njegove stranke, zato vsak drug uporabnik Zooma, ki pokliče številko, doseže vašega agenta. Številko dodeli Zoom; ne objavljajte je.
2. Pošljite klice s kontekstom
V svoj tok dodajte gradnik Bot in ga povežite s povezovalnikom. Zoomovo ekipo ISV
prosite, naj trunk usmeri na sip.thunderphone.com, TLS na vratih 5061, s
številko povezovalnika v URI-ju zahteve in glavi To. Končna točka
zavrne UDP, zato poskrbite, da trunk ne preklopi nanj.
Zoom pošlje:
X-ZOOM-Call-Sid, shranjen kotexternal_call_idklica. Zoomova lastna stran za preslikavo podatkov ga ne navaja; dokumentacija integracije Zoom drugega ponudnika umetne inteligence ga opisuje, zato ga preverite pri prvem preizkusnem klicu.X-ZOOM-DNIS, številko, ki jo je klicatelj poklical, kot{{sip_x_zoom_dnis}}.X-ZOOM-WEBHOOK, statični URL povezovalnika.
3. Prejmite klic nazaj
Agent pošlje REFER na naslov človeškega agenta v Zoomovem SBC-ju. Dodajte to
številko za preusmeritev (glejte
Dodajte številko za preusmeritev)
z naslovom SBC-ja, ki vam ga posreduje Zoom:
{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}Zoomov vodnik opisuje dva načina, kako bot posreduje kontekst: zahtevo POST na
statični URL povezovalnika pred REFER (dogodki voicebot_metadata in podobni)
ter glave SIP, preslikane pod Dohodno od bota. ThunderPhone ne pošilja
zahtev na statični URL. Zoomov vodnik ne navaja, ali bere preslikane glave iz
REFER; če želite to preizkusiti, v vnos dodajte headers, kot je
"X-Handoff-Id": "{{handoff_id}}", in preverite s testnim klicem. Pri Zoomu
tudi potrdite, da sprejme REFER brez predhodne zahteve POST z metapodatki.
Če želite pridobiti predajo, ne da bi se zanašali na katero koli od teh možnosti, jo po pripomočku Bot poiščite v svojem toku s pripomočkom Klic HTTP ali Skript:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=ki mu sledi SID klica.- Glava
Authorization: Bearer sk_live_…. - Za usmerjanje klicatelja in seznanitev osebe, ki prevzame klic, uporabite
handoff.summaryinhandoff.intent.
Zoom ne objavlja dokumentacije za posamezna polja teh pripomočkov, zato v svojem
računu preverite, ali lahko pripomoček pošlje glavo Authorization. Glejte
Iskanje predanega klica.
Preizkusite
Pokličite številko, ki doseže pripomoček Bot, glasovnega agenta prosite za
človeškega agenta in preverite, da klicatelj doseže človeškega agenta ter da
pripomoček vrne podatke o predaji. Nato odprite klic z
GET /v1/calls/{call_id}: sip_headers mora vsebovati x-zoom-call-sid, vrednost
external_call_id pa se mora ujemati s SID-jem klica, ki ga uporablja vaš tok.
Omejitve
- ThunderPhone ne pošilja zahtev na statični URL povezovalnika, zato Zoom
prejme predajo prek iskanja ali prek preslikanih glav, če vaš preizkus pokaže,
da jih Zoom bere iz
REFER. - Trunk izdela Zoomova ekipa ISV, zato ga ne morete nastaviti ali preizkusiti sami.