ThunderPhone v3 je dostupan.Postavite sve sami, već od 2 ¢/min.Pročitajte objavu

Contact centers

Povezivanje iz Zoom Contact Centera

Usmjerite pozive iz Zoom Contact Centera glasovnom agentu ThunderPhone putem poveznikâ glasovnih botova trećih strana i vratite ih ljudskom agentu pomoću SIP REFER-a.

Widget Bot u Vašem Zoom Contact Center tijeku usmjerava pozivatelja agentu sa Zoomovim SID-om poziva. Kada pozivatelj treba osobu, agent šalje SIP REFER na Zoomovu adresu ljudskog agenta, a Vaš tijek dohvaća preusmjeravanje prema SID-u poziva.

Prije početka

  • ThunderPhone agent i organizacijski API ključ.
  • Zoom Marketplace Opća aplikacija, kojom upravlja Vaš administrator i koja je dostupna za Contact Center, s konektorom za widget Bot (Zoomov vodič za glasovne botove trećih strana).
  • SIP trunk od Zooma do pružatelja bota. Zoomov ISV tim izrađuje ga u fazama (inicijalna analiza, testni trunk, zatim produkcija), a polje Naziv tvrtke aplikacije mora se točno podudarati sa zapisom trunka. Ovo postavljanje započinje uz podršku ThunderPhonea i Zooma, a ne samo na Vašem Zoom računu.

1. Izradite SIP krajnju točku

Zoomov konektor bira 15-znamenkasti broj koji počinje s 999, a ne SIP adresu. Spremanje konektora generira taj broj. Zoomov trunk koristi TLS 1.2 na priključku 5061 sa SRTP-om za zvuk te je na popisu dopuštenih prema Zoomovim podmrežama, a ne lozinkom. Stoga izradite krajnju točku ip_allowlist s brojem konektora kao brojem za pozivanje i obaveznim SRTP-om (pogledajte Platforme koje biraju telefonski broj):

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: Zoomove SIP signalizacijske podmreže, koje dobivate od Zooma. Svaka mora biti javni IPv4 raspon /16 ili uži (IPv6 /48 ili uži).
  • dial_in_numbers: broj konektora točno onako kako ga Zoom šalje, bez znaka +.
  • srtp: required, jer Zoomov trunk uvijek koristi SRTP.

Zoomove adrese dijele svi njegovi korisnici, pa svaki drugi Zoomov korisnik koji bira taj broj dolazi do Vašeg agenta. Zoom dodjeljuje broj; nemojte ga objavljivati.

2. Šaljite pozive s kontekstom

Dodajte widget Bot u svoj tijek i povežite ga s konektorom. Zatražite od Zoomova ISV tima da trunk usmjeri na sip.thunderphone.com, uz TLS na priključku 5061, s brojem konektora u URI-ju zahtjeva i zaglavlju To. Krajnja točka odbija UDP, stoga provjerite da trunk ne prijeđe na njega.

Zoom šalje:

  • X-ZOOM-Call-Sid, pohranjen kao external_call_id poziva. Zoomova vlastita stranica za mapiranje podataka ne navodi ga; dokumentira ga Zoomova integracija drugog pružatelja AI-ja, stoga ga provjerite pri prvom testnom pozivu.
  • X-ZOOM-DNIS, broj koji je pozivatelj birao, kao {{sip_x_zoom_dnis}}.
  • X-ZOOM-WEBHOOK, statični URL konektora.

3. Preuzmite poziv natrag

Agent šalje REFER na adresu ljudskog agenta na Zoomovu SBC-u. Dodajte ovaj broj za preusmjeravanje (pogledajte Dodajte broj za preusmjeravanje), s adresom SBC-a koju vam Zoom navede:

{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}

Zoomov vodič opisuje dva načina na koja bot prenosi kontekst: POST na statički URL konektora prije REFER zahtjeva (voicebot_metadata i slični događaji) te SIP zaglavlja mapirana u odjeljku Dolazno od bota. ThunderPhone ne šalje podatke na statički URL. Zoomov vodič ne navodi čita li mapirana zaglavlja iz REFER zahtjeva; ako želite pokušati, dodajte headers poput "X-Handoff-Id": "{{handoff_id}}" u unos i provjerite to testnim pozivom. Također potvrdite sa Zoomom da prihvaća REFER bez POST zahtjeva s metapodacima prije njega.

Da biste dobili predaju bez oslanjanja na bilo koji od tih načina, postavite da je vaš tok dohvaća nakon widgeta Bot pomoću widgeta HTTP poziv ili Skripta:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= nakon kojeg slijedi SID poziva.
  • Zaglavlje Authorization: Bearer sk_live_….
  • Upotrijebite handoff.summary i handoff.intent za usmjeravanje pozivatelja i informiranje osobe koja preuzima poziv.

Zoom ne objavljuje dokumentaciju na razini polja za ove widgete, stoga u svom računu potvrdite da widget može poslati zaglavlje Authorization. Pogledajte Dohvat predanog poziva.

Testirajte

Nazovite broj koji vodi do widgeta Bot, zatražite od agenta razgovor s osobom i provjerite dolazi li pozivatelj do ljudskog agenta te vraća li widget predaju. Zatim otvorite poziv pomoću GET /v1/calls/{call_id}: sip_headers bi trebao navesti x-zoom-call-sid, a external_call_id trebao bi odgovarati SID-u poziva koji vaš tok upotrebljava.

Ograničenja

  • ThunderPhone ne šalje podatke na statički URL konektora, pa Zoom predaju dobiva putem dohvata ili putem mapiranih zaglavlja ako vaš test pokaže da ih Zoom čita iz REFER zahtjeva.
  • Trunk izrađuje Zoomov ISV tim, stoga ga ne možete samostalno postaviti ni testirati.