Notificaciones SMS

Los SMS llegan a personas que están lejos de una pantalla. Como cada mensaje cuesta dinero, Hermetry envía SMS solo donde indiques números de teléfono explícitamente, y limita los reenvíos repetidos.

Qué envía SMS

Emisor	¿SMS?
Un bloque Notify de un flujo con filas de destinatario de tipo `phone`	Sí
Reglas de alarma	No: nombran miembros, roles y direcciones de correo electrónico. Usa un flujo para enviar un SMS de una alarma (más abajo).
Informar a personas de la tarjeta de reglas	No: nombra roles (y, a través de la API, usuarios y equipos).
Miembros y roles en cualquier emisor	No: el número de teléfono de un miembro no se usa para las notificaciones.

Los códigos de inicio de sesión por SMS, cuando tu organización los use, los envía el propio inicio de sesión, no estos ajustes.

Configurar SMS

Un administrador abre Ajustes > SMS («Configuración del proveedor de SMS»):

Campo	Significado
Habilitar notificaciones SMS	Activa o desactiva los SMS para la organización. Desactivado: no se envía ningún SMS, ni siquiera para alarmas críticas.
Proveedor	El proveedor de SMS, con sus campos de cuenta (id de cuenta, token, número o nombre del emisor).
Proveedores de SMS	Más proveedores, instalados y configurados como plugins desde el marketplace.

Para cambiar los ajustes se necesita Cambiar ajustes de SMS (Admin por defecto). Si el proveedor elegido no tiene credenciales, Hermetry usa el primer proveedor configurado para tu organización.

Números de teléfono

Escribe los números en formato internacional, por ejemplo +905551112233 o +4915112345678.
Un número que no se puede interpretar se cuenta como no válido en el resultado del bloque y se omite; los demás destinatarios sí reciben el mensaje.
Un número que se ha dado de baja (respondiendo STOP, cuando tu proveedor reenvía las respuestas) no recibe envíos hasta que vuelva a darse de alta (START).

Enviar un SMS desde una alarma

Cada cambio de alarma también entra en los flujos del host de IoT como un mensaje de tipo alarm, con la alarma en msg.payload. Un flujo que escucha estos mensajes puede quedarse con los que te interesen (por ejemplo, nuevas alarmas CRITICAL) y pasarlos a un bloque Notify con una fila phone como +905551112233, un título como {{ msg.payload.title }} y channels con el valor ["sms"].

Consulta Bloques de alarma, comando y notificación y Recetario de flujos.

Límites y restricciones

Regla	Efecto
Por número	Los mensajes adicionales al mismo número dentro de 60 segundos se descartan.
Pausa de notificación	El bloque Notify envía el mismo motivo al mismo destinatario una vez por periodo de pausa (10 minutos salvo que tu plan defina otro); el siguiente mensaje incluye «(+n)» por los retenidos.
Horas de silencio	Los SMS se retienen durante las horas de silencio de la organización, en la zona horaria del destinatario, salvo que la notificación sea crítica. Un destinatario solo con número no tiene zona horaria; se usa UTC.
Cuota mensual	Cada SMS cuenta para la cuota de SMS de tu plan (contador de uso `smsSends`).

Cuota

Cuando se agota la cuota mensual de SMS, o el plan no incluye SMS, el bloque Notify de un flujo omite los SMS, los indica bajo quota en su resultado («la cuota mensual de SMS está agotada» o «el plan no tiene acceso a SMS») y sigue usando los demás canales. Solo cuando todos los canales que usaría están sin cuota, el bloque termina con el error limit. Consulta Uso y cuotas.

Qué contiene el mensaje

El cuerpo del SMS es el texto de la notificación (su forma de texto plano para notificaciones HTML). Mantén los textos de alarma breves: el proveedor puede dividir o truncar los mensajes largos.

Solución de problemas

Síntoma	Comprobar
No llega ningún SMS	Habilitar notificaciones SMS está activado; hay un proveedor configurado; tu plan incluye SMS; la cuota no está agotada.
Un número no recibe nada	El número está en formato internacional; no se ha dado de baja; horas de silencio; la restricción de 60 segundos por número.
Los SMS de alarma nunca se envían	Las reglas de alarma no envían SMS; añade un flujo con un destinatario `phone`.
Faltan todos los demás mensajes	La pausa retiene los repetidos del mismo motivo; define el ajuste `reason` del bloque para agruparlos como prefieras.

El registro de envíos guarda cada intento de SMS con la respuesta del proveedor. Consulta El registro de notificaciones.