Módulo 13 · Troncales BYOC

Read in English: Module 13 · BYOC trunks.

Objetivo: dar de alta y aprovisionar tu troncal SIP BYOC, limitar sus destinos, compartirla con todas tus sedes, distinguirla de las líneas de la plataforma y entender su salud y su historial de eventos. Tiempo: ~8 minutos · Necesitas: un usuario con permisos para gestionar troncales y los datos de tu proveedor SIP (el proxy y las IPs desde las que te envía llamadas).

1. Dar de alta tu troncal BYOC

En el menú entra a Troncales y operadores; la pantalla se titula Troncales SIP (operadores). Pulsa + Añadir troncal y rellena:

• Nombre: el que quieras para reconocerla.
• Tipo: BYOC (client trunk), para tu propio proveedor. Aquí sólo se dan de alta troncales BYOC; las líneas de la plataforma no las añades tú (sección 5).
• Ámbito: Sede (la usa esa sede) o Empresa (compartida) (sección 3).
• Proxy SIP: la dirección de tu proveedor, con el formato del ejemplo sip:proxy.example:5060. Es hacia donde salen tus llamadas.
• IPs de origen (ACL de entrada BYOC): las direcciones IP desde las que tu proveedor te envía las llamadas entrantes.

Pulsa Guardar. Tu troncal se autentica por IP: la plataforma reconoce a tu proveedor por las IPs de origen que declaras. No hay un modo de registro con usuario y contraseña. Cada IP pertenece a una sola troncal en toda la plataforma; si ya está asignada a otra, el alta se rechaza. Una lista vacía es válida, pero esa troncal sólo cursa llamadas de salida.

Guardar sólo anota la troncal. Para que empiece a trabajar hay que aprovisionarla.

Cifrar el audio (SRTP)

Por defecto el audio entre la plataforma y tu proveedor viaja como RTP en claro. Si tu proveedor admite SRTP, la troncal puede cifrarlo: el campo srtp toma off (por defecto), offer (la plataforma ofrece SRTP y acepta RTP en claro si tu proveedor contesta sin él) o require (rechaza una respuesta que no sea SRTP). offer y require exigen un proxy SIP TLS (sips: o ;transport=tls); con un proxy en claro la plataforma responde 400. La consola todavía no muestra este campo y después no se puede editar: fíjalo por la API al crear la troncal, como se explica en Troncales BYOC: SRTP.

2. Aprovisionar y revocar

En la fila de tu troncal BYOC, en Acciones, pulsa Aprovisionar: la plataforma escribe la troncal en el borde SIP y activa su ACL de entrada. La pantalla confirma con «Aprovisionado en el borde SIP.». Si en tu entorno no hay un borde SIP en vivo, dice «Guardado — no hay borde SIP en vivo configurado, así que no se envió.» y no ha pasado nada al borde.

Tras el alta no se editan en sitio ni el proxy SIP, ni las IPs de origen, ni el ámbito. Para cambiarlos, Revoca la troncal y da de alta otra. Revocar es definitivo: retira la ACL de entrada, la troncal no se puede volver a aprovisionar y sus IPs quedan libres para otra troncal.

Por la API

Es lo mismo que POST /v1/carriers, POST /v1/carriers/{id}/provision y POST /v1/carriers/{id}/revoke. Mira la referencia de la API.

3. La troncal de empresa que heredan las sedes

Con ámbito Empresa (compartida), la troncal la comparten todas las sedes de la cuenta. Sirve para tener un único proveedor para toda la empresa:

• Salida: cada sede que no tenga una troncal BYOC propia activa sale por la de la empresa. Si una sede tiene la suya, gana la de la sede.
• Entrada: las IPs de origen de una troncal de empresa entregan llamadas a los números de cualquier sede de la empresa. La IP identifica tu cuenta, no la sede; la sede que recibe la llamada la decide el número marcado, y ese número debe tener una ruta de entrada activa. Un número de otra cuenta o una IP que no reconocemos se rechaza en el borde SIP.

Crear, cambiar o revocar una troncal de empresa afecta a todas las sedes, por eso exige un usuario administrador de la cuenta; un usuario sin ese rol recibe un error de permisos. Una troncal de sede, y su provision y revoke, también rechazan a un miembro común (403 role_forbidden por la API); un administrador de la cuenta o una clave de integración sí pueden.

4. La lista blanca de destinos

Una troncal BYOC puede declarar una lista de números a los que se permite llamar, para cuentas que nunca deben llegar a nadie más: una cuenta de pruebas, o la prueba de un prospecto que sólo puede llamar a los números que él confirmó como propios. Sin lista no cambia nada.

• Son números exactos en formato E.164 (+ y dígitos), hasta 100, sin duplicados.
• Se declara al dar de alta la troncal o después, y cada cambio reemplaza la lista entera; una lista vacía la quita. Hoy se gestiona por la API (allowed_destinations en POST /v1/carriers y PATCH /v1/carriers/{id}): la pantalla de troncales no tiene un control para ella.
• Limita a la sede entera, no a una troncal: cuentan las llamadas de campaña (reintentos y devoluciones incluidos), las manuales y de vista previa, y la pierna de salida de una transferencia a un número externo. Si varias troncales BYOC de la sede declaran lista, el número tiene que estar en cada una.
• Si no se puede leer la lista, la llamada se rechaza como si el número estuviera fuera.

Un destino fuera de la lista no se marca: se registra como bloqueo por política de la cuenta (tenant_policy). La lista protege contra marcar por error, no contra tu propio administrador: quien puede gestionar la troncal puede quitarla. Los detalles están en la guía de la API REST.

5. Las líneas de la plataforma

Las líneas de la plataforma son las troncales de la casa (en la lista, la columna Tipo dice house): llamas por nuestras troncales en lugar de las de tu proveedor. No las das de alta tú: las opera DialerDigital y el formulario no las ofrece. Si tu cuenta ya tiene una, sigue apareciendo en la lista. No tienen IPs que declarar ni se aprovisionan; en la columna de salud aparece «No es una troncal BYOC» y en Acciones, «Despachada por LCR»: nosotros elegimos la ruta de menor costo.

Se cobran distinto a BYOC. Con BYOC, tu proveedor te factura sus minutos y nosotros no los revendemos. Con las líneas de la plataforma medimos los minutos de salida y los cobramos a la tarifa publicada: primero salen de la bolsa de Minutos de voz de tu plan y, cuando se agota, de tu saldo. El Módulo 7 lo detalla.

6. La salud de la troncal

En el modelo BYOC (Bring Your Own Carrier), las llamadas salen y entran por tu propio proveedor SIP. Para que esto funcione de forma confiable, la plataforma puede vigilar el estado (salud) de cada troncal BYOC conectada; si el chip no muestra datos, pide a soporte que active la vigilancia en tu cuenta.

En la barra lateral y en la lista de troncales, verás un indicador ("chip") que muestra la salud en tiempo real de tu troncal BYOC. Los estados posibles son:

• Disponible (Up): la troncal está respondiendo correctamente a los sondeos de tráfico o mensajes de opciones (probes). Las llamadas pueden enrutarse hacia ella de manera normal.
• Caída (Down): la troncal dejó de responder o está devolviendo errores a los sondeos. Hoy el estado es informativo: la plataforma te avisa, pero no deja de enrutar llamadas a esa troncal por sí sola.
• Desconocido (Unknown): ocurre si la lectura de salud caducó (ya no es "fresca") porque el proveedor dejó de enviar señales o el sondeo no pudo completar su ciclo.

7. Historial de salud de la troncal

Cada cambio en la salud de una troncal queda registrado. Puedes consultar este registro para diagnosticar a qué hora tu operador telefónico tuvo una intermitencia y cuánto tardó en volver.

En la vista de la troncal BYOC, la tabla Historial de salud (Health History) muestra los eventos recientes, desde el más nuevo al más antiguo. Cada fila indica:

• Observado: el instante exacto en el que la plataforma observó el cambio (en tu zona horaria local).
• Cambio (Change): la transición que ocurrió, por ejemplo, Disponible → Caída (up → down), o Desconocido → Disponible (unknown → up).
• Causa: la explicación técnica del cambio, como pérdida de latencia, fallos en la respuesta SIP u otras razones reportadas por el núcleo de telecomunicaciones.

Este historial es una herramienta de evidencia valiosa: si notas llamadas fallidas en tu sistema, la tabla te ayudará a confirmar si tu proveedor SIP experimentó una caída exacta en ese momento.

8. Capacidad y saldo: qué limita una llamada BYOC

Tu operador telefónico te factura sus propios minutos, pero la llamada sigue pasando por nuestros servidores de medios, así que una llamada BYOC no queda sin medir.

• El techo cuando no tienes uno. Si tu cuenta no tiene un techo de capacidad propio, tu marcación BYOC se mide como si tuviera 100 llamadas simultáneas y 20 llamadas por segundo. Cada cifra rige solo donde tu cuenta no declara una, y un techo que tu cuenta sí tenga manda siempre, incluso uno mayor (con 500 simultáneas declaradas, pasan 500). El techo de tu cuenta lo fija Dialer Digital; la consola no tiene un control para él.
• Un carril propio. Mientras el techo es ese supuesto, tus llamadas BYOC se cuentan aparte de las de tus líneas de la plataforma: las llamadas por líneas de la plataforma nunca ocupan plazas BYOC, ni al revés.
• Qué ves al alcanzarlo. La llamada simultánea 101 no se marca, ni tampoco la 21 iniciada en el mismo segundo. La campaña muestra el motivo tenant_channels o tenant_cps (ver la tabla de frenos), sigue running y vuelve a marcar en cuanto hay hueco.
• IA de voz por tu propia troncal. Los minutos de tu operador telefónico no son nuestros, pero la IA de la llamada (voz a texto, modelo de lenguaje, texto a voz) sí, así que una llamada de IA de voz por una troncal BYOC retiene saldo solo por la IA, nunca por el operador telefónico. En prepago, la retención es la tarifa de IA por la ventana de la llamada: sin saldo la llamada no se marca (wallet_insufficient). En suscripción cuenta solo tu bolsa de Voice AI, no la de minutos de voz; agotada, el exceso sale de tu saldo, como en el Módulo 7. En pospago, el crédito que ya tienes es el techo (plan_exhausted cuando se agota). Esa llamada también se mide contra el techo del plan, 20 llamadas simultáneas en una cuenta de suscripción o pospago, en lugar del de 100 / 20 de arriba; el prepago no tiene más límite que su retención.
• Una llamada BYOC sin IA no retiene nada. Solo se topa con el techo de arriba.

Las cifras y el código que respalda cada una están en la guía de la API REST.