Configurar Troncal SIP

Configuración de Troncales SIP en Issabel PBX

Objetivo

Configurar una troncal SIP (Trunk SIP) en Issabel PBX para establecer un enlace virtual con un proveedor de telefonía VoIP o con otra central telefónica remota, permitiendo así realizar y recibir llamadas externas a través de internet.

 

¿Qué ocurre cuando se aplica?

Al configurar y registrar exitosamente una troncal SIP, la central Issabel PBX se conecta al proveedor de VoIP, logrando lo siguiente:

  1. Habilitación de Llamadas Externas: El PBX adquiere la capacidad de enrutar llamadas desde las extensiones internas hacia números de la red telefónica pública (PSTN), utilizando las Rutas Salientes.

  2. Recepción de Llamadas Entrantes: El sistema puede recibir llamadas desde números externos y dirigirlas a destinos internos (como IVRs, colas, extensiones, etc.) mediante la configuración de Rutas Entrantes.

  3. Registro y Autenticación: Issabel se autentica con el servidor del proveedor, manteniendo una conexión persistente que asegura la disponibilidad del servicio. El estado de la troncal se puede monitorear para verificar que esté en línea y operativa.

En resumen, la troncal SIP actúa como el puente que conecta el sistema telefónico interno de la empresa con el mundo exterior.

 

Requisitos

Antes de comenzar, es indispensable contar con la siguiente información, la cual debe ser proporcionada por tu proveedor de telefonía SIP:

  • Acceso al Servidor Issabel: Credenciales de administrador para la interfaz web.

  • Datos de Autenticación de la Troncal:

    • Host: La dirección IP o dominio del servidor SIP del proveedor.

    • Username: El nombre de usuario para la autenticación.

    • Secret: La contraseña de la troncal.

    • From Domain (Opcional): El dominio del proveedor, si lo requiere.

  • Información de Red (si aplica):

    • Saber si el servidor Issabel está detrás de un firewall con NAT.

    • Tener abiertos los puertos necesarios en el firewall (generalmente 5060 UDP para SIP y el rango 10000-20000 UDP para el audio RTP).

 

 ¿Qué es una Troncal SIP?

Una troncal SIP (Session Initiation Protocol) es un enlace virtual que conecta tu PBX con:

  • Un proveedor de VoIP (SIP trunk provider)

  • Otra central PBX remota

  • Sucursales u oficinas

Te permite realizar y recibir llamadas a través de Internet utilizando VoIP.

 

 Parámetros Básicos

Los datos comunes que tu proveedor SIP te entregará son:

Parámetro Descripción
host Dirección del servidor SIP
username Usuario SIP
secret Contraseña de autenticación
fromdomain Dominio del proveedor (opcional)
context Contexto de llamadas entrantes (from-trunk)
codecs Formatos de audio soportados (ulaw, alaw)
nat Habilitar si estás detrás de NAT/firewall
 

 

 Paso a Paso para Configurar la Troncal SIP

 Accede a la Administración de Troncales

  • Ir a:
    PBX > PBX Configuration > Trunks

 Agrega una Nueva Troncal

  • Haz clic en Add Trunk

  • Elige el tipo según la tecnología del proveedor:

    • Add SIP Trunk (chan_sip)

    • Add PJSIP Trunk (recomendado si tu proveedor lo soporta)

 Configura la Troncal

 Detalles Generales

plaintext
Copiar código
Trunk Name: Proveedor_SIP Outbound Caller ID: 123456789

 PEER Details (Ejemplo para chan_sip)

ini
Copiar código
type=peer host=sip.proveedor.com username=miusuario secret=miclave fromuser=miusuario fromdomain=sip.proveedor.com trustrpid=yes sendrpid=pai insecure=invite,port qualify=yes nat=yes context=from-trunk disallow=all allow=ulaw,alaw

 Registration String (si es requerido)

plaintext
Copiar código
miusuario:miclave@sip.proveedor.co

 USER Details

Generalmente se deja vacío, salvo que el proveedor requiera autenticación doble.

 Rutas de Entrada y Salida

➤ Outbound Routes (llamadas salientes):

  • Define patrones de marcado (ej. 9|. para marcar con prefijo 9)

  • Asocia esta troncal como preferida

➤ Inbound Routes (llamadas entrantes):

  • Asocia DID (números entrantes) con IVRs, colas, extensiones, etc.

 Guardar y Aplicar

  • Haz clic en Submit

  • Luego clic en Apply Config (esquina superior)

 Diagnóstico y Solución de Problemas

 Problemas de Registro

  • Comando útil:

    nginx
    Copiar código
    asterisk -rvvv sip show registry # Para chan_sip pjsip show registrations # Para pjsip
  • Verifica:

    • Usuario y contraseña correctos

    • Dirección del servidor

    • Conectividad a Internet/salida SIP permitida

 Problemas de Audio

  • Causa común: problemas de NAT

  • Asegúrate de tener correctamente configurado:

    • nat=yes

    • IP pública en externip= si es necesario (o habilita STUN si lo soporta)

    • Firewall/puertos abiertos (5060 UDP y RTP 10000–20000)

 Problemas de Autenticación

  • Verifica fromuser, username, secret

  • Asegúrate de tener insecure=invite,port si el proveedor lo requiere

 Llamadas No Completadas

  • Revisa que las Outbound Routes incluyan el patrón adecuado

  • Verifica que la troncal esté asociada correctamente

 Consejos Avanzados

  • Usa PJSIP si estás comenzando desde cero, ya que es la tecnología recomendada a largo plazo.

  • Monitorea las troncales desde:

    nginx
    Copiar código
    sip show peers # chan_sip pjsip show endpoints # pjsip
  • Habilita la grabación de llamadas o logs detallados para identificar causas en tiempo real.

 Plantilla Rápida de PEER Details (para copiar y pegar)

ini
Copiar código
type=peer host=sip.proveedor.com username=usuario123 secret=clave123 fromuser=usuario123 fromdomain=sip.proveedor.com qualify=yes nat=yes context=from-trunk disallow=all allow=ulaw,alaw,g729
 

¿Te gustaría que convierta esta guía en un archivo PDF o en un formato editable (Word, Google Docs, Markdown)? También puedo ayudarte a crear una plantilla para proveedores específicos (como Twilio, GoIP, Zadarma, etc.).