Trunking SIP de Bandwidth
Antes de seguir esta guía, te recomendamos leer la guía de trunking SIP para entender cómo ElevenLabs admite trunks SIP.
Descripción general
Esta guía explica cómo conectar tus trunks SIP de Bandwidth directamente a ElevenLabs Agents. Esta integración te permite usar tus números de teléfono e infraestructura actuales de Bandwidth y, al mismo tiempo, aprovechar las funciones avanzadas de voz IA de ElevenLabs tanto para llamadas entrantes como salientes.
Cómo funciona el trunking SIP con Bandwidth
El trunking SIP establece una conexión directa entre tu infraestructura de telefonía de Bandwidth y la plataforma de ElevenLabs:
- Llamadas entrantes: Las llamadas de Bandwidth se enrutan a la plataforma de ElevenLabs mediante nuestra URI de originación. Esto se configura en la aplicación de Bandwidth mediante un Voice Configuration Package (VCP).
- Llamadas salientes: Las llamadas iniciadas por ElevenLabs se enrutan a tu trunk SIP de Bandwidth mediante el FQDN de tu realm o las direcciones SBC de terminación, lo que permite a tus agentes realizar llamadas salientes.
- Autenticación: Bandwidth proporciona autenticación basada en SIP para trunks de comunicaciones unificadas (UC), mediante autenticación digest a través de credenciales SIP (network bridge). Este método es esencial para facilitar las llamadas salientes desde ElevenLabs y garantizar una comunicación segura.
- Señalización y medios: La configuración inicial de la llamada (señalización) usa UDP/TLS. Una vez establecida la llamada, los datos de audio reales (flujo RTP) se transmiten a través de UDP.
Requisitos
Antes de configurar la integración del trunk SIP de Bandwidth, asegúrate de tener:
- Una cuenta activa de ElevenLabs
- Una cuenta activa de Bandwidth Universal Platform con trunking SIP activado (con sip-auth activado)
- Al menos un número de teléfono adquirido o portado a tu cuenta de Bandwidth
- Acceso de administrador a tu cuenta en la aplicación de Bandwidth
Configuración de llamadas entrantes (de Bandwidth a ElevenLabs)
Configura los ajustes de originación de Bandwidth para enrutar las llamadas entrantes a ElevenLabs.
Crea un Voice Configuration Package
- Ve a la pestaña Service Management y selecciona Voice Configuration.
- Haz clic en Create New para crear un nuevo Voice Configuration Package.
- Introduce un nombre de paquete único.
- Haz clic en Add Route.
- Elige Route to Domain Name.
- Introduce el FQDN proporcionado por ElevenLabs en el campo correspondiente. Normalmente es
sip.rtc.elevenlabs.io. Si tu cuenta de ElevenLabs usa una región aislada de residencia de datos o una infraestructura SIP estática, usa la ruta de API SIP correspondiente. Consulta residencia de datos para conocer las regiones disponibles. - Haz clic en Save para terminar de crear el Voice Configuration Package.
Consulta la documentación de VCP de Bandwidth para obtener más información.
Configuración de llamadas salientes (de ElevenLabs a Bandwidth)
Para las llamadas salientes, ElevenLabs debe autenticarse con Bandwidth. El enfoque recomendado es la autenticación digest de SIP mediante un realm y credenciales.
Crea un realm
- En la aplicación de Bandwidth, selecciona Account y haz clic en SIP Credentials.
- Desplázate hasta Manage Realms y haz clic en Add.
- Introduce un nombre de realm y una descripción opcional; después, haz clic en Add.
Bandwidth crea un FQDN de realm con el formato {realmname}.{hash}.auth.bandwidth.com. Anota este FQDN: lo usarás como dirección saliente en ElevenLabs.
Si no ves la pestaña SIP Credentials, ponte en contacto con tu gestor de cuenta de Bandwidth o abre un ticket con el soporte de Bandwidth para activar la autenticación SIP en tu cuenta.
Crea credenciales SIP
- En la sección SIP Credentials, haz clic en Add.
- Introduce un Username y una Password.
- Selecciona el realm que creaste en el paso anterior.
- Haz clic en Add SIP Credentials.
Guarda el nombre de usuario y la contraseña de forma segura. Los introducirás en la configuración del trunk SIP de ElevenLabs.
Anota el FQDN de tu realm
Tu dirección de terminación saliente es el FQDN de realm que se muestra después de crearlo (por ejemplo, myrealm-a1b2c3.auth.bandwidth.com). Introduce este nombre de host en el campo Address al configurar los ajustes salientes en ElevenLabs.
Para comprobar las direcciones IP de SBC asociadas a tu realm, realiza una búsqueda SRV:
Bandwidth proporciona un par de IP de SBC emparejadas para ofrecer redundancia. Ambas deben ser accesibles para el tráfico saliente.
Completa la configuración en ElevenLabs
Después de configurar estos ajustes en la aplicación de Bandwidth, importa tu número de teléfono en ElevenLabs:
Importa el número de teléfono del trunk SIP
Sigue la guía de trunking SIP para importar tu número de teléfono de Bandwidth. Usa los siguientes ajustes:
- Tipo de transporte: UDP (o TLS si tu trunk de Bandwidth usa señalización cifrada)
- Cifrado de medios: Debe coincidir con la configuración de tu trunk de Bandwidth
- Dirección saliente: El FQDN de tu realm (por ejemplo,
myrealm-a1b2c3.auth.bandwidth.com) - Nombre de usuario y contraseña del trunk SIP: Las credenciales creadas en la aplicación de Bandwidth
Asigna un agente
Después de importarlo, asigna un agente al número de teléfono en el panel de control de números de teléfono.
Después de configurar tu trunk SIP de Bandwidth, sigue la guía de trunking SIP para completar la configuración en ElevenLabs.
Solución de problemas
Las llamadas entrantes no se conectan
- Comprueba que
sip.rtc.elevenlabs.ioesté introducido como destino de ruta en los ajustes de originación de VCP de Bandwidth. - Confirma que el número de teléfono esté asignado al VCP con los ajustes de originación correctos.
- Asegúrate de que el formato del número de teléfono en ElevenLabs coincida con el formato E.164 que envía Bandwidth (con un
+inicial). - Comprueba que tu firewall permita el tráfico de señalización SIP en el protocolo de transporte y puerto configurados (5060 para UDP, 5061 para TLS) y que los puertos RTP no estén bloqueados.
Las llamadas salientes reciben errores 407 o de autenticación
- Confirma que el nombre de usuario del trunk SIP, la contraseña y el realm de ElevenLabs coincidan con las credenciales creadas en la aplicación de Bandwidth.
- Comprueba que el campo Address contenga solo el nombre de host FQDN del realm, sin el prefijo
sip:. - Asegúrate de que el tipo de transporte de los ajustes salientes de ElevenLabs coincida con la configuración de tu trunk de Bandwidth (UDP o TLS).
Audio en un solo sentido o sin audio
- Confirma que los puertos RTP estén abiertos para el tráfico de medios y que no estén bloqueados por tu firewall.
- Comprueba la compatibilidad del códec G711ulaw. Bandwidth y ElevenLabs admiten G711.
Preguntas frecuentes
¿Qué transporte y puertos de señalización requiere Bandwidth?
Bandwidth y ElevenLabs usan UDP en el puerto 5060 para la señalización SIP. Si tu trunk de Bandwidth está configurado para transporte cifrado, usa TLS en el puerto 5061 en su lugar.
¿Qué formato de número de teléfono debo usar?
Usa el formato E.164 con un + inicial (por ejemplo, +19192971100). Bandwidth envía y espera números en este formato.
¿Qué códecs de audio son compatibles?
ElevenLabs admite G711 y G722. Bandwidth admite G711ulaw y G729a. G711ulaw es el códec recomendado para la compatibilidad entre ambas plataformas.