---
title: "Connetti da Zoom Contact Center"
description: "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](/it/guides/api-keys) 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](https://developers.zoom.us/docs/contact-center/library/guides/3p-voicebot/)).
- 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](/it/guides/sip-addresses)):

```bash
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](/it/guides/contact-centers/overview)),
con l'indirizzo SBC fornito da Zoom:

```json
{"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](/api-reference/calls#look-up-a-handed-off-call).

## 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.
