ThunderPhone v3 er live.Selvbetjening fra 2 cent pr. minut.Læs mere om lanceringen

Contact centers

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å /16 eller smallere (IPv6 /48 eller 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 opkaldets external_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.summary og handoff.intent til 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.