> ## Documentation Index
> Fetch the complete documentation index at: https://woku.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Alertas

> Avisos automáticos por email cuando una condición de metas o de volumen de respuestas necesita atención

Una **alerta** es una condición del sistema que necesita atención humana.
Cuando la condición se cumple, woku envía un aviso por correo electrónico
a una lista de destinatarios, y sigue avisando según la frecuencia
configurada mientras la condición persista.

Las alertas se administran desde el menú **Alertas** del panel. Desde
ahí puedes crear una con el botón **Nueva alerta**, filtrar el listado
por tipo y ver en cada tarjeta la regla escrita en lenguaje claro,
junto con el contador de avisos enviados.

## Tipos y condiciones

Existen dos tipos de alerta:

### Metas

Condición **Meta por cerrar sin cumplir**: se activa cuando faltan menos
de N días para cerrar el periodo de la meta y la meta sigue bajo el
objetivo. El número de días es configurable, por defecto 7, con un rango
de 1 a 365.

### Volumen

Dos condiciones sobre el volumen de respuestas de una herramienta
(wokus, NPS, CSAT, CES o formularios):

* **Caída de respuestas**: las respuestas bajan más de un porcentaje
  frente al promedio reciente.
* **Pico de respuestas**: las respuestas suben más de un porcentaje
  frente al promedio reciente.

El detalle del cálculo estadístico está en
[Alertas por caída de volumen](/docs/alerts/volume-drop).

Los planes de acción no usan alertas: sus borradores notifican
directamente al grupo de encargados correspondiente.

## Alcance

Cada alerta define a qué aplica:

* **Metas**: todas las metas activas, o una meta específica.
* **Volumen**: todos los instrumentos de una herramienta, o un
  instrumento específico.

## Frecuencia y destinatarios

La frecuencia funciona como un enfriamiento entre avisos mientras la
condición siga ocurriendo:

| Frecuencia                              | Comportamiento                                                               |
| --------------------------------------- | ---------------------------------------------------------------------------- |
| Apenas suceda                           | Avisa en cada evaluación en la que la condición se cumpla, sin enfriamiento. |
| Una vez al día mientras siga ocurriendo | Máximo un aviso por día. Es la opción por defecto.                           |
| Una vez por semana                      | Máximo un aviso por semana.                                                  |

Los avisos llegan a una lista de correos que defines libremente, de 1 a
50 destinatarios. No necesitan ser usuarios de woku.

## Cómo se evalúa

Cada alerta se evalúa automáticamente **una vez al día**. Además, el
botón **Evaluar ahora** en el detalle ejecuta la misma lógica al
instante, útil para probar una alerta recién creada.

El detalle de cada alerta se abre en un panel lateral con las secciones
**Regla**, **Aplica a**, **Enviar aviso a**, **Frecuencia**,
**Historial de envíos** y **Estado del sistema**.

La sección **Estado del sistema** muestra la fecha y hora de la última
revisión y el estado resultante:

* **Activada**: la condición se cumple y corresponde avisar.
* **Todo en orden**: la condición no se cumple.
* **Datos insuficientes**: todavía no hay suficiente historial para
  comparar. La alerta se activará cuando lo haya.

## Historial de envíos

Cuando una alerta se dispara, envía el correo a los destinatarios y
registra ese envío en el **Historial de envíos** del detalle, con fecha
y hora. La tarjeta de la alerta en el listado muestra el contador
acumulado de avisos.

## Auditoría

Crear, editar, eliminar y evaluar una alerta quedan registrados en el
[audit log](/docs/security/audit-log) como `alert.create`, `alert.update`,
`alert.delete` y `alert.evaluate`.
