Gateway PBX SIGNOS — SBC Local Instalable
Módulo instalable localmente por el cliente (Session Border Controller & Gateway) para interconectar centrales telefónicas privadas (FreePBX, Asterisk, 3CX, Cisco) y proveedores SIP directamente con la nube de SIGNOS.
¿Por qué instalar el Gateway PBX Local? Muchas centrales SIP o redes privadas corporativas se encuentran detrás de cortafuegos o NAT sin salida pública directa. El Gateway PBX SIGNOS actúa como SBC ligero en tu red local, enlazando el audio y la señalización hacia la plataforma omnicanal mediante WebSockets y túneles seguros (Ngrok).
1. Arquitectura y Puertos
El módulo corre en Node.js de manera autónoma en cualquier servidor (Linux, Windows Server o Docker) dentro de la misma red de su central telefónica.
Puerto 3456
Interfaz Web de Administración Local y API de configuración (Admin User/Pass).
Puerto 3457
Servidor Operativo Outbound y Webhooks para enrutar señalización saliente.
Puerto 5080 (SIP)
Receptor SIP Engine UDP/TCP para recibir llamadas desde su FreePBX o Trunk.
2. Instalación Paso a Paso
- Descargar y preparar el entorno: Requiere Node.js v18 o superior instalado en el servidor local.
cd signospbx-int npm install - Configuración inicial (config.json): Duplique
config.default.jsoncomoconfig.jsony configure su Trunk:{ "server": { "port": 3456, "outboundPort": 3457, "adminUser": "admin", "adminPass": "secreto" }, "trunks": [ { "id": "trunk-local-1", "name": "Central FreePBX Oficina", "sipPort": 5080, "allowedIps": "127.0.0.1, 192.168.1.100", "status": "enabled", "signos": { "instanceId": "TU_INSTANCE_ID", "integrationId": "TU_INTEGRATION_ID", "webhookUrl": "https://[tu-dominio-cloudfunctions]/sipWebhook" }, "pbx": { "providerName": "FreePBX Local", "host": "192.168.1.100", "port": 5060, "outboundPrefix": "9" } } ] } - Inicie el Gateway PBX:
Acceda al panel de administración web ingresando en su navegador anpm starthttp://localhost:3456.
3. Configuración en FreePBX / Asterisk
En su central telefónica local, cree una troncal (Trunk SIP PJSIP o CHAN_SIP) apuntando a la IP de la máquina donde corre el Gateway y al puerto 5080.
- Host de Destino: IP del servidor Gateway PBX (ej:
192.168.1.50:5080). - Rutas Salientes (Outbound Routes): Enrute las llamadas dirigidas a extensiones o IVRs conversacionales de IA por esta troncal.
4. Diagnóstico y Solución de Problemas (Soporte)
| Síntoma | Causa / Solución |
|---|---|
| Rechazo 403 Forbidden al llamar | La IP de la central no coincide con allowedIps en config.json. Agréguela a la lista blanca. |
| Audio unidireccional o sin voz | Verifique la apertura de puertos RTP o active la opción de túnel en la configuración del Trunk. |