ThunderPhone v3 ya está disponible.Empieza por tu cuenta desde 2¢/min.Lee el anuncio

Contact centers

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 /16 o más específico (IPv6 /48 o 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 el external_call_id de 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.summary y handoff.intent para 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.