Silenciar un dispositivo por mantenimiento

Silenciar detiene las notificaciones de alarma de un dispositivo durante un tiempo, por ejemplo durante el mantenimiento o la puesta en marcha. Las alarmas siguen abriéndose, escalando y cerrándose, y siguen registrándose; nadie es informado de ellas hasta que termina el silencio.

Qué hace un silencio

	Durante un silencio
Reglas de alarma	Siguen evaluándose. Las alarmas se abren, cambian de severidad y se cierran como de costumbre.
Página de alarmas, contador de la campana, paneles	Las alarmas se muestran como de costumbre.
Notificaciones de apertura y escalado	No se envían. La línea de tiempo de la alarma recibe una línea Silenciada: nadie fue notificado.
Recordatorios	No se envían mientras dure el silencio.
Notificación de la resolución	No se envía para una alarma cuya apertura nunca se notificó.
Webhooks y flujos	Siguen recibiendo los cambios de alarma. Un silencio silencia a las personas, no a los sistemas.
Reglas de la tarjeta Rules	Siguen ejecutándose. Una regla que reacciona a la alarma sigue actuando. Para detener las reglas, use el modo Manual (véase Modos Manual y Auto).

Un silencio puede cubrir:

• todas las alarmas del dispositivo, incluidas las generadas por flujos y reglas, o
• una regla de alarma del perfil del dispositivo.

Un silencio dura hasta su hora de fin. El silencio más largo es de 90 días, de modo que un silencio olvidado no pueda silenciar un dispositivo para siempre. Un nuevo silencio se aplica en unos 10 segundos.

Establecer un silencio

Los silencios se establecen mediante la API; en esta versión no hay ningún botón para ellos en la aplicación. Necesita el derecho Silenciar las alarmas de un dispositivo (Administrador por defecto). Use una clave de API con ese derecho; véase Autenticación.

POST /tenant/{tenantId}/api/iot/devices/{deviceId}/alarm-mute
Content-Type: application/json

{
  "until": "2026-11-20T18:00:00+01:00",
  "reason": "Pump overhaul, ticket 4711"
}

Campo	Significado
until	Obligatorio. Cuándo termina el silencio, como fecha y hora con desfase horario. Debe estar en el futuro y a 90 días como máximo.
ruleId	Opcional. El id de una regla de alarma del perfil del dispositivo. Ausente o null: todas las alarmas del dispositivo.
reason	Opcional, hasta 500 caracteres.

Respuestas:

Mensaje	Causa
«A mute must end in the future.»	until es ahora o está en el pasado.
«A mute may last at most 90 days.»	until está demasiado lejos.
«Device not found.»	El dispositivo no existe en su organización o está eliminado.
«Alarm rule not found.»	ruleId no es una regla del perfil del dispositivo.

Consultar y levantar silencios

GET    /tenant/{tenantId}/api/iot/devices/{deviceId}/alarm-mute
DELETE /tenant/{tenantId}/api/iot/devices/{deviceId}/alarm-mute
DELETE /tenant/{tenantId}/api/iot/devices/{deviceId}/alarm-mute?muteId={muteId}

GET lista los silencios vigentes con muteId, ruleId, until, reason, quién lo estableció y cuándo. DELETE sin muteId levanta todos los silencios del dispositivo; con él, solo ese.

Cuando termina un silencio, las notificaciones se reanudan con el siguiente cambio de alarma. Una alarma que se abrió durante el silencio y sigue abierta no se anuncia de nuevo, pero los recordatorios programados para ella se envían una vez terminado el silencio.

Auditoría

Cada silencio y cada silencio levantado escribe una entrada de auditoría en el dispositivo: quién, cuándo, la regla (o todas), la hora de fin. Véase Registro de auditoría.

Alternativas

Necesidad	Use
Detener un tipo de alarma para todos los dispositivos de un perfil	Desactive la regla en la pestaña Reglas de alarma del perfil (y vuelva a activarla después). Las alarmas tampoco se registran entonces.
Detener las reglas de la tarjeta Rules de un sitio mientras hay personas trabajando en él	Modo Manual en el sitio. Las alarmas siguen funcionando.
Alarmas más discretas, no silenciosas	Aumente la severidad mínima de la regla, o añada anti-rebote. Véase Anti-rebote, histéresis y amortiguación.