---
title: "Se connecter depuis Zoom Contact Center"
description: "Envoyez les appels Zoom Contact Center vers un agent ThunderPhone à l’aide d’un connecteur de voicebot tiers, puis reprenez-les avec un agent humain via un SIP REFER."
---

Un widget Bot dans votre flux Zoom Contact Center envoie l'appelant à l'agent avec le SID d'appel de Zoom. Lorsque l'appelant a besoin d'une personne, l'agent envoie un `REFER` SIP à l'adresse de l'agent humain de Zoom, et votre flux récupère le transfert par SID d'appel.

## Avant de commencer

- Un agent ThunderPhone et une [clé API](/fr/guides/api-keys) d'organisation.
- Une **application générale** Zoom Marketplace, gérée par votre administrateur et mise à disposition de Contact Center, avec un connecteur pour le widget Bot
  ([guide de Zoom sur les bots vocaux tiers](https://developers.zoom.us/docs/contact-center/library/guides/3p-voicebot/)).
- Un trunk SIP de Zoom vers le fournisseur du bot. L'équipe ISV de Zoom le met en place par étapes (découverte, trunk de préproduction, puis production), et le nom de l'entreprise de l'application doit correspondre exactement à l'enregistrement du trunk. Cette configuration commence avec l'assistance ThunderPhone et Zoom, et non uniquement dans votre compte Zoom.

## 1. Créer le point de terminaison SIP

Le connecteur Zoom compose un numéro à 15 chiffres commençant par `999`, et non une adresse SIP. L'enregistrement du connecteur génère ce numéro. Le trunk Zoom utilise TLS 1.2 sur le port 5061 avec SRTP pour l'audio, et il est autorisé par les sous-réseaux de Zoom plutôt que par un mot de passe. Créez donc un point de terminaison `ip_allowlist` avec le numéro du connecteur comme numéro d'appel entrant et SRTP obligatoire (voir
[Plateformes qui composent un numéro de téléphone](/fr/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` : les sous-réseaux de signalisation SIP de Zoom, fournis par Zoom. Chacun doit être une plage IPv4 publique de `/16` ou plus restreinte (IPv6 `/48` ou plus restreinte).
- `dial_in_numbers` : le numéro du connecteur exactement tel que Zoom l'envoie, sans `+`.
- `srtp` : `required`, car le trunk Zoom utilise toujours SRTP.

Les adresses Zoom sont partagées par tous ses clients ; tout autre client Zoom qui compose ce numéro atteint donc votre agent. Zoom attribue le numéro ; ne le publiez pas.

## 2. Envoyer les appels avec du contexte

Ajoutez un widget **Bot** à votre flux et associez-le au connecteur. Demandez à l'équipe ISV de Zoom de configurer le trunk vers `sip.thunderphone.com`, avec TLS sur le port 5061, et le numéro du connecteur à la fois dans l'URI de requête et dans l'en-tête `To`. Le point de terminaison refuse UDP ; assurez-vous donc que le trunk ne bascule pas vers ce protocole.

Zoom envoie :

- `X-ZOOM-Call-Sid`, stocké comme `external_call_id` de l'appel. La page de mappage des données de Zoom ne le répertorie pas ; l'intégration Zoom d'un autre fournisseur d'IA le documente, vérifiez-le donc lors de votre premier appel de test.
- `X-ZOOM-DNIS`, le numéro composé par l'appelant, sous la forme `{{sip_x_zoom_dnis}}`.
- `X-ZOOM-WEBHOOK`, l'URL statique du connecteur.

## 3. Récupérez l’appel

L’agent envoie un `REFER` à l’adresse de l’agent humain sur le SBC de Zoom. Ajoutez ce
numéro de transfert (voir
[Ajouter le numéro de transfert](/fr/guides/contact-centers/overview)),
avec l’adresse SBC fournie par Zoom :

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

Le guide de Zoom décrit deux façons pour un bot de transmettre le contexte : un `POST` vers
l’URL statique du connecteur avant le `REFER` (événements `voicebot_metadata` et similaires),
et des en-têtes SIP mappés sous **Entrant depuis le bot**. ThunderPhone n’envoie pas de
requête POST vers l’URL statique. Le guide de Zoom n’indique pas s’il lit les en-têtes
mappés depuis un `REFER` ; si vous souhaitez essayer, ajoutez des `headers` tels que
`"X-Handoff-Id": "{{handoff_id}}"` à l’entrée et vérifiez lors d’un appel de test. Confirmez
également auprès de Zoom qu’il accepte un `REFER` sans `POST` de métadonnées préalable.

Pour récupérer le transfert sans dépendre de l’un ou l’autre, configurez votre flux pour
l’interroger après le widget Bot, avec un widget **Appel HTTP** ou **Script** :

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  suivi du SID de l’appel.
- En-tête `Authorization: Bearer sk_live_…`.
- Utilisez `handoff.summary` et `handoff.intent` pour le routage de l’appelant et pour
  informer la personne qui prend l’appel.

Zoom ne publie pas de documentation au niveau des champs pour ces widgets. Vérifiez donc
dans votre compte que le widget peut envoyer un en-tête `Authorization`. Consultez
[Rechercher un appel transféré](/api-reference/calls#look-up-a-handed-off-call).

## Testez-le

Appelez un numéro qui aboutit au widget Bot, demandez à l’agent de vous transférer à une
personne et vérifiez que l’appelant est mis en relation avec un agent humain et que le
widget renvoie le transfert. Récupérez ensuite l’appel avec `GET /v1/calls/{call_id}` :
`sip_headers` doit répertorier `x-zoom-call-sid`, et `external_call_id` doit correspondre
au SID d’appel utilisé par votre flux.

## Limites

- ThunderPhone n’envoie pas de requête POST vers l’URL statique du connecteur. Zoom récupère
  donc le transfert via la recherche, ou via les en-têtes mappés si votre test montre que
  Zoom les lit depuis le `REFER`.
- Le trunk est conçu par l’équipe ISV de Zoom. Vous ne pouvez donc pas le configurer ni le
  tester vous-même.
