# Listas de contactos

> Las listas de contactos son las listas a las que envían tus campañas. Crea listas, gestiona los suscriptores, consulta el límite de suscriptores de tu plan y usa las listas con la API.

Una lista de contactos es una lista con nombre, como «Newsletter» o «Novedades del producto». Eliges una o varias listas como destinatarias de una [campaña](/es/docs/campaigns/), y puedes añadir personas a una lista a mano, con una importación, mediante la API o con una URL de suscripción alojada.

## Cómo funcionan las listas de contactos

Cada persona de una lista es un **suscriptor**: un vínculo entre un [contacto](/es/docs/contacts/) y la lista, con su propio indicador **Subscribed**. El mismo contacto puede estar en varias listas y estar suscrito a unas y dado de baja de otras.

- **Las campañas** se envían a los suscriptores que tienen activado el indicador **Subscribed**, cuyo contacto no se ha dado de baja de forma global y cuya dirección no está bloqueada. Un contacto que está en varias de las listas seleccionadas recibe una sola copia.
- **La baja** desactiva el indicador, pero mantiene al suscriptor en la lista, así que conservas el historial. Consulta [Bajas](/es/docs/audiences/unsubscribes/).
- **Eliminar un suscriptor** quita a la persona de la lista. El contacto se queda en tu espacio de trabajo.

## La página Audiences

Ve a **Email Marketing → Audiences** para ver tus listas con su **Name**, sus **Subscribers** y su fecha de **Created**. La columna **Subscribers** muestra cuántos suscriptores tiene cada lista frente al límite de tu plan, por ejemplo `1.2k/10k`. Usa el menú de la fila para **Manage subscribers**, **Rename** o **Delete** una lista.

Para crear una, selecciona **Create audience**, introduce un **Name** y selecciona **Create**. Los nombres tienen que ser únicos en el espacio de trabajo.

## La página de una lista

Abre una lista para gestionar sus suscriptores. La cabecera muestra el número de suscriptores y el distintivo del límite, con estas acciones:

| Acción | Qué hace |
| --- | --- |
| **Rename** | Cambia el nombre de la lista. |
| **Subscribe URL** | Muestra la URL de suscripción alojada de esta lista y te permite restablecerla. Consulta [URL de suscripción](/es/docs/audiences/subscribe-url/). |
| **Add subscriber** | Añade una persona por su dirección de email. Se sustituye por **Upgrade** cuando una lista de Pay as you go está llena. |
| **Delete** (en el menú) | Elimina la lista y todos sus suscriptores. Los contactos se quedan en tu espacio de trabajo. Esta acción no se puede deshacer. |

Debajo, la tabla de suscriptores muestra **Email**, **First name**, **Last name**, **Subscribed** y **Created**, con búsqueda, filtros y un menú en cada fila para **Edit** o **Delete** cada suscriptor. Consulta [Gestionar los suscriptores](/es/docs/audiences/subscribers/).

## Límites

Cada plan limita cuántos suscriptores puede tener una lista. El número de listas no está limitado.

| | Pay as you go | Pro | Business | Custom |
| --- | --- | --- | --- | --- |
| Suscriptores por lista | 10.000 | 50.000 | 250.000 | Ilimitados |

El límite cuenta todos los suscriptores de la lista, incluidas las personas que se han dado de baja. Para hacer sitio, elimina los suscriptores que ya no necesites, [cambia a un plan superior](/es/docs/billing/plans/) o solicita un límite mayor con **Request Increase** en la tarjeta **Sending Limits** de la página de inicio del panel.

Cuando una lista está llena, **Add subscriber** se desactiva y cualquier forma de añadir personas, incluidas la API, las importaciones y la URL de suscripción, se rechaza con `422` y un mensaje como «Pro includes 50,000 subscribers per audience.». El error de la API incluye el `usage` actual:

```json
{
  "error": "Pro includes 50,000 subscribers per audience.",
  "usage": { "used": 50000, "limit": 50000, "plan": "pro" }
}
```

## Usar la API

La [API de listas de contactos](/es/docs/api-reference/audiences/) te permite [crear](/es/docs/api-reference/audiences/create/), [obtener](/es/docs/api-reference/audiences/get/), [cambiar el nombre](/es/docs/api-reference/audiences/update/), [listar](/es/docs/api-reference/audiences/list/) y [eliminar](/es/docs/api-reference/audiences/delete/) listas, y la [API de suscriptores](/es/docs/api-reference/audiences/subscribers/) gestiona las personas que contienen. Puedes usar el nombre de una lista en lugar de su ID `aud_` en la URL. La API necesita una clave de API con **Full Access**.

```bash
curl https://api.emailit.com/v2/audiences \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Newsletter" }'
```

Las respuestas de las listas incluyen `subscribers_count` y un objeto `usage` con `used`, `limit` y `plan`. Crear, obtener y actualizar una lista también devuelve su `token`, la parte secreta de su [URL de suscripción](/es/docs/audiences/subscribe-url/). Un nombre duplicado devuelve `409`.

## Eventos

Los cambios en las listas y en los suscriptores generan eventos que puedes recibir con [webhooks](/es/docs/webhooks/) y que inician [automatizaciones](/es/docs/automations/):

| Evento | Cuándo |
| --- | --- |
| [`audience.created`, `audience.updated`, `audience.deleted`](/es/docs/webhooks/events/audience/) | Se crea una lista, se le cambia el nombre o se elimina. Eliminar una lista no envía un evento por cada uno de sus suscriptores. |
| [`subscriber.created`](/es/docs/webhooks/events/subscriber/) | Se añade a alguien a una lista desde el panel o con la API. Inicia las automatizaciones **Added to audience**. |
| [`subscriber.updated`](/es/docs/webhooks/events/subscriber/) | Cambian los datos de un suscriptor o su indicador **Subscribed**. |
| [`subscriber.deleted`](/es/docs/webhooks/events/subscriber/) | Se quita un suscriptor. Inicia las automatizaciones **Removed from audience**. |

Las importaciones y la URL de suscripción no envían eventos de suscriptores.

## Próximos pasos

  - [Gestionar los suscriptores](/es/docs/audiences/subscribers/): Añade, edita, da de baja y quita personas.
  - [URL de suscripción](/es/docs/audiences/subscribe-url/): Recoge altas desde tu propio sitio web.
  - [Bajas](/es/docs/audiences/unsubscribes/): Cómo funcionan las bajas en las distintas listas.
  - [Enviar una campaña](/es/docs/campaigns/create/): Envía un email a los suscriptores de tus listas.

---
Fuente: https://emailit.com/es/docs/audiences/