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

# Listas

> Las listas son grupos de contactos en Notifuse. Sirven para organizar tu audiencia y enviar campañas de correo dirigidas.

Ejemplo:

```
- Newsletter Subscribers
- VIP Customers
- Event Attendees
- Product Updates
```

![Una lista abierta en la página Contactos](https://www.notifuse.com/docs/assets/screenshots/lists.png)

## Las listas en la consola

Las listas están en la página **Contactos**, en su columna izquierda, bajo **Listas**; no hay una página de Listas aparte. El **+** junto a **Listas** (**Nueva lista**) crea una.

Al seleccionar una lista se muestran:

- **Sus suscriptores por estado**: haz clic en un estado para ver solo esos contactos. Los recuentos de bajas, rebotes y quejas muestran además su proporción en la lista.
- **Su configuración**: visibilidad, doble confirmación y su plantilla de confirmación, y el ID de la lista. **Editar lista** abre el formulario.
- **Sus miembros**, con el estado de cada uno en la lista y desde cuándo.

**Importar a la lista** importa un CSV directamente en la lista, y el menú **…** la elimina.

## Estados de los contactos

El estado de un contacto en una lista decide si puede recibir correos:

| Estado                    | Entrega de correos         | Descripción                                                |
| ------------------------- | -------------------------- | ---------------------------------------------------------- |
| **Activo**                | ✅ Puede recibir correos    | Suscriptores confirmados que pueden recibir envíos masivos |
| **Pendiente**             | ❌ No puede recibir correos | A la espera de la doble confirmación                       |
| **Cancelado suscripción** | ❌ No puede recibir correos | Se dio de baja de las comunicaciones                       |
| **Rebotado**              | ❌ Nunca recibe correos     | La dirección de correo no es válida o no se puede alcanzar |
| **Quejado**               | ❌ Nunca recibe correos     | Marcó correos como spam                                    |

> **Importante**: los envíos masivos dejan fuera a los contactos de la lista que se han dado de baja, salvo que el envío masivo ponga `exclude_unsubscribed` en `false` (**Excluir destinatarios dados de baja** desactivado en la consola), por ejemplo para un aviso de seguridad o legal. Los correos de un envío masivo así no llevan la cabecera `List-Unsubscribe`, así que los clientes de correo no muestran ningún botón para darse de baja. Una petición a la API sin `exclude_unsubscribed` los excluye, igual que la consola. Los contactos rebotados o con queja nunca reciben correos, sea cual sea el ajuste.

Un contacto que se da de baja desde un correo enviado para una lista en la que no estaba, como un correo de una automatización, queda registrado en esa lista como **cancelado suscripción**. Una baja nunca sustituye un estado **rebotado** o **quejado**.

## Visibilidad de las listas

### Listas públicas

- **Centro de notificaciones**: ✅ Aparecen en el centro de notificaciones
- **Acceso de los suscriptores**: los usuarios pueden ver estas listas y suscribirse a ellas en tu centro de notificaciones
- **Caso de uso**: newsletters, anuncios y comunicaciones generales

### Listas privadas

- **Centro de notificaciones**: ❌ No se ofrecen a los contactos que no están en ellas. Un contacto ve una lista privada en la que está activo o pendiente, y desde ahí solo puede salir de ella.
- **Acceso de los suscriptores**: solo el espacio de trabajo añade contactos, desde la consola o con la API autenticada (`lists.subscribe`). Un contacto no puede unirse a una lista privada desde el centro de notificaciones ni desde el endpoint público `/subscribe`, ni volver después de haberla dejado; solo el espacio de trabajo puede volver a añadirlo. Un enlace de sus correos solo le permite confirmar una doble confirmación pendiente.
- **Caso de uso**: comunicaciones internas, segmentos VIP, listas transaccionales o envíos masivos puntuales

## Configuración de la doble confirmación

### Activar la doble confirmación

Cuando activas la doble confirmación en una lista:

- **Contactos importados**: los contactos añadidos por importación de CSV o por la API quedan siempre **"activo"** (se saltan la doble confirmación)
- **Suscriptores anónimos**: los usuarios que se suscriben a través de formularios (como el alta en la newsletter de tu sitio web) quedan **"pendiente"**
- **Confirmación obligatoria**: los contactos pendientes deben hacer clic en un enlace de confirmación de su correo para pasar a "activo"
- **Cumplimiento**: ayuda a cumplir el RGPD y reduce las quejas por spam

**Ejemplo**: un visitante rellena un formulario de newsletter en tu sitio web y recibe un correo de confirmación. Cuando hace clic en el enlace (que muestra el centro de notificaciones), su estado pasa de "pendiente" a "activo".

### Plantilla de bienvenida (opcional)

Las listas no tienen plantilla de bienvenida. El único correo que una lista envía por sí sola es la confirmación de la doble confirmación. Para dar la bienvenida a los nuevos suscriptores, crea una [automatización](https://www.notifuse.com/es/docs/features/automations.md) que se dispare con `list.subscribed` o `list.confirmed` para esa lista.

### Plantilla de baja (opcional)

Las listas tampoco tienen plantilla de baja. Para escribir a los contactos que dejan una lista, usa una automatización que se dispare con `list.unsubscribed`.

## Gestión de las nuevas suscripciones

Cuando un contacto intenta suscribirse a una lista en la que ya estuvo, Notifuse actúa según su estado actual:

| Estado actual             | Comportamiento                                                                                                              |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| **Activo**                | No hace nada. El contacto ya está suscrito. Devuelve éxito sin más.                                                         |
| **Pendiente**             | El estado no cambia. Vuelve a enviar el correo de doble confirmación.                                                       |
| **Cancelado suscripción** | Se permite. El estado pasa a **"pendiente"** y se envía un correo de confirmación, aunque la lista use confirmación simple. |
| **Rebotado**              | Se bloquea. El estado no cambia y no se envía ningún correo.                                                                |
| **Quejado**               | Se bloquea. El estado no cambia y no se envía ningún correo.                                                                |

### Por qué se bloquean los contactos rebotados y con queja

Volver a enviar a direcciones que rebotaron de forma permanente o que presentaron quejas por spam daña la reputación del remitente y puede hacer que tu dominio acabe en listas negras. Estos contactos quedan suprimidos para siempre, tanto en la aplicación como en la base de datos.

### Comportamiento en la importación masiva

Cuando se importan contactos por CSV o por la API con `subscribe_to_lists`, se aplican las mismas protecciones en la base de datos: el estado en la lista de los contactos **cancelado suscripción**, **rebotado** o **quejado** no se sobrescribe, así que una operación masiva no puede reactivar por accidente a contactos que se dieron de baja.

### Privacidad desde el diseño

El endpoint público `/subscribe` devuelve HTTP 200 sea cual sea el estado del contacto en la lista, así que un atacante no puede sondearlo para saber si una dirección de correo está suscrita. Devuelve 400 ante una petición no válida o una lista que no es pública, 429 cuando llegan demasiados intentos desde la misma IP, y 500 para los demás errores.

## Permisos

Las listas dependen del permiso **Listas**: el nivel **Leído** muestra las listas, su configuración y sus recuentos de suscriptores, y el nivel **Escribir** las crea, edita y elimina y gestiona las suscripciones. Listar las direcciones de los miembros de una lista requiere también lectura en **Contactos**, y cambiar o eliminar una suscripción existente requiere también escritura en **Contactos**.

En la consola, un miembro con lectura en Listas pero sin lectura en Contactos sigue llegando a la página **Contactos**: la columna izquierda muestra las listas y sus recuentos, pero ningún contacto.

> [!WARNING]
>
> **La escritura en Listas es una escritura implícita en Contactos.** Suscribir una dirección con `/api/lists.subscribe`
> crea o sobrescribe el registro completo de ese contacto, con cada campo que trae la petición, sin
> necesitar escritura en Contactos, así que un miembro o una clave API que solo tenga escritura en Listas puede reescribir igualmente tus
> datos de contacto. Una llamada autenticada también puede suscribir a alguien a una lista que no es pública. Concede
> escritura en Listas solo donde concederías escritura en Contactos. Consulta
> [Administradores y claves API](https://www.notifuse.com/es/docs/features/admins-api-keys.md).

## Buenas prácticas

1. Revisa con regularidad los estados de los contactos para mantener tus listas en buen estado.
2. Activa la doble confirmación por cumplimiento normativo y para quedarte con los suscriptores que de verdad quieren tus correos.
3. Define una plantilla de confirmación en las listas con doble confirmación, y usa automatizaciones para los correos de bienvenida.
4. Usa listas distintas para audiencias distintas (por ejemplo, "Newsletter", "Product Updates") y combínalas con filtros de segmento para dirigir los envíos masivos.
