Documentación: Nodo Llamada SIP (SIP Call)¶

Descripción General¶

El Nodo Llamada SIP (SIP Call) es un nodo de acción que realiza una llamada telefónica VoIP a través de un servidor SIP y reproduce un mensaje de audio pregrabado al contestar. Es ideal para notificaciones sonoras críticas que requieren atención inmediata del personal, incluso cuando no están frente a una pantalla.

En entornos IoT industriales, este nodo permite, por ejemplo, llamar automáticamente a la extensión del operador de turno y reproducir un aviso de voz cuando se dispara una alarma de seguridad o una falla crítica de maquinaria.

¿Cuándo usar este nodo?¶

Utiliza este nodo cuando necesites:

Alertar por voz a personal operativo ante eventos críticos (alarmas de incendio, intrusión, parada de línea).
Escalar notificaciones a un canal más intrusivo que un mensaje (una llamada telefónica difícilmente pasa desapercibida).
Reproducir avisos pregrabados a extensiones internas de la central telefónica (PBX) de la planta.
Complementar protocolos de respuesta donde se requiere confirmación humana inmediata.

Configuración del Nodo¶

El nodo cuenta con dos pestañas de configuración en la parte superior: Formulario (Form) y Editor de JSON (JSON Editor).

Configuración vacía del nodo Llamada SIP

Vista Formulario¶

1. Credenciales SIP (SIP Credentials) *Requerido¶

Selecciona la credencial (de tipo autenticación básica) con el usuario y la contraseña SIP. Las credenciales se gestionan de forma centralizada y segura (no se escriben en el nodo).

2. Extensión de Origen (From Extension) *Requerido¶

La extensión desde la cual se realiza la llamada (por ejemplo, 1001).

3. Extensión de Destino (To Extension) *Requerido¶

La extensión a la que se llama (por ejemplo, 2005).

4. Dirección del Servidor (Server Address) *Requerido¶

La dirección del servidor SIP / central telefónica (por ejemplo, sip.industrial-plant.com).

5. Puerto (Port) *Requerido¶

El puerto del servidor SIP. Valor habitual: 5060.

6. Archivo de Audio (Audio File) *Requerido¶

El archivo de audio que se reproducirá al contestar la llamada. Haz clic en Click to Upload para subir un archivo en formato .wav, .mp3 u .ogg. Una vez subido, se muestra el nombre del archivo.

Formulario configurado del nodo Llamada SIP

Vista Editor de JSON¶

En la pestaña Editor de JSON (JSON Editor) puedes visualizar y editar directamente todos los parámetros de la llamada:

Vista JSON Editor del nodo Llamada SIP

Estructura JSON (Parámetros de entrada)¶

A continuación se muestra la estructura del JSON que se genera al configurar el nodo:

{
  "to": "2005",
  "from": "1001",
  "host": "sip.industrial-plant.com",
  "port": "5060",
  "username": "",
  "password": "",
  "audioFile": ""
}

Campos del JSON¶

Campo	Tipo	Descripción
`to`	string	Extensión de destino de la llamada.
`from`	string	Extensión de origen.
`host`	string	Dirección del servidor SIP / PBX.
`port`	string	Puerto del servidor SIP (habitual `5060`).
`username` / `password`	string	Referencias a la credencial SIP seleccionada (gestionadas de forma segura).
`audioFile`	string	Nombre del archivo de audio subido que se reproducirá en la llamada.

Output: Dónde viene la data del nodo¶

Cuando la llamada se realiza correctamente, el nodo finaliza marcado como exitoso (borde verde). Su efecto principal es establecer la llamada VoIP y reproducir el audio en la extensión de destino; en caso de fallo de registro SIP o de conexión, el nodo reportará el error.

Ejemplos de uso¶

Ejemplo 1: Llamada de alerta por intrusión a la caseta de vigilancia¶

Caso de uso: Cuando un sensor perimetral detecta una intrusión fuera de horario, se llama automáticamente a la extensión de la caseta de vigilancia y se reproduce un aviso de voz pregrabado.

From Extension: 1001
To Extension: 2005
Server Address: sip.industrial-plant.com | Port: 5060
Audio File: intrusion_alert.mp3

JSON de configuración:

{
  "to": "2005",
  "from": "1001",
  "host": "sip.industrial-plant.com",
  "port": "5060",
  "audioFile": "intrusion_alert.mp3"
}

Ejemplo 2: Aviso de falla crítica de maquinaria al supervisor de turno¶

Caso de uso: Ante una parada de emergencia, se llama a la extensión del supervisor con un mensaje de voz que indica la línea afectada.

To Extension: Extensión del supervisor.
Audio File: production_line_failure.wav

Validación y errores¶

Condición	Causa / Solución habitual
Falla de registro SIP	La credencial SIP es incorrecta o la extensión de origen no está habilitada en la central.
No se establece la llamada	Revisa `host` y `port`, y que la extensión de destino exista y esté disponible.
No se reproduce el audio	Verifica que el archivo de audio se haya subido correctamente y esté en un formato soportado (.wav, .mp3, .ogg).

Buenas prácticas¶

Usar credenciales centralizadas: Selecciona una credencial SIP gestionada de forma segura en lugar de escribir usuario/contraseña.
Audios claros y breves: Graba mensajes cortos y comprensibles; en una alerta lo importante es que el mensaje se entienda de inmediato.
Reservar para eventos críticos: La llamada es un canal intrusivo; úsalo para eventos que realmente requieran atención inmediata para no generar fatiga de alertas.
Nombrar el nodo descriptivamente: Cambia el nombre del nodo en el lienzo (ej. "Llamar a vigilancia") para identificarlo en el flujo.