> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ouraicalling.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troncal SIP propia (BYO)

> Conecta tu propio proveedor SIP y usa tus números existentes

¿Ya tienes números y un proveedor SIP (Telekom, sipgate, Twilio, Telnyx, Plivo o cualquier troncal compatible con los estándares)? Conéctalos directamente: las llamadas fluyen entre tu proveedor y la infraestructura de voz de la plataforma sin portar nada.

## Lista de verificación de configuración

1. **Copia el URI SIP de la plataforma** desde **Configuración → Números de teléfono → Agregar integración SIP** (o Importar operador). Elige una **región SIP** (por defecto: global) para que la señalización entrante termine donde la necesites (por ejemplo, en la UE).
2. En tu proveedor, configura ese URI como **destino de origen/reenvío** para tus números.
3. Crea la troncal en la plataforma (formulario más abajo): autenticación entrante + terminación saliente.
4. Asigna números a los asistentes, prueba la llamada entrante y luego haz una llamada de prueba saliente.

## Tipo de troncal

| Tipo                         | Cuándo usarlo                                                                        | Números                                                                                                                                                                                                                                                           |
| ---------------------------- | ------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Número de teléfono (DID)** | La mayoría de los operadores (recomendado)                                           | Un DID E.164 en la troncal; aparece en **Números**                                                                                                                                                                                                                |
| **Extensión SIP**            | El operador envía muchos DID a una sola troncal; te autenticas con credenciales o IP | La entrante acepta cualquier DID. **DID principal** opcional para el identificador de llamada saliente: E.164 completo (`+…`) **o** dígitos nacionales sin código de país (por ejemplo, `0741926265`). Los DID principales solo nacionales no aparecen en Números |

## Entrante (recibir llamadas)

* **Tu número de teléfono (DID)**: el E.164 público que marcan tus clientes; debe coincidir con lo que el operador reenvía al URI SIP de la plataforma.
* **Autenticación entrante**
  * **Usuario/contraseña SIP** (recomendado): autenticación digest.
  * **IP de origen del proveedor**: solo si el operador no puede usar digest y publica IP/CIDR de origen SIP estables. No uses rangos demasiado amplios.
* En el proveedor: reenvía u origina hacia el URI SIP de la plataforma que copiaste.

Las llamadas entrantes se asignan al asistente que configures, igual que con los números del marketplace.

## Saliente (llamadas salientes)

* **Dirección de terminación**: solo el host SIP del proveedor (por ejemplo, `sip.telnyx.com`). Sin prefijo `sip:` ni puerto.
* **Transporte** — `AUTO` (recomendado), `UDP`, `TCP` o `TLS`. El enlace troncal seguro siempre usa TLS.
* **Región de salida**: desde dónde origina la llamada la plataforma. Prefiere **Automático**, o el país más cercano a tus clientes o al POP del operador.
* **Formato del número de llamada saliente**: cómo se envía el número FROM al operador. Debe coincidir con la configuración del operador (por ejemplo, el formato de número de origen de Telnyx):
  * Internacional con `+` (recomendado para la mayoría)
  * Internacional sin `+`
  * Nacional (sin código de país)
* **Credenciales**
  * **Compartidas** (recomendado): un mismo usuario/contraseña para entrante y saliente.
  * **Separadas**: credenciales distintas para entrante y saliente cuando el operador lo exige.
* **Autenticación saliente**: usuario/contraseña (recomendado). La plataforma **no tiene IP salientes estáticas**, así que las listas blancas de IP del operador normalmente fallan. Usa "sin credenciales" solo si el operador permite explícitamente tráfico saliente sin autenticar.

Las llamadas salientes y las campañas podrán usar entonces tu troncal y tus identificadores de llamada.

## Avanzado

Despliega **Avanzado** al crear o editar una troncal BYO:

| Ajuste                                     | Significado                                                                 | Recomendación                                                                                                                                                       |
| ------------------------------------------ | --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Troncal seguro (TLS + SRTP)**            | Señalización y medios cifrados                                              | Actívalo cuando el operador admita Secure Trunking / TLS+SRTP                                                                                                       |
| **Cifrado de medios**                      | Permitir (con preferencia por SRTP) o Exigir SRTP                           | Deja Permitir salvo que el cumplimiento normativo exija Exigir                                                                                                      |
| **Encabezados salientes personalizados**   | X-\* en los INVITE salientes (máx. 10)                                      | Vacío salvo que la documentación del operador exija un encabezado                                                                                                   |
| **Encabezados entrantes (200 OK)**         | X-\* personalizados en el 200 OK de SIP                                     | Normalmente vacío                                                                                                                                                   |
| **Mapas de encabezado → atributo**         | Convierte encabezados SIP en atributos de llamada para agentes/herramientas | Solo si necesitas metadatos del operador                                                                                                                            |
| **Incluir encabezados SIP como atributos** | Ninguno / todos los X-\* / todos los encabezados                            | **Ninguno** (mapea solo lo que necesites)                                                                                                                           |
| **Codecs de medios**                       | Codecs SDP adicionales (PCMU, PCMA, G.722, AMR-WB)                          | Deja los valores predeterminados de la plataforma; añade AMR-WB solo si es necesario. Evita "Solo codecs listados" a menos que conozcas los codecs del otro extremo |
| **Timeouts de medios/timbrado**            | Anulaciones opcionales (en segundos)                                        | Déjalo vacío (valores predeterminados de la plataforma) salvo que estés depurando un problema                                                                       |

**HD Voice (G.722):** actívalo en la configuración de conexión/codec de **Telnyx** cuando lo necesites (compatible con Telnyx, no con Twilio).

## Editar más tarde

Las troncales existentes se editan desde **Números → Configurar → Ajustes del operador** (no desde una lista de troncales separada en Agregar integración SIP).

## Enrutamiento en la UE

Para clientes de la UE, el tráfico SIP puede terminar en el **endpoint SIP fijado a la UE** de la plataforma, manteniendo los medios y la señalización dentro de la UE — algo relevante para la documentación de RGPD. El procesamiento de medios/agente se ejecuta en Fráncfort (eu-central).

## Límites y comportamiento

* Los números E.164 en troncales BYO cuentan para el mismo límite del plan que los números comprados (`max_own_numbers`).
* 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](/billing/minutes).
* Todas las funciones del asistente — flows, transferencia asistida, grabación, monitorización — funcionan igual en las troncales BYO.

## API

Crea y gestiona troncales mediante la API pública (`POST /sip-trunks` y los endpoints relacionados en la referencia de la API). Al crear una troncal se aceptan los mismos campos que en la interfaz (`trunk_kind`, `calling_number_format`, `transport`, los mapas de Avanzado, etc.); las contraseñas nunca se devuelven.

<Tip>
  Prueba primero la entrante: llama a uno de tus números y comprueba que aparece en **Llamadas** con el asistente correcto. Luego verifica la saliente con una única llamada de prueba antes de conectar la troncal a las campañas.
</Tip>
