> ## 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 por palabras clave

> Detección automática de palabras clave en el feedback de texto y voz, con acciones configurables

Una **alerta por palabras clave** revisa el feedback reciente y, cuando
encuentra alguna de las palabras configuradas, dispara una acción.

## Qué se revisa

Cada alerta define en qué fuentes buscar:

* **Notas de texto** (`textnote.description`): comentarios escritos.
* **Transcripción de voz** (`voicemail.transcription`): mensajes de voz
  transcritos.
* **Respuestas de formularios** (`formResponse.answers`): el texto de
  las respuestas.

Las palabras clave son **insensibles a mayúsculas**. Una coincidencia en
cualquiera de ellas dispara la alerta.

## Alcance

* **Toda la empresa** (`companyWide`).
* **Un woku específico** (`wokuId`), indicando su referencia.

Para las notas de texto y la voz, que se enlazan por woku, el evaluador
resuelve los wokus de la empresa antes de buscar.

## Acciones

Cuando hay coincidencias y se cumplió el período de enfriamiento, la
alerta ejecuta una de estas acciones:

* **Notificar usuarios**: envía una notificación a los usuarios elegidos.
* **Webhook**: hace un `POST` con el detalle de las coincidencias a la
  URL configurada.
* **Crear plan de acción**: abre un plan de acción de prioridad alta
  vinculado a la alerta.

## Evaluación y enfriamiento

* El evaluador corre de forma periódica (cada 15 minutos por defecto) y
  solo revisa documentos creados después de la última evaluación.
* El **enfriamiento** (`cooldownMinutes`, 60 por defecto) evita que la
  misma alerta dispare repetidamente y sature al gestor.

## Previsualización

Antes de guardar, el formulario permite **previsualizar** cuántos
documentos de las últimas 24 horas coincidirían con las palabras clave
actuales, sin guardar nada ni ejecutar acciones.

<Note>
  En V1 la búsqueda se hace en memoria sobre una ventana reciente. La
  indexación con `$text` o Atlas Search está planificada para cuando el
  volumen lo requiera.
</Note>