ThunderPhone v3 je zdaj na voljo.Začnite sami, že od 2 ¢/min.Preberite obvestilo

Contact centers

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 /16 ali ožji (IPv6 /48 ali 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 kot external_call_id klica. 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.summary in handoff.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.