Open in
Conecta desde Zoom Contact Center
Envía llamadas de Zoom Contact Center a un agente de ThunderPhone con un conector de voicebot de terceros y devuélvelas a un agente humano con un SIP REFER.
Un widget Bot en tu flujo de Zoom Contact Center envía a quien llama al agente con el SID de llamada de
Zoom. Cuando quien llama necesita una persona, el agente envía un REFER SIP
a la dirección de agente humano de Zoom, y tu flujo obtiene la transferencia mediante el SID de llamada.
Antes de comenzar
- Un agente de ThunderPhone y una clave de API de la organización.
- Una Aplicación general de Zoom Marketplace, administrada por tu administrador y disponible para Contact Center, con un conector para el widget Bot (guía de voicebots de terceros de Zoom).
- Una troncal SIP de Zoom al proveedor del bot. El equipo de ISV de Zoom la crea por etapas (descubrimiento, una troncal de preproducción y luego producción), y el nombre de la empresa de la aplicación debe coincidir exactamente con el registro de la troncal. Esta configuración comienza con el soporte de ThunderPhone y Zoom, no solo en tu cuenta de Zoom.
1. Crea el endpoint SIP
El conector de Zoom marca un número de 15 dígitos que comienza con 999, no una dirección
SIP. Guardar el conector genera ese número. La troncal de Zoom usa TLS 1.2
en el puerto 5061 con SRTP para el audio, y se incluye en listas de permitidos mediante las subredes de Zoom en lugar de una contraseña. Por lo tanto, crea un endpoint ip_allowlist
con el número del conector como número de acceso telefónico y SRTP obligatorio (consulta
Plataformas que marcan un número de teléfono):
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: las subredes de señalización SIP de Zoom, proporcionadas por Zoom. Cada una debe ser un rango IPv4 público de/16o más específico (IPv6/48o más específico).dial_in_numbers: el número del conector exactamente como lo envía Zoom, sin un+.srtp:required, ya que la troncal de Zoom siempre usa SRTP.
Las direcciones de Zoom son compartidas por todos sus clientes, por lo que cualquier otro cliente de Zoom que marque el número llegará a tu agente. Zoom asigna el número; no lo publiques.
2. Envía llamadas con contexto
Agrega un widget Bot a tu flujo y vincúlalo al conector. Pide al equipo de ISV de Zoom
que apunte la troncal a sip.thunderphone.com, TLS en el puerto 5061, con el
número del conector tanto en la URI de solicitud como en el encabezado To. El endpoint
rechaza UDP, así que asegúrate de que la troncal no recurra a él.
Zoom envía:
X-ZOOM-Call-Sid, almacenado como elexternal_call_idde la llamada. La propia página de mapeo de datos de Zoom no lo incluye; la integración de Zoom de otro proveedor de IA lo documenta, así que verifícalo en tu primera llamada de prueba.X-ZOOM-DNIS, el número que marcó quien llama, como{{sip_x_zoom_dnis}}.X-ZOOM-WEBHOOK, la URL estática del conector.
3. Recibe la llamada de vuelta
El agente envía un REFER a la dirección del agente humano en el SBC de Zoom. Agrega este
número de transferencia (consulta
Agrega el número de transferencia),
con la dirección del SBC que Zoom te proporcione:
{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}La guía de Zoom describe dos formas en que un bot transmite contexto: un POST a la
URL estática del conector antes del REFER (eventos voicebot_metadata y similares),
y encabezados SIP asignados en Entrante desde bot. ThunderPhone no envía solicitudes a la URL estática. La guía de Zoom no indica si lee
encabezados asignados desde un REFER; si quieres probarlo, agrega headers como
"X-Handoff-Id": "{{handoff_id}}" a la entrada y verifica en una llamada de prueba. También
confirma con Zoom que acepta un REFER sin un POST de metadatos antes de este.
Para obtener la transferencia sin depender de ninguno de los dos, haz que tu flujo la busque después del widget Bot, con un widget de Llamada HTTP o Script:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=seguido del sid de la llamada.- Encabezado
Authorization: Bearer sk_live_…. - Usa
handoff.summaryyhandoff.intentpara dirigir a quien llama e informar a la persona que toma la llamada.
Zoom no publica documentación a nivel de campo para estos widgets, así que confirma en tu
cuenta que el widget puede enviar un encabezado Authorization. Consulta
Busca una llamada transferida.
Pruébalo
Llama a un número que llegue al widget Bot, pídele al agente hablar con una persona y verifica
que quien llama llegue a un agente humano y que el widget devuelva la transferencia. Luego
abre la llamada con GET /v1/calls/{call_id}: sip_headers debe incluir
x-zoom-call-sid, y external_call_id debe coincidir con el sid de llamada que usa tu flujo.
Límites
- ThunderPhone no envía solicitudes a la URL estática del conector, por lo que Zoom recibe la
transferencia mediante la búsqueda o mediante encabezados asignados si tu prueba muestra que
Zoom los lee desde el
REFER. - El trunk lo crea el equipo de ISV de Zoom, así que no puedes configurarlo ni probarlo por tu cuenta.