Ir al contenido
Integración con Twilio

Conecta una troncal SIP de Twilio a Wixzel Voice

Para usar un agente de voz con IA en un número de Twilio, conecta Elastic SIP Trunking de Twilio a Wixzel Voice: agrega la platform_ip que devuelve tu troncal a la lista de permitidos (IP Access Control List) para que se acepten las llamadas salientes, y configura el campo Origination SIP URI con su origination_uri para que lleguen las llamadas entrantes. Twilio te sigue cobrando la línea con tus tarifas; Wixzel Voice cobra el motor de voz por segundo, de un saldo prepago.

Última actualización:

Publicado el

Twilio es el operador; Wixzel Voice es la API de IA de voz que ejecuta el agente sobre él. Funcionan juntos mediante SIP estándar. Twilio es una marca registrada de su propietario, y Wixzel Voice no está afiliado a Twilio ni cuenta con su respaldo.

Twilio
Wixzel Voice
Tu agente

¿Qué necesitas antes de empezar?

  • Una cuenta de Twilio con Elastic SIP Trunking, y el host y las credenciales de la troncal.
  • Un número de teléfono tuyo en Twilio, asociado a esa troncal. Wixzel Voice no vende ni porta números. Si conectas tu cuenta de Twilio desde la consola, también puedes comprar un número en esa cuenta desde la página Números de teléfono. Twilio lo factura a su precio.
  • Una clave de API de Wixzel Voice y algo de crédito prepago. La recarga mínima es de $5; no hay plan gratuito.
  • Wixzel Voice admite 5 llamadas simultáneas por cuenta de forma predeterminada, que se amplían a pedido; las sesiones web y de apps cuentan para el mismo límite.

¿Cómo creas la troncal de Twilio en Wixzel Voice?

El Termination SIP URI que Twilio muestra en la troncal, el mismo your-domain.pstn.twilio.com que aparece en la consola.

cURL
curl https://api.voice.wixzel.com/v1/sip-trunks \
  -H "Authorization: Bearer $WIXZEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Twilio",
    "host": "your-domain.pstn.twilio.com",
    "transport": "udp"
  }'

Agrega username y password al cuerpo si Twilio autentica con credenciales en lugar de por IP. La contraseña se guarda cifrada y la API nunca vuelve a devolverla. La respuesta incluye platform_ip y origination_uri: los dos valores que necesita el siguiente paso.

¿Qué configuras en Twilio?

AjusteCómo lo llama TwilioValor
Permitir llamadas desde Wixzel VoiceIP Access Control List187.126.120.231
Enviar llamadas entrantes a Wixzel VoiceOrigination SIP URIsip:187.126.120.231:5090

Ambos valores son los de hoy: lee platform_ip y origination_uri en GET /v1/sip-trunks en lugar de copiarlos de una página. Luego registra cada número en la troncal con POST /v1/phone-numbers y asígnale un inbound_agent_id para que conteste un agente. La guía de la API de llamadas telefónicas con IA tiene esas solicitudes, y los pasos de configuración completos para Twilio recorren la consola campo por campo.

¿Qué falla con Twilio?

  • Twilio autoriza las llamadas salientes por IP de origen y rechaza todo lo demás al instante. Si falta la entrada en la IP ACL, se ve como un rechazo inmediato, más o menos un segundo después de hacer la llamada, con failure_code 21 (llamada rechazada). No suena y no se agota el tiempo de espera.
  • Las llamadas salientes funcionan sin el Origination URI; las entrantes no, y no avisan. El número está asociado, el agente está asignado y el teléfono simplemente nunca llega al agente.
  • Twilio espera el + inicial en el número marcado, así que deja send_plus en su valor predeterminado, true.

¿Por qué no se conectó una llamada a través de Twilio?

El código de falla que más se ve en Twilio:

failure_codeLo que dijo el operadorQué significaQué hacer
21403 / 407El operador rechazó la llamada directamente, antes de intentar el número.En orden de probabilidad: la cuenta del operador está suspendida, cerrada o sin saldo; el usuario o la contraseña de la troncal son incorrectos; platform_ip no está en la lista de permitidos; o el identificador de llamada no está autorizado en la cuenta. Revisa primero el panel del operador.

Una llamada que Twilio rechazó tiene status: "failed", un failure_code (la causa Q.850 del operador) y un failure_reason que dice qué hacer, y no cuesta nada. Todos los códigos de falla, todos los rechazos y cómo depurar una troncal están en la página de operadores.

¿Cuánto cuesta una llamada con IA a través de Twilio?

Twilio te cobra la línea con tus tarifas; Wixzel Voice cobra solo el motor de voz, por segundo de uso real, desde $0.0491 por minuto conectado con gemini-live hasta $0.1851 con deepgram-agent. El precio de cada motor.

Preguntas frecuentes

¿Por qué mi llamada de Twilio se rechaza en menos de un segundo?

Una llamada que falla en más o menos un segundo con failure_code 21 y sin sonar fue rechazada por Twilio antes de enrutarse. En Twilio casi siempre se debe a la IP Access Control List de Termination: agrega 187.126.120.231 (la platform_ip que devuelve tu troncal). Una llamada que se acepta y falla varios segundos después es otro problema: enrutamiento, formato del número o permisos de la cuenta.

¿Puedo usar una Credential List de Twilio en lugar de una IP ACL?

Sí. Pon el usuario y la contraseña de la Credential List en los campos username y password de la troncal de Wixzel Voice y se usan en lugar de la autenticación por IP. La contraseña se guarda cifrada y la API nunca vuelve a devolverla.

Otros operadores

Telnyx

Una SIP Connection autenticada por IP. Agrega la IP de la plataforma como dirección autorizada, elige una región para las llamadas entrantes y haz coincidir el transporte.

Plivo

Zentrunk. Una troncal saliente con la IP de la plataforma en su IP ACL y una troncal entrante aparte cuyo Primary URI apunta a la plataforma.

Vonage

Programmable SIP. Agrega la IP de la plataforma a la ACL de la troncal en el SIP Dashboard y envía las llamadas entrantes al origination URI.

Bandwidth

Sin SIP REGISTER, así que se necesita una IP estática. Agrega la IP de la plataforma a la ubicación, configura Termination y Origination por separado o usa credenciales de network bridge.

Exotel

Virtual SIP Trunking (vSIP), para numeración de la India, por TCP. La IP de la plataforma asociada a la troncal como ACL y el Destination URI apuntado al puerto TCP de la plataforma para las llamadas entrantes.

Vobiz

Un dominio SIP por troncal como host, la IP de la plataforma en la IP ACL de la troncal y un «origination URI» que significa lo contrario de lo que significa en Twilio.

Mobily

Saudi Arabia, ordered through Mobily Business sales and delivered over a private link. No one-step connect: your own SBC on the link relays calls, with G.711 A-law and a one-hour call cap.

Cualquier proveedor SIP

El patrón es el mismo en todas partes: agrega la IP de la plataforma a la lista de permitidos, define el origination URI como destino de las llamadas entrantes y haz coincidir el formato del número y el transporte.

Trae tu propia troncal SIP

Cómo funcionan las dos mitades de una troncal, todos los códigos de falla y todas las guías de operadores en una página.