Ir al contenido
Integración con Vonage

Conecta una troncal SIP de Vonage a Wixzel Voice

Para usar un agente de voz con IA en un número de Vonage, conecta Programmable SIP de Vonage a Wixzel Voice: agrega la platform_ip que devuelve tu troncal a la lista de permitidos (ACL (Access Control List)) para que se acepten las llamadas salientes, y envía las llamadas entrantes a su origination_uri para que lleguen. Vonage 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

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

VonageVonage
Wixzel Voice
Tu agente

¿Qué necesitas antes de empezar?

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

La dirección SIP que el SIP Dashboard de Vonage muestra para la troncal. La guía de configuración no indica un host de Vonage, así que cópialo del panel.

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

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

AjusteCómo lo llama VonageValor
Permitir llamadas desde Wixzel VoiceACL (Access Control List)187.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 Vonage recorren la consola campo por campo.

¿Qué falla con Vonage?

  • Vonage publica sus propios rangos de IP para el tráfico que te envía. Wixzel Voice no necesita abrir nada de su lado para ellos, pero si tu propio firewall está delante de cualquier otra cosa en la ruta, esa es la lista que debes permitir.
  • Elige Programmable SIP, no el otro producto de Vonage con SIP en el nombre; solo Programmable SIP se comporta como una troncal elástica.

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

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

Vonage 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é producto de Vonage necesito para Wixzel Voice?

Programmable SIP. Vonage tiene dos productos con SIP en el nombre, y Programmable SIP es el que se comporta como una troncal elástica. En su SIP Dashboard están la ACL y los ajustes de llamadas entrantes.

¿Tengo que permitir los rangos de IP de Vonage del lado de Wixzel Voice?

No. Vonage publica los rangos de IP de los que sale su tráfico, pero Wixzel Voice no necesita abrir nada para ellos. Esa lista solo importa si tu propio firewall está en otro punto de la ruta de la llamada. Lo que Vonage necesita de ti es la platform_ip que devuelve tu troncal, agregada a la ACL de la troncal en el SIP Dashboard.

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.

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.

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.