ThunderPhone v3 on julkaistu.Ota käyttöön itse – alkaen 2 ¢/min.Lue lisää julkistuksesta

Contact centers

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 /16 tai tarkempi (IPv6 /48 tai 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 puhelun external_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- ja handoff.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.