Estos bloques actúan sobre personas y dispositivos: abren y cierran alarmas, envían comandos, responden a las peticiones propias de un dispositivo y envían notificaciones. Los bloques de alarma y de comando necesitan un mensaje cuyo originador sea un dispositivo; Notify funciona con cualquier mensaje.
Raise alarm
Abre una alarma en el dispositivo del mensaje, o actualiza la abierta del mismo tipo: una alarma abierta por dispositivo y tipo.
| Ajuste | Significado | Predeterminado | Valores |
|---|---|---|---|
| alarm | El tipo de alarma | obligatorio | una plantilla, p. ej. tank.{{ msg.metadata.topic }}.low; letras, dígitos, _ . : -, como máximo 128 tras la generación |
| severity | Gravedad | warning | critical, major, minor, warning, info |
| text | Título | el tipo | una plantilla, como máximo 256 caracteres |
| value | Se guarda en los detalles de la alarma | msg.payload | una ruta |
| notify_to | Quién es informado | nadie | ids de usuario, direcciones de correo, los roles OWNER, ADMIN, USER |
| notify_channels | Canales | elección de cada persona | ids de canal como inapp, mail |
| notify_min_severity | Informar solo desde esta gravedad | info | una gravedad |
| notify_repeat_sec | Recordar mientras esté abierta y sin reconocer | sin recordatorio | 0, o 60 segundos o más |
out: la alarma (msgType alarm, la alarma en msg.payload). Errores: not_a_device, bad_alarm_id. Las notificaciones siguen el mismo ciclo de vida que las reglas de alarma: limitación, un resumen en una tormenta de alarmas, las alarmas críticas se saltan las preferencias personales salvo que su organización lo haya desactivado. Una escalada vuelve a notificar; una nueva activación con la misma gravedad no. Un mensaje tardío no cambia ninguna alarma. Consulte Alarm notifications in depth.
Clear alarm
Resuelve la alarma abierta de un tipo en el dispositivo del mensaje.
| Ajuste | Significado | Valores |
|---|---|---|
| alarm | El tipo de alarma | obligatorio, una plantilla |
out: la alarma resuelta, o el mensaje sin cambios si no había ninguna abierta. Quienes fueron informados de la alarma reciben aviso de que se resolvió.
Acknowledge alarm
Reconoce las alarmas abiertas del dispositivo: siguen abiertas, los recordatorios se detienen.
| Ajuste | Significado | Predeterminado | Valores |
|---|---|---|---|
| alarm | Qué alarmas | todas las alarmas abiertas | *, un tipo, o un prefijo que termina en * |
| min_severity | Solo desde esta gravedad | info | una gravedad |
| note | Una nota en la cronología de cada alarma | ninguna | como máximo 256 caracteres |
Los tres bloques de alarma producen alarmas exactamente como lo hacen las reglas de alarma. Un cambio de alarma que hacen es recibido por los disparadores de Device message que escuchan alarm; un flujo que activa una alarma y también escucha alarmas puede volver a iniciarse a sí mismo, y el despliegue advierte «May start its own flow again». Consulte Working with alarms.
Send command
Envía un comando de la lista de comandos del perfil de dispositivo al dispositivo del mensaje. No hay espera: el mensaje continúa con la petición realizada; la respuesta del dispositivo llega más tarde.
| Ajuste | Significado | Predeterminado | Valores |
|---|---|---|---|
| command | Un comando de la lista de comandos del perfil | obligatorio (o un method sin procesar) | elegido de los comandos de sus perfiles |
| params | Los parámetros del comando | ninguno | un objeto como {"on": true}, o una ruta como msg.payload |
| method | Un method sin procesar fuera de la lista de comandos | vacío | namespace.verb, como máximo 64 caracteres |
out: el mensaje con msg.metadata.rpcId (la petición, también en la pestaña Commands del dispositivo) y msg.metadata.rpcStatus (QUEUED, o FAILED cuando el comando no pudo esperar y el dispositivo estaba desconectado). Errores (no se hizo ninguna petición):
| Código | Significado |
|---|---|
not_a_device, device_not_found | No es uno de sus dispositivos |
unknown_command | El perfil del dispositivo no tiene ese comando |
bad_params | Los parámetros no coinciden con el comando (msg.error.param indica cuál) |
method_refused | Un factory reset, el emparejamiento o olvidar la red nunca se envían desde la nube |
limit | Demasiados comandos a este dispositivo en el último minuto (30 por defecto desde flujos) |
device_not_active, rpc_not_supported_by_profile, payload_too_large | Tal como lo mostraría la consola |
- El comando se busca en el perfil del dispositivo de cada mensaje: un flujo que atiende varios perfiles envía solo a aquellos cuyo perfil tiene el comando.
- La petición se hace como el flujo y aparece en el historial de comandos del dispositivo, como una enviada desde la consola. Un comando de alto impacto no requiere confirmación al ejecutarse: se confirmó al desplegar.
- Desplegar necesita el permiso de envío del nivel del comando en cada perfil que lo tenga, Deploy flows with control-level nodes para un comando de alto impacto, y el permiso de RPC sin procesar para un method sin procesar.
- Un mensaje repetido o reenviado encuentra la petición que ya hizo y no envía nada de nuevo. Un mensaje tardío no envía ningún comando.
- Cada petición termina con un mensaje
rpc_response(SUCCESSFUL,FAILED,TIMEOUT,EXPIRED,CANCELLED) conmsg.metadata.rpcStatus,rpcIdyrequestedBy. Es un mensaje de dispositivo, así que llega al flujo raíz del dispositivo; enrútelo desde allí.
Answer device request
Responde a una petición que el dispositivo envió a la plataforma (un mensaje rpc_request: el dispositivo llama a un método en la nube). Los métodos integrados getCurrentTime y getSessionLimits se responden antes de que un flujo vea nada.
| Ajuste | Significado | Predeterminado | Valores |
|---|---|---|---|
| result | Lo que devuelve el método | msg.payload | cualquier valor; se envía como {"ok": true, "result": …} |
| error | Rechazar en su lugar | ninguno | unsupported_method, bad_params, busy, timeout, expired, forbidden, payload_too_large, internal; se envía como {"ok": false, "error": …} |
| message | Texto enviado con un rechazo | vacío | como máximo 256 caracteres, se admiten plantillas |
Gana la primera respuesta. Cuando ningún flujo responde en 5 segundos, la plataforma responde unsupported_method. Errores: rpc_request_closed, not_an_rpc_request, payload_too_large, invalid_value. Un dispositivo MQTT recibe la respuesta en v1/rpc/up/res/{id}, un dispositivo HTTP en su petición en espera. Coloque este bloque en la rama rpc_request del flujo raíz (el raíz por defecto solo registra estas peticiones).
Notify
Envía una notificación y pasa el mensaje al siguiente bloque.
| Ajuste | Significado | Predeterminado | Valores |
|---|---|---|---|
| Recipients | Filas de un Kind y un valor | obligatorio | como máximo 20 filas; 20 destinatarios tras la expansión |
| Repeat reason | Lo que hace que dos notificaciones sean «la misma» para el periodo de espera | las palabras de la notificación | plantilla, 200 caracteres |
| Channels | Restringir a estos canales | las preferencias de cada destinatario | ids de canal como inapp, mail, sms, push |
| Urgency | critical se salta las preferencias personales salvo que su organización lo haya desactivado | normal | normal, critical |
| Title, Text | El mensaje | plantillas, 200 y 4.000 caracteres | |
| Text format | text, o html para correo | text | text, html |
| Mail subject, Reply to | Opciones de correo | el título, ninguno | plantillas |
| Copy, Hidden copy | Más destinatarios de correo; cada uno recibe su propio correo | ninguno | plantillas |
| Mail attachments | Archivos para el correo | ninguno | 10 archivos, 1 MiB en total |
Quién es alcanzado, por qué canal
| Kind | Value | Alcanza a |
|---|---|---|
user | El id de usuario de un miembro | Ese miembro, en la aplicación, por push y en las aplicaciones de chat vinculadas |
role | OWNER, ADMIN o USER | Cada miembro activo con ese rol, como arriba |
custom_role | Una clave de rol personalizado | Sus miembros, como arriba |
team | Un id de equipo | Sus miembros, como arriba |
originator_owner | Vacío | Los propietarios del originador del mensaje, cuando un módulo los declara, como arriba |
address | una o más direcciones de correo, separadas por comas | |
phone | uno o más números en formato internacional, separados por comas | SMS |
Los miembros se indican solo por su id de usuario. El correo electrónico y los SMS llegan solo a las filas address y phone. Un miembro listado como user, o alcanzado a través de un rol, rol personalizado o equipo, recibe la notificación en la aplicación, por push y en las aplicaciones de chat vinculadas según sus preferencias, pero no por correo electrónico ni SMS, aunque tenga una dirección de correo. Para enviar correos a personas, añada sus direcciones en una fila address.
Un rol o equipo con más de 20 miembros activos se rechaza (too_many_recipients) en lugar de notificar a medias.
Enfriamiento, cuotas y mensajes tardíos
- Una persona recibe una notificación del mismo motivo desde el mismo flujo una vez cada 10 minutos (su plan puede establecer otro valor, de al menos 1 minuto). Configure Repeat reason cuando el texto cambie con cada lectura, por ejemplo
level of {{ msg.metadata.deviceName }}. La siguiente notificación tras terminar el enfriamiento incluye «(+n)». - Antes de enviar, el bloque comprueba las cuotas mensuales de correo y SMS; un canal sin cuota se omite (
msg.metadata.notify.quota). Solo cuando todos los canales están sin cuota falla conlimit. - Un mensaje tardío no notifica a nadie.
out incluye msg.metadata.notify: recipients, delivered, failed, suppressed, invalid, quota, held. Errores: no_recipients, too_many_recipients, members_unavailable, invalid_attachment, notify_failed, node_not_ready, circuit_open, limit.
Consulte Notifications from rules and flows para plantillas, correos HTML y adjuntos.

