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

  1. Descargar y preparar el entorno: Requiere Node.js v18 o superior instalado en el servidor local.
    cd signospbx-int
    npm install
  2. Configuración inicial (config.json): Duplique config.default.json como config.json y 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"
          }
        }
      ]
    }
  3. Inicie el Gateway PBX:
    npm start
    Acceda al panel de administración web ingresando en su navegador a http://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íntomaCausa / Solución
Rechazo 403 Forbidden al llamarLa IP de la central no coincide con allowedIps en config.json. Agréguela a la lista blanca.
Audio unidireccional o sin vozVerifique la apertura de puertos RTP o active la opción de túnel en la configuración del Trunk.