ThunderPhone v3 è online.Attivazione self-service, da 2¢/min.Leggi l’annuncio

Contact centers

Connetti da Zoom Contact Center

Inoltra le chiamate di Zoom Contact Center a un agente ThunderPhone con un connettore voicebot di terze parti e riportale a un agente umano con un SIP REFER.

Un widget Bot nel tuo flusso Zoom Contact Center invia il chiamante all'agente con il call sid di Zoom. Quando il chiamante ha bisogno di una persona, l'agente invia un REFER SIP all'indirizzo dell'agente umano di Zoom e il tuo flusso recupera il trasferimento tramite call sid.

Prima di iniziare

  • Un agente ThunderPhone e una chiave API dell'organizzazione.
  • Una App generale di Zoom Marketplace, gestita dal tuo amministratore e resa disponibile per Contact Center, con un connettore per il widget Bot (guida di Zoom ai voicebot di terze parti).
  • Un trunk SIP da Zoom al provider del bot. Il team ISV di Zoom lo configura in fasi (analisi, trunk di preproduzione, quindi produzione) e il Company Name dell'app deve corrispondere esattamente al record del trunk. Questa configurazione inizia con il supporto ThunderPhone e Zoom, non solo nel tuo account Zoom.

1. Crea l'endpoint SIP

Il connettore di Zoom chiama un numero di 15 cifre che inizia con 999, non un indirizzo SIP. Il salvataggio del connettore genera quel numero. Il trunk Zoom usa TLS 1.2 sulla porta 5061 con SRTP per l'audio ed è inserito nella allowlist tramite le subnet di Zoom anziché una password. Crea quindi un endpoint ip_allowlist con il numero del connettore come numero di chiamata in ingresso e SRTP obbligatorio (vedi piattaforme che chiamano un numero di telefono):

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: le subnet di segnalazione SIP di Zoom, fornite da Zoom. Ognuna deve essere un intervallo IPv4 pubblico di /16 o più ristretto (IPv6 /48 o più ristretto).
  • dial_in_numbers: il numero del connettore esattamente come Zoom lo invia, senza +.
  • srtp: required, poiché il trunk di Zoom usa sempre SRTP.

Gli indirizzi di Zoom sono condivisi da tutti i suoi clienti, quindi qualsiasi altro cliente Zoom che chiama il numero raggiunge il tuo agente. Zoom assegna il numero; non pubblicarlo.

2. Invia le chiamate con contesto

Aggiungi un widget Bot al tuo flusso e associalo al connettore. Chiedi al team ISV di Zoom di puntare il trunk a sip.thunderphone.com, TLS sulla porta 5061, con il numero del connettore sia nell'URI della richiesta sia nell'header To. L'endpoint rifiuta UDP, quindi assicurati che il trunk non effettui il fallback a UDP.

Zoom invia:

  • X-ZOOM-Call-Sid, memorizzato come external_call_id della chiamata. La pagina di mappatura dei dati di Zoom non lo elenca; l'integrazione Zoom di un altro provider AI lo documenta, quindi verificalo nella prima chiamata di test.
  • X-ZOOM-DNIS, il numero chiamato dal chiamante, come {{sip_x_zoom_dnis}}.
  • X-ZOOM-WEBHOOK, l'URL statico del connettore.

3. Ricevi la chiamata

L'agente invia un REFER all'indirizzo dell'agente umano sull'SBC di Zoom. Aggiungi questo numero di trasferimento (vedi Aggiungi il numero di trasferimento), con l'indirizzo SBC fornito da Zoom:

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

La guida di Zoom descrive due modi in cui un bot trasferisce il contesto: un POST all'URL Static del connettore prima del REFER (eventi voicebot_metadata e simili) e intestazioni SIP mappate in In entrata dal bot. ThunderPhone non invia post all'URL Static. La guida di Zoom non specifica se legge le intestazioni mappate da un REFER; se vuoi provare, aggiungi headers come "X-Handoff-Id": "{{handoff_id}}" alla voce e verifica con una chiamata di test. Conferma inoltre con Zoom che accetti un REFER senza un POST di metadati precedente.

Per ottenere il passaggio senza dipendere da nessuno dei due metodi, fai in modo che il tuo flusso lo cerchi dopo il widget Bot, con un widget Chiamata HTTP o Copione:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= seguito dal sid della chiamata.
  • Intestazione Authorization: Bearer sk_live_….
  • Usa handoff.summary e handoff.intent per instradare il chiamante e informare la persona che risponde alla chiamata.

Zoom non pubblica documentazione a livello di campo per questi widget, quindi verifica nel tuo account che il widget possa inviare un'intestazione Authorization. Vedi Cerca una chiamata trasferita.

Testalo

Chiama un numero che raggiunge il widget Bot, chiedi all'agente di parlare con una persona e verifica che il chiamante raggiunga un agente umano e che il widget restituisca il passaggio. Quindi apri la chiamata con GET /v1/calls/{call_id}: sip_headers dovrebbe elencare x-zoom-call-sid e external_call_id dovrebbe corrispondere al sid della chiamata usato dal tuo flusso.

Limiti

  • ThunderPhone non invia post all'URL Static del connettore, quindi Zoom riceve il passaggio tramite la ricerca oppure tramite intestazioni mappate, se il test mostra che Zoom le legge dal REFER.
  • Il trunk è realizzato dal team ISV di Zoom, quindi non puoi configurarlo o testarlo autonomamente.