Novedad: el cortafuegos de IA supervisa toda la plataforma y explica cada incidente con palabras sencillas. Vea cómo funciona

Silenciar un dispositivo durante el mantenimiento

Silencie las notificaciones de alarma de un dispositivo durante hasta 90 días mientras las alarmas siguen registrándose: una regla o todas, establecer y levantar un silencio, auditoría.

Silenciar detiene las notificaciones de alarma de un dispositivo durante un tiempo, por ejemplo durante el mantenimiento o la puesta en servicio. 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 alarmaSiguen evaluándose. Las alarmas se abren, cambian de severidad y se cierran como de costumbre.
Página de alarmas, contador de la campana, panelesSe muestran las alarmas como de costumbre.
Notificaciones de apertura y escaladoNo se envían. La cronología de la alarma recibe una línea Silenciada: nadie fue notificado.
RecordatoriosNo se envían mientras dure el silencio.
Notificación de la resoluciónNo se envía para una alarma cuya apertura nunca se notificó.
Webhooks y flujosSiguen recibiendo los cambios de alarma. Un silencio silencia a las personas, no a los sistemas.
Reglas de la tarjeta RulesSiguen ejecutándose. Una regla que reacciona a la alarma sigue actuando. Para detener las reglas, use el modo Manual (véase Modos Manual y Automático).

Un silencio puede abarcar:

  • 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 acallar un dispositivo para siempre. Un nuevo silencio se aplica en unos 10 segundos.

Establecer un silencio

Los silencios se establecen mediante la API. Necesita el derecho Silenciar las alarmas de un dispositivo (Admin 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"
}
CampoSignificado
untilObligatorio. Cuándo termina el silencio, como fecha y hora con desfase horario. Debe estar en el futuro y a no más de 90 días.
ruleIdOpcional. El id de una regla de alarma del perfil del dispositivo. Ausente o null: todas las alarmas del dispositivo.
reasonOpcional, hasta 500 caracteres.

Respuestas:

MensajeCausa
«Un silencio debe terminar en el futuro.»until es ahora o está en el pasado.
«Un silencio puede durar como máximo 90 días.»until está demasiado lejos.
«Dispositivo no encontrado.»El dispositivo no existe en su organización, o está eliminado.
«Regla de alarma no encontrada.»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 vuelve a anunciar, pero los recordatorios programados para ella se envían una vez terminado el silencio.

Auditoría

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

Alternativas

NecesidadUse
Detener un tipo de alarma para todos los dispositivos de un perfilDesactive la regla en la pestaña Reglas de alarma del perfil (y vuélvala a activar más tarde). Entonces las alarmas tampoco se registran.
Detener las reglas de la tarjeta Rules de un sitio mientras hay personal trabajando allíModo Manual en el sitio. Las alarmas siguen funcionando.
Alarmas más silenciosas, pero no mudasAumente la severidad mínima de la regla, o añada antirrebote. Véase Antirrebote, histéresis y amortiguación.