Open in
Se connecter depuis Zoom Contact Center
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 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).
- 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) :
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/16ou plus restreinte (IPv6/48ou 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é commeexternal_call_idde 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),
avec l’adresse SBC fournie par Zoom :
{"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.summaryethandoff.intentpour 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é.
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.