Reglas de notificación

Esta página describe el sistema de reglas compartido por las integraciones de Discord, Slack y Telegram. Controla qué eventos y alertas de Akiles se entregan al canal.

Alternancias

Cada integración de notificación tiene cuatro casillas de verificación en su página de configuración:

• Notificar acciones de gadget — Envía un mensaje cada vez que alguien abre (o realiza otra acción en) un gadget. Un mensaje por apertura.
• Notificar acciones de administrador — Envía un mensaje para cualquier otro evento en el registro de auditoría — administradores editando miembros, creando ubicaciones, eliminando grupos, etc. Cualquier cosa que no sea una apertura de gadget.
• Notificar alertas — Envía un mensaje cada vez que se dispara una alerta (hardware desconectado, batería baja, batería faltante, sin corriente).
• Notificar según reglas personalizadas — Habilita la pestaña Reglas de notificación, donde puedes configurar reglas adicionales más granulares.

Los tres primeros son alternancias independientes, no “uno u otro” — puedes habilitar todos, ninguno, o cualquier combinación. Se envía un mensaje si cualquiera de las condiciones habilitadas coincide.

Reglas personalizadas

Cuando Notificar según reglas personalizadas está habilitado, aparece la pestaña Reglas de notificación en la integración. Cada regla allí coincide con eventos o alertas adicionales además de lo que ya cubren las alternancias.

Una regla tiene tres listas de filtros. Un evento coincide con una regla cuando coincide con todos los filtros que están configurados en la regla:

• Verbos — (Solo reglas de eventos.) El tipo de acción (create, edit, delete, use, reveal, etc). Vacío = coincide con cualquier verbo.
• Tipos de objeto — (Solo reglas de eventos.) El tipo de objeto (member, gadget, site, permission, etc). Vacío = coincide con cualquier tipo de objeto.
• Tipos de alerta — (Solo reglas de alertas.) hardware_down, hardware_low_battery, hardware_missing_battery, hardware_no_mains. Vacío = coincide con cualquier tipo de alerta.
• Ubicaciones — Solo coincide con eventos/alertas que pertenecen a una de las ubicaciones listadas. Vacío = coincide con cualquier ubicación, incluyendo eventos que no están vinculados a una ubicación específica.

El campo Tipo de una regla es Evento o Alerta; eso determina si filtra eventos o alertas y cuáles de las listas anteriores son relevantes.

Ejemplos

• Solo aperturas de gadget en la puerta principal de una ubicación: Deshabilita las tres alternancias de nivel superior. Habilita reglas personalizadas. Añade una regla de evento con verbo use, tipo de objeto gadget_action, y la ubicación que te importa. Opcionalmente también restringe por gadget si solo te importan puertas específicas (sin filtro incorporado para eso — restringe más con object_types si es necesario).

• Todos los cambios de administrador en miembros y grupos, en cualquier lugar: Deshabilita las alternancias de nivel superior. Habilita reglas personalizadas. Añade una regla de evento con verbos create, edit, delete y tipos de objeto member, member_group.

• Solo alertas de hardware desconectado en una ubicación específica: Deshabilita la alternancia Notificar alertas. Habilita reglas personalizadas. Añade una regla de alerta con tipo de alerta hardware_down y la ubicación que te importa.

• Todo: Habilita Notificar acciones de gadget, Notificar acciones de administrador, y Notificar alertas. No se necesitan reglas personalizadas.

Permisos

Las reglas personalizadas solo pueden filtrar tipos de objeto que tienes permiso para leer. Por ejemplo, no puedes crear una regla que filtre eventos de permission a menos que tu rol tenga permission.get. Si dejas tipos de objeto vacío (coincidir con cualquiera), se aplica la misma verificación a cada tipo de objeto que la integración podría recibir — por lo que se requerirán roles de estilo administrador para reglas sin restricciones.

Integraciones deshabilitadas

Cuando la integración en sí está deshabilitada, no se envían notificaciones independientemente de las alternancias o reglas. Un banner de advertencia aparece en la pestaña Reglas de notificación en ese caso.