Open in
Opret forbindelse fra Zoom Contact Center
Send opkald fra Zoom Contact Center til en ThunderPhone-agent med et tredjeparts-stemmebotstik, og send dem tilbage til en menneskelig agent med en SIP REFER.
En Bot-widget i dit Zoom Contact Center-flow sender opkalderen til agenten med
Zooms opkalds-SID. Når opkalderen har brug for en person, sender agenten en SIP REFER
til Zooms adresse for menneskelige agenter, og dit flow henter overdragelsen efter opkalds-SID.
Før du starter
- En ThunderPhone-agent og en organisations-API-nøgle.
- En Zoom Marketplace Generel app, administreret af din administrator og gjort tilgængelig for Contact Center, med en connector til Bot-widgetten (Zooms vejledning til tredjeparts-voicebots).
- En SIP-trunk fra Zoom til botudbyderen. Zooms ISV-team opbygger den i faser (afdækning, en staging-trunk og derefter produktion), og appens virksomhedsnavn skal matche trunk-posten nøjagtigt. Denne opsætning starter med ThunderPhone support og Zoom, ikke kun i din Zoom-konto.
1. Opret SIP-slutpunktet
Zooms connector ringer til et 15-cifret nummer, der starter med 999, ikke en SIP-
adresse. Når connectoren gemmes, genereres dette nummer. Zooms trunk bruger TLS 1.2
på port 5061 med SRTP til lyd og tillades via Zooms undernet frem for med en adgangskode.
Opret derfor et ip_allowlist-slutpunkt med connectorens
nummer som indgående opkaldsnummer og med SRTP påkrævet (se
Platforme, der ringer til et telefonnummer):
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: Zooms SIP-signalunder net, fra Zoom. Hvert skal være et offentligt IPv4-interval på/16eller smallere (IPv6/48eller smallere).dial_in_numbers: connectorens nummer præcis som Zoom sender det, uden et+.srtp:required, da Zooms trunk altid bruger SRTP.
Zooms adresser deles af alle deres kunder, så enhver anden Zoom-kunde, der ringer til nummeret, når din agent. Zoom tildeler nummeret; offentliggør det ikke.
2. Send opkald med kontekst
Tilføj en Bot-widget til dit flow, og tilknyt den til connectoren. Bed Zooms ISV-
team om at pege trunken mod sip.thunderphone.com, TLS på port 5061, med
connectorens nummer i både anmodnings-URI'en og To-headeren. Slutpunktet
afviser UDP, så sørg for, at trunken ikke falder tilbage til det.
Zoom sender:
X-ZOOM-Call-Sid, gemt som opkaldetsexternal_call_id. Zooms egen data- mapping-side angiver den ikke; en anden AI-udbyders Zoom-integration dokumenterer den, så kontrollér den ved dit første testopkald.X-ZOOM-DNIS, nummeret opkalderen ringede til, som{{sip_x_zoom_dnis}}.X-ZOOM-WEBHOOK, connectorens statiske URL.
3. Få opkaldet tilbage
Agenten sender en REFER til adressen på den menneskelige agent på Zooms SBC. Tilføj dette
viderestillingsnummer (se
Tilføj viderestillingsnummeret),
med den SBC-adresse, Zoom giver dig:
{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}Zooms vejledning beskriver to måder, hvorpå en bot videregiver kontekst: en POST til
connectorens statiske URL før REFER (voicebot_metadata og lignende
hændelser) samt SIP-headere, der er knyttet under Indgående fra bot. ThunderPhone
sender ikke data til den statiske URL. Zooms vejledning angiver ikke, om den læser
tilknyttede headere fra en REFER; hvis du vil prøve det, skal du tilføje headers såsom
"X-Handoff-Id": "{{handoff_id}}" til posten og kontrollere det med et testopkald. Bekræft også
med Zoom, at den accepterer en REFER uden en metadata-POST før den.
For at få overdragelsen uden at være afhængig af nogen af delene skal dit flow slå den op efter Bot-widgetten med en HTTP-kald- eller Script-widget:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=efterfulgt af opkaldets sid.- Headeren
Authorization: Bearer sk_live_…. - Brug
handoff.summaryoghandoff.intenttil at dirigere opkalderen og orientere personen, der tager opkaldet.
Zoom offentliggør ikke dokumentation på feltniveau for disse widgets, så bekræft på
din konto, at widgetten kan sende en Authorization-header. Se
Slå et overdraget opkald op.
Test det
Ring til et nummer, der når Bot-widgetten, bed agenten om en person, og kontrollér
at opkalderen når en menneskelig agent, og at widgetten returnerer overdragelsen. Åbn derefter
opkaldet med GET /v1/calls/{call_id}: sip_headers skal vise
x-zoom-call-sid, og external_call_id skal matche det opkalds-sid, dit flow
bruger.
Begrænsninger
- ThunderPhone sender ikke data til connectorens statiske URL, så Zoom får
overdragelsen via opslaget eller via tilknyttede headere, hvis din test viser,
at Zoom læser dem fra
REFER. - Trunken er opbygget af Zooms ISV-team, så du kan ikke selv opsætte eller teste den.