Open in
Savienošana no Zoom Contact Center
Nosūtiet Zoom Contact Center zvanus uz ThunderPhone balss aģentu, izmantojot trešās puses balss robota savienotāju, un ar SIP REFER pārsūtiet tos atpakaļ cilvēka aģentam.
Bot logrīks jūsu Zoom Contact Center plūsmā nosūta zvanītāju uz balss aģentu ar
Zoom zvana SID. Kad zvanītājam nepieciešams cilvēks, balss aģents nosūta SIP REFER
uz Zoom cilvēka aģenta adresi, un jūsu plūsma izgūst pāradresēšanu pēc zvana SID.
Pirms darba sākšanas
- ThunderPhone aģents un organizācijas API atslēga.
- Zoom Marketplace Vispārīgā lietotne, ko pārvalda jūsu administrators un kas ir pieejama Contact Center, ar Bot logrīka savienotāju (Zoom trešās puses balss bota ceļvedis).
- SIP maģistrāle no Zoom uz bota pakalpojumu sniedzēju. Zoom ISV komanda to izveido posmos (izpēte, testēšanas maģistrāle un pēc tam ražošana), un lietotnes uzņēmuma nosaukumam ir precīzi jāsakrīt ar maģistrāles ierakstu. Šo iestatīšanu sāciet kopā ar ThunderPhone atbalsta komandu un Zoom, nevis tikai savā Zoom kontā.
1. Izveidojiet SIP galapunktu
Zoom savienotājs zvana uz 15 ciparu numuru, kas sākas ar 999, nevis uz SIP
adresi. Saglabājot savienotāju, tiek ģenerēts šis numurs. Zoom maģistrāle izmanto TLS 1.2
portā 5061 ar SRTP audio datiem, un Zoom apakštīkliem tiek piešķirta atļauja, nevis izmantota parole. Tāpēc izveidojiet ip_allowlist galapunktu ar savienotāja
numuru kā iezvanes numuru un obligātu SRTP (skatiet
Platformas, kas zvana uz tālruņa numuru):
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: Zoom SIP signalizācijas apakštīkli, ko nodrošina Zoom. Katram jābūt publiskam IPv4 diapazonam/16vai šaurākam (IPv6/48vai šaurākam).dial_in_numbers: savienotāja numurs tieši tādā formā, kādā Zoom to nosūta, bez+.srtp:required, jo Zoom maģistrāle vienmēr izmanto SRTP.
Zoom adreses ir kopīgas visiem tā klientiem, tāpēc jebkurš cits Zoom klients, kurš zvana uz šo numuru, sasniedz jūsu balss aģentu. Zoom piešķir numuru; nepublicējiet to.
2. Nosūtiet zvanus ar kontekstu
Pievienojiet savai plūsmai Bot logrīku un piesaistiet to savienotājam. Lūdziet Zoom ISV
komandai norādīt maģistrāli uz sip.thunderphone.com, izmantojot TLS portā 5061, ar
savienotāja numuru gan pieprasījuma URI, gan To galvenē. Galapunkts
noraida UDP, tāpēc pārliecinieties, ka maģistrāle uz to nepārslēdzas.
Zoom nosūta:
X-ZOOM-Call-Sid, kas tiek saglabāts kā zvanaexternal_call_id. Zoom datu kartēšanas lapā tas nav norādīts; to dokumentē cita AI pakalpojumu sniedzēja Zoom integrācija, tāpēc pārbaudiet to pirmajā testa zvanā.X-ZOOM-DNIS, numuru, uz kuru zvanītājs zvanīja, kā{{sip_x_zoom_dnis}}.X-ZOOM-WEBHOOK, savienotāja statisko URL.
3. Saņemiet zvanu atpakaļ
Aģents nosūta REFER uz cilvēka aģenta adresi Zoom SBC. Pievienojiet šo
pārsūtīšanas numuru (skatiet
Pievienojiet pārsūtīšanas numuru),
norādot Zoom sniegto SBC adresi:
{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}Zoom ceļvedī ir aprakstīti divi veidi, kā bots nodod kontekstu: POST uz
savienotāja statisko URL pirms REFER (notikumi voicebot_metadata un līdzīgi),
kā arī SIP galvenes, kas kartētas sadaļā Ienākošie no bota. ThunderPhone
nesūta datus uz statisko URL. Zoom ceļvedī nav norādīts, vai tas nolasa
kartētās galvenes no REFER; ja vēlaties to izmēģināt, pievienojiet ierakstam
headers, piemēram, "X-Handoff-Id": "{{handoff_id}}", un pārbaudiet testa zvanā. Tāpat
apstipriniet ar Zoom, ka tas pieņem REFER bez metadatu POST pirms tā.
Lai iegūtu pārsūtīšanas datus, nepaļaujoties ne uz vienu no šiem veidiem, meklējiet tos savā plūsmā pēc Bot logrīka, izmantojot HTTP izsaukuma vai Skripta logrīku:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=un pēc tam zvana sid.- Galvene
Authorization: Bearer sk_live_…. - Izmantojiet
handoff.summaryunhandoff.intent, lai novirzītu zvanītāju un sniegtu informāciju personai, kas pieņem zvanu.
Zoom nepublicē šo logrīku lauku līmeņa dokumentāciju, tāpēc savā kontā
apstipriniet, ka logrīks var nosūtīt Authorization galveni. Skatiet
Uzmeklējiet pārsūtītu zvanu.
Pārbaudiet to
Zvaniet uz numuru, kas novirza uz Bot logrīku, lūdziet balss aģentam savienot ar
cilvēku un pārbaudiet, vai zvanītājs sasniedz cilvēka aģentu un logrīks atgriež
pārsūtīšanas datus. Pēc tam atveriet zvanu ar GET /v1/calls/{call_id}:
sip_headers jānorāda x-zoom-call-sid, un external_call_id jāatbilst zvana
sid, ko izmanto jūsu plūsma.
Ierobežojumi
- ThunderPhone nesūta datus uz savienotāja statisko URL, tāpēc Zoom saņem
pārsūtīšanas datus, izmantojot uzmeklēšanu vai kartētās galvenes, ja jūsu tests
parāda, ka Zoom tās nolasa no
REFER. - Maģistrāli izveido Zoom ISV komanda, tāpēc jūs to nevarat iestatīt vai pārbaudīt patstāvīgi.