Trunking SIP

Descripción general

El trunking SIP (Session Initiation Protocol) te permite conectar directamente tu infraestructura de telefonía actual con ElevenLabs Agents. Esta integración permite a todos los clientes utilizar sus sistemas telefónicos actuales mientras aprovechan las avanzadas capacidades de voz IA de ElevenLabs.

Con el trunking SIP, puedes:

• Conectar tu Private Branch Exchange (PBX) o sistema telefónico compatible con SIP a la plataforma de voz IA de ElevenLabs
• Enrutar llamadas a agentes de IA sin cambiar tu infraestructura telefónica actual
• Gestionar llamadas entrantes y salientes
• Aprovechar el transporte TLS cifrado y el cifrado multimedia para mejorar la seguridad

Cómo funciona el trunking SIP

El trunking SIP establece una conexión directa entre tu infraestructura de telefonía y la plataforma de ElevenLabs:

1. Llamadas entrantes: Las llamadas de tu trunk SIP se enrutan a la plataforma de ElevenLabs mediante tu dirección SIP INVITE configurada.
2. Llamadas salientes: Las llamadas iniciadas por ElevenLabs se enrutan a tu trunk SIP mediante tu nombre de host configurado, lo que permite a tus agentes realizar llamadas salientes.
3. Autenticación: La seguridad de la conexión para la señalización se mantiene mediante autenticación digest (nombre de usuario/contraseña) o autenticación mediante lista de control de acceso (ACL) basada en la IP de origen de la señalización.
4. Señalización y contenido multimedia: La configuración inicial de la llamada (señalización) admite varios protocolos de transporte, incluido TLS para la comunicación cifrada. Una vez establecida la llamada, los datos de audio reales (flujo RTP) pueden cifrarse según tus ajustes de cifrado multimedia.

Seguridad del transporte: certificados y suites de cifrado

Al usar el transporte TLS, ambas partes realizan un handshake de TLS antes de intercambiar señalización SIP. Durante el handshake, validan un certificado y negocian una suite de cifrado. La parte que acepta la conexión actúa como servidor TLS y presenta el certificado; la que abre la conexión actúa como cliente TLS y lo valida. ElevenLabs requiere TLS 1.2 o una versión posterior.

Las funciones dependen de la dirección de la llamada:

• Llamadas entrantes a ElevenLabs: Tu sistema abre la conexión, por lo que ElevenLabs actúa como servidor TLS. ElevenLabs presenta un certificado válido para sip.rtc.elevenlabs.io, y tu sistema lo valida como cliente TLS.
• Llamadas salientes desde ElevenLabs: ElevenLabs abre la conexión a la dirección que configuraste, por lo que tu servidor SIP o SBC actúa como servidor TLS. Tu sistema debe presentar un certificado válido y de confianza, que ElevenLabs valida como cliente TLS.

Asegúrate de que ambas partes confíen en los certificados de la otra y compartan al menos una suite de cifrado. De lo contrario, el handshake de TLS falla antes de establecer la llamada. Consulta la referencia de SIP para ver las definiciones de estos términos.

Conexiones posteriores

Algunas solicitudes dentro del diálogo, como BYE o REFER, pueden requerir una nueva conexión TLS cuando la conexión original ya se ha cerrado. El comportamiento de los certificados para estas conexiones posteriores difiere de la configuración inicial de la llamada:

• Conexiones posteriores a ElevenLabs: Tu sistema establece la conexión con la dirección del encabezado Contact que devuelve la respuesta, que se resuelve en un servidor SIP específico con el formato <ip>.hosts.rtc.elevenlabs.io. Ese servidor presenta un certificado válido para *.hosts.rtc.elevenlabs.io, que tu sistema valida como cliente TLS.
• Conexiones posteriores desde ElevenLabs: Cuando ElevenLabs inicia una conexión TLS para un BYE o REFER, se conecta a la dirección del encabezado Via superior, que suele ser una dirección IP. Normalmente, tu sistema devuelve un certificado válido para un nombre de dominio completo (FQDN), en lugar de para esa dirección IP. Para validar este certificado, configura el campo Dominios remotos en los ajustes de tu número de teléfono. Si algún dominio para el que es válido el certificado recibido coincide con un dominio remoto configurado, la validación se realiza correctamente; de lo contrario, falla.

Realizar llamadas al trunk SIP de ElevenLabs

Al iniciar llamadas a la plataforma de ElevenLabs, debes usar el formato de URI SIP adecuado. La URI del trunk SIP de ElevenLabs depende del transporte que quieras usar para la señalización:

• TCP: sip:sip.rtc.elevenlabs.io:5060;transport=tcp
• TLS: sip:sip.rtc.elevenlabs.io:5061;transport=tls
• UDP: sip:sip.rtc.elevenlabs.io:5060;transport=udp (experimental; úsalo solo para pruebas, no en producción)

Para realizar una llamada, construye una URI SIP completa que incluya un identificador. Por ejemplo, para llamar al número de teléfono +19991234567 mediante TCP:

sip:+19991234567@sip.rtc.elevenlabs.io:5060

Donde:

• +19991234567 es el identificador (normalmente, un número de teléfono en formato E.164)
• El identificador también puede ser cualquier valor de cadena, como 1000 o john

Requisitos

Antes de configurar el trunk SIP, asegúrate de tener:

1. Una PBX o sistema de telefonía compatible con SIP
2. Números de teléfono que quieras conectar a ElevenLabs
3. Acceso de administrador a la configuración de tu trunk SIP
4. Ajustes de firewall adecuados para permitir tráfico SIP
5. Compatibilidad con TLS: Para mejorar la seguridad, asegúrate de que tu proveedor de trunk SIP admita transporte TLS
6. Compatibilidad con códecs de audio: Tu sistema debe admitir al menos uno de los códecs de audio G.722 o G.711 (PCMU o PCMA), o poder remuestrear el audio por tu parte. Esto es independiente de cualquier formato de audio configurado en el agente para conexiones websocket directas.

Configurar trunk SIP

1

Ve a Números de teléfono

Ve a la sección Números de teléfono en el panel de ElevenAgents.

2

Importa un trunk SIP

Haz clic en el botón “Importar número” y selecciona “Desde trunk SIP” para abrir el diálogo de configuración.

3

Introduce la configuración básica

Completa la configuración básica con la siguiente información:

• Etiqueta: Un nombre descriptivo para el número de teléfono
• Número de teléfono: El número de teléfono en formato E.164 que quieres conectar (por ejemplo, +15551234567)

4

Configura los ajustes de entrada

Configura cómo gestiona ElevenLabs las llamadas que llegan a tu trunk SIP, incluido el cifrado multimedia y los controles de acceso:

• Cifrado multimedia: Configura el cifrado de los flujos multimedia RTP:
  • Desactivado: Sin cifrado multimedia
  • Permitido: Permite flujos multimedia cifrados
  • Obligatorio: Exige flujos multimedia cifrados
• Números permitidos (opcional): Números de teléfono autorizados para llamar a este número. Déjalo vacío para permitir todos los números.
• Direcciones IP de origen permitidas (opcional): Solo funciona con transporte TCP/TLS, no con UDP. Direcciones IP o rangos CIDR autorizados para enviar llamadas a este trunk. Déjalo como 0.0.0.0/0 para permitir todas las direcciones.
• Dominios remotos (opcional): Especifica los dominios FQDN de tus servidores SIP desde los que originas las llamadas, por ejemplo, example.pstn.twilio.com. Estos dominios se usan para la validación de certificados TLS. Deja este campo vacío si no usas TLS.
• Autenticación (opcional): Proporciona credenciales de autenticación digest que se usarán para autenticar las llamadas entrantes.
  • Nombre de usuario del trunk SIP: Nombre de usuario para la autenticación digest SIP
  • Contraseña del trunk SIP: Contraseña para la autenticación digest SIP

5

Configura los ajustes de salida

Configura dónde debe enviar ElevenLabs las llamadas de tu número de teléfono:

• Dirección: Nombre de host o dirección IP a la que se envía el SIP INVITE (por ejemplo, sip.telnyx.com). Debe ser solo un nombre de host o una dirección IP, no una URI SIP completa. Si usas TLS, utiliza un nombre de host con un certificado válido.

• Tipo de transporte: Selecciona el protocolo de transporte para la señalización SIP:

  • TCP: Transporte TCP estándar
  • TLS: Transporte TLS cifrado para mayor seguridad
  • UDP: Transporte sin conexión (experimental; usa TCP o TLS en producción)

• Cifrado multimedia: Configura el cifrado de los flujos multimedia RTP:

  • Desactivado: Sin cifrado multimedia
  • Permitido: Permite flujos multimedia cifrados
  • Obligatorio: Exige flujos multimedia cifrados

• Códecs habilitados: Códecs que se ofrecerán en el SDP para llamadas salientes (G.722, PCMU, PCMA). Es útil cuando tu proveedor SIP solo admite determinados códecs.

• Encabezados personalizados (opcional): Añade encabezados SIP personalizados para incluirlos en las llamadas salientes. Haz clic en “Añadir encabezado” para introducir el nombre y el valor del encabezado que requiere tu proveedor; puedes añadir varios encabezados según sea necesario. Los encabezados personalizados pueden usarse para el enrutamiento e identificación de llamadas, fines de facturación y seguimiento, y requisitos específicos del proveedor.

• Autenticación (opcional): Proporciona credenciales de autenticación digest si las requiere tu proveedor de trunk SIP.

  • Nombre de usuario del trunk SIP: Nombre de usuario para la autenticación digest SIP
  • Contraseña del trunk SIP: Contraseña para la autenticación digest SIP

  Si lo dejas vacío, se usará la autenticación mediante lista de control de acceso (ACL), que requiere incluir las direcciones IP de ElevenLabs en la lista de permitidas de los ajustes de tu proveedor.

Práctica recomendada de seguridad: Usa transporte TLS con cifrado multimedia obligatorio para obtener la máxima seguridad. Así te aseguras de que tanto la señalización como los medios estén cifrados de extremo a extremo.

Métodos de autenticación:

• Autenticación digest: Usa credenciales de nombre de usuario y contraseña para una autenticación segura (recomendado)
• Autenticación ACL: Usa listas de permitidas de direcciones IP para el control de acceso

La autenticación digest es muy recomendable, ya que ofrece mejor seguridad sin depender de listas de permitidas de IP, que pueden ser complejas de gestionar con direcciones IP dinámicas.

El campo Dirección especifica dónde enviará ElevenLabs las llamadas salientes de tus agentes de IA. Introduce solo el nombre de host o la dirección IP, sin el prefijo de protocolo sip:.

6

Completa la configuración

Haz clic en “Importar” para finalizar la configuración.

Datos de cliente y personalización

Para garantizar el reenvío y la trazabilidad adecuados de los metadatos de las llamadas, incluye los siguientes encabezados SIP personalizados en la carga útil de tu webhook y en la solicitud SIP INVITE:

• X-CALL-ID: Identificador único de la llamada
• X-CALLER-ID: Identificador de la parte que realiza la llamada

Estos encabezados permiten al sistema asociar los metadatos de la llamada con la conversación y proporcionar contexto para la personalización.

Compatibilidad con encabezados alternativos

Si los encabezados estándar anteriores no están presentes, el sistema buscará automáticamente el encabezado SIP específico de Twilio:

• sip.twilio.callSid: Identificador único de llamada de Twilio

Esta alternativa garantiza la compatibilidad con Elastic SIP Trunking de Twilio sin requerir cambios de configuración.

Flujo de procesamiento

Una vez que se reciben los metadatos pertinentes mediante cualquiera de los encabezados compatibles, caller_id o call_id están disponibles en el webhook de inicio de conversación y como variables dinámicas del sistema.

Encabezados personalizados entrantes como variables dinámicas

Los encabezados SIP personalizados X- de las llamadas entrantes mediante trunk SIP se exponen automáticamente como variables dinámicas en la conversación.

Los nombres de los encabezados se normalizan eliminando el prefijo X-, convirtiendo el nombre a minúsculas, sustituyendo los guiones por guiones bajos y añadiendo el prefijo sip_. Por ejemplo, X-Contact-ID pasa a ser {{sip_contact_id}} y X-Campaign-ID pasa a ser {{sip_campaign_id}}.

Usa estas variables en los prompts del agente, los primeros mensajes y las herramientas para personalizar la conversación con el contexto proporcionado por quien llama. Los valores también son visibles en el historial de la conversación, en la pestaña Llamada telefónica.

Encabezados BYE a partir de variables dinámicas

Cuando finaliza una llamada, ElevenLabs envía un SIP BYE para cerrar el diálogo. Puedes adjuntar encabezados personalizados a ese BYE asignando variables dinámicas a nombres de encabezado en la configuración de tu trunk SIP.

Configura attributes_to_headers en inbound_trunk_config o outbound_trunk_config al crear o actualizar un número de teléfono de trunk SIP mediante la API. Cada entrada asigna un nombre de variable dinámica al nombre de encabezado SIP que se incluirá en el BYE:

"inbound_trunk_config": {
  "attributes_to_headers": {
    "dynamic_variable_name": "bye_header_name"
  }
}

El valor del encabezado es el valor final de la variable dinámica al terminar la conversación. Los valores establecidos durante la llamada, mediante herramientas del agente, anulaciones de webhook u otras actualizaciones en tiempo de ejecución, se reflejan en el BYE.

Por ejemplo, si attributes_to_headers contiene "disposition_code": "X-Disposition" y la variable dinámica disposition_code es resolved al finalizar la conversación, el BYE incluye X-Disposition: resolved.

Asignar agentes a números de teléfono

Después de importar tu número de teléfono de trunk SIP, puedes asignarlo a un agente de ElevenLabs:

1. Ve a la sección Números de teléfono en el panel de ElevenAgents
2. Selecciona tu número de teléfono de trunk SIP importado
3. Haz clic en “Asignar agente”
4. Selecciona el agente que quieres que gestione las llamadas a este número

Resolución de problemas

Limitaciones y consideraciones

• La compatibilidad con varias llamadas simultáneas depende de tu nivel de suscripción. Activa la cola de llamadas para mantener en espera a quienes llamen cuando se alcance el límite, en lugar de rechazar sus llamadas
• Las funciones de grabación de llamadas y analítica están disponibles, pero pueden requerir configuración adicional
• Las capacidades de llamadas salientes pueden estar limitadas por tu proveedor de trunk SIP
• Compatibilidad con TLS: Asegúrate de que tu proveedor de trunk SIP admita TLS 1.2 o una versión posterior para el transporte cifrado
• Cifrado multimedia: La compatibilidad con SRTP varía según el proveedor; verifica la compatibilidad antes de exigir cifrado
• Formato de audio: La implementación SIP de ElevenLabs envía y recibe audio mediante los códecs PCMU o PCMA (G.711, 8 kHz) o G.722 (16 kHz). Esto es independiente de cualquier formato de audio configurado en el agente para conexiones websocket directas. Tu sistema de trunk SIP debe admitir de forma nativa uno de estos códecs o realizar remuestreo para adaptarse a los requisitos de tu sistema

Preguntas frecuentes

Próximos pasos

• Referencia de SIP: glosario de términos de SIP y redes
• Descubre cómo crear agentes de ElevenLabs