Conecta la troncal de cualquier proveedor SIP a Wixzel Voice
Para usar un agente de voz con IA en números de cualquier operador, conecta la troncal SIP del operador a Wixzel Voice: permite la platform_ip que devuelve tu troncal para que se acepten las llamadas salientes, y envía las llamadas entrantes a su origination_uri. Tu operador 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
Wixzel Voice¿Qué necesitas antes de empezar?
- Una troncal SIP de cualquier operador, con su host y, si usa registro, un usuario y una contraseña.
- Un número de teléfono tuyo en tu operador, asociado a esa troncal. Wixzel Voice no vende ni porta números.
- 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 en Wixzel Voice?
El host SIP que tu operador te da para la troncal.
curl https://api.voice.wixzel.com/v1/sip-trunks \
-H "Authorization: Bearer $WIXZEL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "My carrier",
"host": "sip.carrier.example",
"transport": "udp"
}'Agrega username y password al cuerpo si tu operador 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 tu operador?
| Ajuste | Cómo lo llama tu operador | Valor |
|---|---|---|
| Permitir llamadas desde Wixzel Voice | IP ACL, lista de permitidos o dirección autorizada | 187.126.120.231 |
| Enviar llamadas entrantes a Wixzel Voice | Origination URI, o el nombre que le dé tu operador | sip: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 cualquier proveedor SIP recorren la consola campo por campo.
¿Qué falla con un operador desconocido?
- Un puerto SIP abierto empieza a recibir escaneos de fraude telefónico a las pocas horas de aparecer. Mantén activos los controles antifraude de tu propio operador.
- Algunos mercados condicionan las llamadas salientes a verificaciones de identidad. Una cuenta que no ha terminado el KYC, o el registro de destinos donde el mercado lo exige, puede tener saldo positivo y aun así ver cómo todas sus llamadas salientes se cortan de inmediato.
- Tener saldo prepagado con el operador es necesario pero no suficiente. Confirma que el rango de destino concreto esté habilitado en la cuenta, no solo que haya crédito.
¿Por qué no se conectó una llamada a través de tu operador?
Los códigos de falla que más se ven en tu operador:
| failure_code | Lo que dijo el operador | Qué significa | Qué hacer |
|---|---|---|---|
| 1 | 404 | El operador no reconoce el número. | Revisa el formato del número. Si el operador necesita un prefijo técnico de marcación, define dial_prefix en la troncal. |
| 3 | - | El operador no tiene ruta hacia este destino. | Probablemente el destino no está habilitado en tu cuenta del operador. Pide al operador que abra la ruta. |
| 28 | 484 | El operador rechazó el formato del número. | Si el operador necesita un prefijo técnico de marcación, define dial_prefix en la troncal. |
| 102 | 408 | El 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 tu operador 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 tu operador?
Tu operador 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
¿Wixzel Voice funciona con operadores que no tienen guía aquí?
Mi operador responde 408 Request Timeout. ¿Qué cambio?
send_plus como false en la troncal con PATCH /v1/sip-trunks/{id}. Muchos operadores mayoristas no pueden interpretar un + inicial en el request URI: aceptan el INVITE, no logran enrutarlo y se agota el tiempo de espera. Definir un dial_prefix implica lo mismo, porque un prefijo técnico se compara literalmente y el + se elimina.Otros operadores
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.
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.
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.
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.
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.
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.
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.
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.
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.
Crea tu primer agente de voz