Ir al contenido
Integración con Telnyx

Conecta una troncal SIP de Telnyx a Wixzel Voice

Para usar un agente de voz con IA en un número de Telnyx, conecta SIP Connections de Telnyx a Wixzel Voice: agrega la platform_ip que devuelve tu troncal a la lista de permitidos (authorised addresses on an IP-authenticated SIP Connection) para que se acepten las llamadas salientes, y envía las llamadas entrantes a su origination_uri para que lleguen. Telnyx 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

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

Telnyx
Wixzel Voice
Tu agente

¿Qué necesitas antes de empezar?

  • Una cuenta de Telnyx con SIP Connections, y el host y las credenciales de la troncal.
  • Un número de teléfono tuyo en Telnyx, asociado a esa troncal. Wixzel Voice no vende ni porta números. Si conectas tu cuenta de Telnyx desde la consola, también puedes comprar un número en esa cuenta desde la página Números de teléfono. Telnyx 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 Telnyx en Wixzel Voice?

La dirección SIP que Mission Control muestra para tu conexión. La guía de configuración no indica un host de Telnyx, así que cópialo de la consola y no de aquí.

cURL
curl https://api.voice.wixzel.com/v1/sip-trunks \
  -H "Authorization: Bearer $WIXZEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Telnyx",
    "host": "<the SIP host Telnyx shows for the connection>",
    "transport": "udp"
  }'

Agrega username y password al cuerpo si Telnyx 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 Telnyx?

AjusteCómo lo llama TelnyxValor
Permitir llamadas desde Wixzel Voiceauthorised addresses on an IP-authenticated SIP Connection187.126.120.231
Enviar llamadas entrantes a Wixzel VoiceEl destino de las llamadas entrantes; los pasos de configuración indican el camposip: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 Telnyx recorren la consola campo por campo.

¿Qué falla con Telnyx?

  • Una diferencia de transporte parece que el operador te ignora. Mantén la conexión y la troncal con el mismo transporte; UDP en ambos es lo predeterminado.
  • Telnyx espera el + inicial, así que deja send_plus en su valor predeterminado, true.

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

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

failure_codeLo que dijo el operadorQué significaQué hacer
102408El operador no respondió a tiempo.Verifica el host y el port de la troncal, y que el operador acepte SIP desde platform_ip. Si el operador muestra la llamada como recibida pero nunca contestada, define send_plus como false.

Una llamada que Telnyx 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 Telnyx?

Telnyx 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

¿Qué tipo de conexión de Telnyx funciona con Wixzel Voice?

La autenticación por IP. Crea la SIP Connection en Mission Control con el tipo de conexión definido como autenticación por IP, en lugar de credenciales o registro por FQDN, y agrega como dirección autorizada la platform_ip que devuelve tu troncal de Wixzel Voice.

¿Por qué mis llamadas de Telnyx no se conectan después de cambiar el transporte?

Telnyx entrega por UDP de forma predeterminada. Si el transport de la troncal de Wixzel Voice es tcp o tls, hay que cambiar el SIP Transport Protocol de la conexión de Telnyx para que coincida, o los dos extremos no se entenderán.

Otros operadores

Twilio

Elastic SIP Trunking. Agrega la IP de la plataforma a una IP ACL de Termination y configura el Origination SIP URI para las llamadas entrantes.

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.