Open in
Prijunkite iš Zoom Contact Center
Nukreipkite Zoom Contact Center skambučius į ThunderPhone agentą naudodami trečiosios šalies balso boto jungtį ir grąžinkite juos žmogaus agentui naudodami SIP REFER.
„Bot“ valdiklis jūsų Zoom kontaktų centro sraute perduoda skambinantį asmenį agentui su
Zoom skambučio SID. Kai skambinančiajam reikia žmogaus pagalbos, agentas siunčia SIP REFER
į Zoom žmogaus konsultanto adresą, o jūsų srautas gauna perdavimą pagal skambučio SID.
Prieš pradėdami
- ThunderPhone agentas ir organizacijos API raktas.
- Zoom Marketplace bendroji programėlė, administruojama jūsų administratoriaus ir prieinama kontaktų centrui, su „Bot“ valdiklio jungtimi (Zoom trečiųjų šalių balso roboto vadovas).
- SIP magistralė iš Zoom į balso roboto paslaugų teikėją. Zoom ISV komanda ją kuria etapais (poreikių analizė, testavimo magistralė, tada produkcinė magistralė), o programėlės įmonės pavadinimas turi tiksliai sutapti su magistralės įrašu. Ši sąranka pradedama su ThunderPhone palaikymo komanda ir Zoom, ne vien jūsų Zoom paskyroje.
1. Sukurkite SIP galinį tašką
Zoom jungtis surenka 15 skaitmenų numerį, prasidedantį 999, o ne SIP
adresą. Išsaugojus jungtį sugeneruojamas šis numeris. Zoom magistralė naudoja TLS 1.2
5061 prievade su SRTP garsui, o prieiga ribojama pagal Zoom potinklius, o ne slaptažodžiu.
Todėl sukurkite ip_allowlist galinį tašką su jungties numeriu kaip įeinamuoju numeriu ir
privalomu SRTP (žr.
Platformos, kurios surenka telefono numerį):
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 signalizavimo potinkliai, gauti iš Zoom. Kiekvienas turi būti viešas/16arba siauresnis IPv4 diapazonas (IPv6/48arba siauresnis).dial_in_numbers: jungties numeris tiksliai toks, kokį siunčia Zoom, be+.srtp:required, nes Zoom magistralė visada naudoja SRTP.
Zoom adresai bendri visiems jo klientams, todėl bet kuris kitas Zoom klientas, surinkęs numerį, pasieks jūsų agentą. Zoom priskiria numerį; neskelbkite jo.
2. Siųskite skambučius su kontekstu
Pridėkite Bot valdiklį prie savo srauto ir susiekite jį su jungtimi. Paprašykite Zoom ISV
komandos nukreipti magistralę į sip.thunderphone.com, naudojant TLS 5061 prievade, su
jungties numeriu ir užklausos URI, ir To antraštėje. Galinis taškas
atmeta UDP, todėl įsitikinkite, kad magistralė negrįžta prie jo.
Zoom siunčia:
X-ZOOM-Call-Sid, saugomą kaip skambučioexternal_call_id. Zoom duomenų susiejimo puslapyje jis nenurodomas; jį dokumentuoja kito DI paslaugų teikėjo Zoom integracija, todėl patikrinkite jį per pirmąjį bandomąjį skambutį.X-ZOOM-DNIS, skambinančiojo surinktą numerį, kaip{{sip_x_zoom_dnis}}.X-ZOOM-WEBHOOK, jungties statinį URL.
3. Susigrąžinkite skambutį
Agentas siunčia REFER į žmogaus konsultanto adresą Zoom SBC. Pridėkite šį
peradresavimo numerį (žr.
Pridėkite peradresavimo numerį),
nurodydami Zoom pateiktą SBC adresą:
{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}Zoom vadove aprašomi du būdai, kaip botas perduoda kontekstą: POST į
jungties Static URL prieš REFER (įvykiai voicebot_metadata ir panašūs)
bei SIP antraštės, susietos dalyje Įeinantys iš roboto. ThunderPhone
nesiunčia duomenų į Static URL. Zoom vadove nenurodyta, ar jis nuskaito
susietas antraštes iš REFER; jei norite pabandyti, prie įrašo pridėkite
headers, pvz., "X-Handoff-Id": "{{handoff_id}}", ir patikrinkite bandomuoju
skambučiu. Taip pat su Zoom patvirtinkite, kad jis priima REFER be
metaduomenų POST prieš jį.
Norėdami gauti perdavimą nepasikliaudami nė vienu iš šių būdų, po Bot valdiklio nustatykite, kad srautas jo ieškotų naudodamas HTTP užklausos arba Scenarijaus valdiklį:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=ir po jo nurodykite skambučio sid.- Antraštė
Authorization: Bearer sk_live_…. - Naudokite
handoff.summaryirhandoff.intent, kad nukreiptumėte skambinantįjį ir informuotumėte skambutį perimantį asmenį.
Zoom neskelbia išsamios laukų dokumentacijos šiems valdikliams, todėl savo
paskyroje patvirtinkite, kad valdiklis gali siųsti Authorization antraštę. Žr.
Raskite perduotą skambutį.
Išbandykite
Skambinkite numeriu, kuris nukreipia į Bot valdiklį, paprašykite agento sujungti
su žmogumi ir patikrinkite, ar skambinantysis pasiekia žmogaus konsultantą ir ar
valdiklis grąžina perdavimą. Tada atidarykite skambutį naudodami
GET /v1/calls/{call_id}: sip_headers turėtų nurodyti x-zoom-call-sid, o
external_call_id turėtų atitikti skambučio sid, kurį naudoja jūsų srautas.
Ribojimai
- ThunderPhone nesiunčia duomenų į jungties Static URL, todėl Zoom gauna
perdavimą per paiešką arba per susietas antraštes, jei jūsų bandymas rodo, kad
Zoom jas nuskaito iš
REFER. - SIP magistralę kuria Zoom ISV komanda, todėl negalite jos patys sukonfigūruoti ar išbandyti.