Lista de configuración
- Copia la URI SIP de la plataforma desde Settings → Numbers → Add a number → Add SIP integration (o Carrier import). Elige una SIP region (por defecto: global) para que la señalización entrante termine donde la necesites (por ejemplo, la UE).
- En tu proveedor, configura esa URI como el destino de originación o reenvío de tus números.
- Crea la troncal en la plataforma (formulario a continuación): autenticación entrante + terminación saliente.
- Asigna números a los asistentes y prueba la entrada, y después haz una llamada de prueba saliente.
Tipo de troncal
Entrante (recibir llamadas)
- Your phone number (DID) — el E.164 público que marcan tus clientes; debe coincidir con lo que el operador reenvía a la URI SIP de la plataforma.
- Inbound authentication
- SIP username/password — solo cuando el operador envía explícitamente credenciales Digest al destino de reenvío.
- Provider source IPs — úsalo cuando el operador reenvía al FQDN de la plataforma sin Digest posterior y publica IP/CIDR de señalización SIP estables. No uses rangos de medios ni redes demasiado amplias.
- En el proveedor: reenvía u origina hacia la URI SIP de la plataforma que copiaste.
Saliente (realizar llamadas)
- Termination address — solo el host SIP del proveedor (por ejemplo,
sip.telnyx.com). Sin prefijosip:, sin puerto. - Transport —
AUTO(recomendado),UDP,TCPoTLS. La troncal segura siempre usa TLS. - Outbound region — desde dónde origina la llamada la plataforma. Prefiere Automatic, o el país más cercano a tus clientes o al POP del operador.
- Outbound calling number format — cómo se envía el número FROM al operador. Debe coincidir con el ajuste del operador (por ejemplo, Telnyx Origination Number Format):
- International with
+(recomendado para la mayoría) - International without
+ - National (no country code)
- International with
- Credentials
- Shared (recomendado) — un único usuario/contraseña para entrada y salida.
- Separate — credenciales distintas para entrada y salida cuando el operador lo exige.
- Outbound authentication — usuario/contraseña (recomendado). La plataforma no tiene IP salientes estáticas, así que las listas de IP permitidas del operador suelen fallar. Usa “no credentials” solo si el operador permite explícitamente tráfico saliente sin autenticar.
Avanzado
Despliega Advanced al crear o editar una troncal propia:
HD Voice (G.722): actívalo en los ajustes de conexión/códec de Telnyx cuando lo necesites (compatible con Telnyx, no con Twilio).
Editar una troncal existente
Las troncales existentes se editan desde Numbers → Configure → Carrier Settings (no desde una lista de troncales independiente en Add SIP integration).Enrutamiento en la UE
Para clientes en la UE, selecciona EU SIP region al crear la conexión. Consulta tu contrato y la documentación de tratamiento de datos para conocer los compromisos regionales aplicables.Límites y comportamiento
- Los números E.164 en troncales propias cuentan para el mismo límite de números del plan que los números comprados.
- Las llamadas a través de tu propia troncal evitan el recargo por operador y destino de la plataforma — tu proveedor factura la terminación directamente. Los minutos del plan se siguen consumiendo; consulta facturación.
- Las funciones del asistente, como los flows, la transferencia asistida y la grabación, funcionan igual en troncales propias.
Solución de problemas
Las llamadas salientes fallan o no conectan — primero compara el host de terminación, el transporte y las credenciales con la documentación de tu proveedor: un transporte incorrecto (UDP en vez de TLS), o un prefijosip: o un puerto de más en la dirección de terminación, es la causa más habitual. Después compara el formato del número saliente y los ajustes de códec con lo que espera el proveedor. Cambia un ajuste a la vez y haz una única llamada de prueba después de cada cambio, para que History te muestre qué cambio lo solucionó.
Las llamadas entrantes no llegan al asistente — el proveedor debe enviar las llamadas al FQDN SIP de la plataforma, nunca a una dirección IP directa; enviarlas a una IP es el fallo entrante más habitual. Con Provider source IPs, confirma que están introducidas todas las IP o CIDR de señalización actuales — una lista obsoleta o incompleta descarta llamadas de forma silenciosa. Después confirma que el DID coincide exactamente con lo que envía el proveedor: una troncal SIP Extension también necesita su Primary DID configurado, ya que no es un comodín.
Las transferencias de llamada por SIP REFER fallan — confirma que el proveedor de destino admite realmente SIP REFER; no todos los operadores lo hacen, y esa es la causa más habitual. Si un formato de URI falla, prueba las alternativas en orden: con el puerto (sip:+1234567890@sip-server:5060), sin el puerto y después un sip:+1234567890 a secas. Descarta también el propio destino — comprueba que el número de destino es alcanzable y no está bloqueado antes de asumir que el problema está en la troncal. Cuando se intenta una transferencia y falla, el registro de eventos de la llamada contiene call_transfer_failed o warm_transfer_failed; consulta Llamadas entrantes y salientes para conocer el patrón de fallo común.
Prueba la entrada y la salida de forma independiente — que una funcione no confirma la otra. ¿Sigues atascado? Contacta con soporte indicando el ID de la llamada, la configuración exacta de la troncal y, para problemas de transferencia, el formato de URI SIP que probaste.
API y MCP
Crea y gestiona troncales mediante la API pública (POST /api/v1/sip-trunks y los endpoints relacionados en la referencia de la API), o con las herramientas MCP create_sip_trunk, list_sip_trunks, get_sip_trunk y delete_sip_trunk. Ambas superficies admiten los mismos ajustes de cara al cliente que la interfaz, y las contraseñas nunca se devuelven.