Notificaciones

El router se revisa a sí mismo cada minuto (Alarmas y la pantalla 24/7). Con las notificaciones activadas, lo que cambió en una revisión se envía de inmediato: un mensaje por revisión y por canal, con todas las alarmas activadas y despejadas en ella.

Canal	Qué necesita	Costo
Correo electrónico	Un servidor SMTP: el de su proveedor de correo, o uno propio	Gratis
Telegram	Un bot (creado con @BotFather) agregado a su grupo de NOC	Gratis
WhatsApp	La WhatsApp Cloud API de Meta: un número de empresa, un token y una plantilla aprobada	Gratis hasta la cuota mensual de Meta, luego por mensaje
SMS	Una cuenta y un número de Twilio	Por mensaje

Configure todo con dtvsol notify …, la API o Settings → Notifications en el monitor. Las contraseñas y los tokens se guardan cifrados en el router y nunca se vuelven a mostrar.

Qué se envía

• Las alarmas críticas por defecto (agregue advertencias o informativas con dtvsol notify level).
• Cada cambio que falló en el router (vea Cambios que fallaron), sea cual sea su nivel.
• Cuando una alarma se despeja, para que nadie salga a atender un problema que ya desapareció.

Las activaciones y los despejes de una revisión van juntos, con un máximo de 15 líneas, y luego … and N more (… y N más). Un canal envía como máximo 30 mensajes por hora; el mensaje 30 lo indica, y el resto de esa hora queda en el monitor.

[DTVSOL router-1] CRITICAL: 1 alarm(s) raised, 1 cleared
CRITICAL: bond0 (uplink) is down
CLEARED: DHCP service is not running
https://XXX.XXX.XXX.10:8881/

Activarlas

dtvsol notify on
dtvsol notify level critical warning       # which levels (critical only by default)
dtvsol notify link https://XXX.XXX.XXX.10:8881/   # the monitor, at the end of each message
dtvsol notify                               # the settings, and how the last message went

dtvsol notify changes off detiene los avisos de cambios que fallaron, y dtvsol notify clears off los de despejes.

Correo electrónico

dtvsol notify email to noc@your-isp.com,boss@your-isp.com
dtvsol notify email server smtp.your-isp.com 587 starttls
dtvsol notify email user alarms@your-isp.com
dtvsol notify email password               # asked for, not echoed
dtvsol notify email on
dtvsol notify test email

• security: starttls (puerto 587, lo habitual), tls (puerto 465) o none (puerto 25, un relay dentro de su red).
• from: el remitente (dtvsol notify email from …); si no se configura, se usa el usuario de inicio de sesión.
• Gmail y Microsoft 365 piden una contraseña de aplicación, no la contraseña de la cuenta.

Telegram

1. En Telegram, hable con @BotFather, envíe /newbot y guarde el token que le entrega.
2. Agregue el bot a su grupo de NOC y envíe un mensaje en el grupo.
3. Busque el chat id del grupo: abra https://api.telegram.org/bot<token>/getUpdates en un navegador y lea "chat":{"id":-100…} (un número negativo).

dtvsol notify telegram token               # asked for, not echoed
dtvsol notify telegram chat add -1001234567890
dtvsol notify telegram on
dtvsol notify test telegram

WhatsApp

WhatsApp solo permite que una empresa inicie una conversación con una plantilla aprobada, así que el router envía cada mensaje de alarma como el único parámetro de su plantilla.

1. En Meta for Developers, cree una aplicación con WhatsApp y agregue el número de teléfono de su empresa.

2. En WhatsApp → API setup, anote el phone number ID (identificador del número de teléfono).

3. Cree un token permanente: en la configuración de Meta Business, un usuario del sistema con el permiso whatsapp_business_messaging.

4. En WhatsApp Manager, cree una plantilla de la categoría Utility (utilidad), con el nombre dtvsol_alarm (u otro), en su idioma, con un cuerpo como:

   Router alarm: {{1}}

   Espere a que Meta la apruebe.

dtvsol notify whatsapp phone-id 123456789012345
dtvsol notify whatsapp token                        # asked for, not echoed
dtvsol notify whatsapp template dtvsol_alarm es     # the template's name and language
dtvsol notify whatsapp to add +573001234567
dtvsol notify whatsapp on
dtvsol notify test whatsapp

Los números se escriben con + y el código de país. Un parámetro de WhatsApp es una sola línea, por eso las líneas de la alarma se unen con ·.

SMS (Twilio)

dtvsol notify sms sid ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
dtvsol notify sms token                   # the auth token, asked for, not echoed
dtvsol notify sms from +15005550006       # your Twilio number
dtvsol notify sms to add +573001234567
dtvsol notify sms on
dtvsol notify test sms

Un SMS lleva los primeros 480 caracteres del mensaje (hasta 3 SMS).

Cuando un canal falla

Cada canal guarda cómo le fue a su último mensaje (dtvsol notify, y el monitor). Un canal cuyo último mensaje falló es en sí mismo una alarma, Alarm notifications by telegram fail: …, que envían los demás canales. Se despeja cuando un mensaje por ese canal vuelve a funcionar, por ejemplo con dtvsol notify test telegram.

dtvsol notify telegram reset (o Forget en el monitor) elimina la configuración de un canal, incluido su token.

Seguro por diseño

• Los tokens y las contraseñas se sellan con la clave de la bóveda del router, ligada a esta máquina: una copia de la base de datos no puede abrirlos en otro lugar. La API, la CLI y el monitor nunca los muestran.
• El router envía con curl, con su configuración en un archivo privado que se elimina después de cada mensaje: ningún secreto aparece en una línea de comandos ni en la lista de procesos.
• Un servidor de correo lento nunca retiene las revisiones de alarmas: los mensajes se envían por separado.