# Listas

Las listas son conjuntos de valores usados para parametrizar [reglas](/es/rules/) sin necesidad de editarlas en cada cambio. En las [expresiones](/es/rules/expression-syntax/#colecciones-), la lista se referencia por su nombre con el prefijo `@`:

```
$user_id in @clientes_cuarentena
```

Mantener datos en listas separa la responsabilidad de la operación (que mantiene los ítems) de la responsabilidad técnica (que mantiene las reglas), reduciendo el riesgo de cambios accidentales en las reglas. Cada lista guarda valores de texto de hasta 128 caracteres, sin saltos de línea.

## Crear una lista

En **Configuración > Listas > Nueva lista**:

1. Elija un nombre usando solo letras, números, guion y guion bajo (ej.: `clientes-cuarentena`).
2. Agregue una descripción opcional.
3. Haga clic en **Crear lista**.

El nombre es el identificador usado en las expresiones y **no puede cambiarse después de la creación**: una regla que referenciara el nombre anterior dejaría de encontrar los ítems.

## Agregar ítems

Abra la lista deseada y haga clic en **Agregar ítems**:

1. Ingrese un ítem por línea.
2. Agregue una descripción opcional, repetida en todos los ítems de la inserción (útil para referenciar un ticket de atención, por ejemplo).
3. Opcionalmente, defina un plazo de expiración, en minutos, horas o días, con un mínimo de 5 minutos y un máximo de 2 años. Sin plazo, el ítem permanece hasta su eliminación manual.

Cada lista admite hasta **10.000 ítems**. Puede agregar hasta **1.000 ítems por inserción**; para registrar volúmenes mayores, divida el contenido en más de una inserción.

También es posible agregar ítems por la API, con `POST /lists/{list_id}/items`. El plazo de expiración se informa en `expires_in`, como un período ISO 8601 (`PT30M`, `PT12H`, `P1D`).

## Ítems agregados por reglas

Una regla puede escribir en una lista durante el procesamiento de un evento, con la acción [agregar a la lista](/es/rules/actions/add_to_list/). De esta forma, una regla incorpora lo que ya observó: una condición detecta el comportamiento y registra el valor en la lista, y los eventos siguientes consultan esa lista con una condición común.

Al seguir una lista escrita por reglas, considere que:

- los ítems aparecen **sin descripción y sin autor**, ya que no fueron registrados por una persona;
- un valor detectado nuevamente **renueva el plazo** del ítem existente, en lugar de crear otro;
- con la lista **llena**, los valores nuevos dejan de agregarse; conviene seguir la cantidad de ítems en las listas alimentadas automáticamente.

## Consultar y eliminar ítems

Los ítems pueden paginarse o buscarse mediante el campo de búsqueda en la parte superior de la tabla. Para eliminar, use **⋮ > Eliminar** en el ítem deseado, o **Eliminar todos los ítems** para vaciar la lista.

Los ítems con plazo de expiración se eliminan automáticamente mediante barridos periódicos, ejecutados cada pocos minutos. Por eso un ítem puede seguir valiendo en una condición algunos minutos más allá del plazo, y también por eso el plazo mínimo es de 5 minutos.

## Eliminar una lista

Una lista solo puede eliminarse cuando está vacía y no es usada por ninguna regla activa ni por ningún monitoreo. Elimine los ítems y las referencias antes de borrarla.