Open in
Yhdistä Zoom Contact Centeristä
Ohjaa Zoom Contact Center -puhelut ThunderPhone-agentille kolmannen osapuolen äänibottiyhdistimellä ja siirrä ne takaisin ihmisen agentille SIP REFER -pyynnöllä.
Zoom Contact Center -työnkulkusi Botti-widget lähettää soittajan agentille Zoomin
puhelun SID-tunnuksen avulla. Kun soittaja tarvitsee ihmisen, agentti lähettää SIP-REFER-pyynnön
Zoomin ihmisagentin osoitteeseen, ja työnkulkusi hakee siirron puhelun SID-tunnuksen perusteella.
Ennen kuin aloitat
- ThunderPhone-agentti ja organisaation API-avain.
- Zoom Marketplace -palvelun Yleinen sovellus, jota ylläpitäjäsi hallinnoi ja joka on otettu käyttöön Contact Centerissä, sekä Botti-widgetin liitin (Zoomin kolmannen osapuolen puhebotin opas).
- Zoomista botin tarjoajalle kulkeva SIP-runko. Zoomin ISV-tiimi rakentaa sen vaiheittain (kartoitus, testi-SIP-runko ja sitten tuotanto), ja sovelluksen Company Name -arvon on vastattava täsmälleen SIP-rungon tietuetta. Tämä määritys aloitetaan ThunderPhone- tuen ja Zoomin kanssa, ei pelkästään Zoom-tililläsi.
1. Luo SIP-päätepiste
Zoomin liitin soittaa 999-alkuiseen 15-numeroiseen numeroon, ei SIP-
osoitteeseen. Liittimen tallentaminen luo kyseisen numeron. Zoomin SIP-runko käyttää TLS 1.2:ta
portissa 5061 ja SRTP:tä äänelle, ja se sallitaan Zoomin aliverkkojen eikä salasanan
perusteella. Luo siis ip_allowlist-päätepiste, jossa liittimen numero on soittonumerona ja SRTP on pakollinen (katso
Alustat, jotka soittavat puhelinnumeroon):
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: Zoomin SIP-signaloinnin aliverkot, jotka saat Zoomilta. Jokaisen on oltava julkinen IPv4-alue, jonka peite on/16tai tarkempi (IPv6/48tai tarkempi).dial_in_numbers: liittimen numero täsmälleen siinä muodossa kuin Zoom sen lähettää, ilman+-merkkiä.srtp:required, koska Zoomin SIP-runko käyttää aina SRTP:tä.
Zoomin osoitteet ovat yhteisiä kaikille sen asiakkaille, joten kuka tahansa toinen Zoom-asiakas, joka soittaa numeroon, pääsee agentillesi. Zoom määrittää numeron; älä julkaise sitä.
2. Lähetä puhelut kontekstin kanssa
Lisää työnkulkuusi Botti-widget ja liitä se liittimeen. Pyydä Zoomin ISV-
tiimiä ohjaamaan SIP-runko osoitteeseen sip.thunderphone.com TLS:llä portissa 5061 siten, että
liittimen numero on sekä pyyntö-URI:ssa että To-otsikossa. Päätepiste
ei hyväksy UDP:tä, joten varmista, ettei SIP-runko palaa siihen varavaihtoehtona.
Zoom lähettää:
X-ZOOM-Call-Sid, joka tallennetaan puhelunexternal_call_id-arvoksi. Zoomin oma tietojen yhdistämissivu ei luettele sitä; toisen tekoälypalveluntarjoajan Zoom-integraatio dokumentoi sen, joten tarkista se ensimmäisessä testipuhelussasi.X-ZOOM-DNIS, soittajan soittaman numeron, muodossa{{sip_x_zoom_dnis}}.X-ZOOM-WEBHOOK, liittimen staattisena URL-osoitteena.
3. Ohjaa puhelu takaisin
Agentti lähettää REFER-pyynnön Zoomin SBC:ssä olevaan ihmisagentin osoitteeseen. Lisää tämä
siirtonumero (katso
Lisää siirtonumero),
käyttäen Zoomin antamaa SBC-osoitetta:
{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}Zoomin ohjeessa kuvataan kaksi tapaa, joilla botti välittää kontekstin: POST-pyyntö
yhdistimen staattiseen URL-osoitteeseen ennen REFER-pyyntöä (voicebot_metadata ja vastaavat
tapahtumat) sekä SIP-otsakkeet, jotka on yhdistetty kohdan Saapuva liikenne botilta alle. ThunderPhone
ei lähetä pyyntöjä staattiseen URL-osoitteeseen. Zoomin ohjeessa ei kerrota, lukeeko se
yhdistetyt otsakkeet REFER-pyynnöstä. Jos haluat kokeilla sitä, lisää merkintään headers,
kuten "X-Handoff-Id": "{{handoff_id}}", ja tarkista asia testipuhelulla. Varmista myös
Zoomilta, että se hyväksyy REFER-pyynnön ilman sitä edeltävää metatietojen POST-pyyntöä.
Jotta saat siirron ilman kumpaankaan tukeutumista, määritä työnkulkusi hakemaan se Bot-widgetin jälkeen HTTP-kutsu- tai Skripti-widgetillä:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=ja sen perään puhelun sid.- Otsake
Authorization: Bearer sk_live_…. - Reititä soittaja
handoff.summary- jahandoff.intent-arvojen avulla ja anna puhelun vastaanottavalle henkilölle tarvittavat taustatiedot.
Zoom ei julkaise näiden widgetien kenttäkohtaisia ohjeita, joten varmista omalla
tililläsi, että widget voi lähettää Authorization-otsakkeen. Katso
Hae siirretty puhelu.
Testaa
Soita numeroon, joka ohjautuu Bot-widgetiin, pyydä puheagentilta ihmistä ja tarkista,
että soittaja päätyy ihmisagentille ja widget palauttaa siirtotiedot. Avaa sitten
puhelu komennolla GET /v1/calls/{call_id}: sip_headers-kentässä pitäisi näkyä
x-zoom-call-sid, ja external_call_id-arvon pitäisi vastata työnkulkusi käyttämää
puhelun sid-arvoa.
Rajoitukset
- ThunderPhone ei lähetä pyyntöjä yhdistimen staattiseen URL-osoitteeseen, joten Zoom saa
siirron haun kautta tai yhdistettyjen otsakkeiden kautta, jos testisi osoittaa, että
Zoom lukee ne
REFER-pyynnöstä. - Zoomin ISV-tiimi rakentaa trunkin, joten et voi määrittää tai testata sitä itse.