Descripción general
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, 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 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.
- 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 MarketingAudiences 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. |
| 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.
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 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:
{
"error": "Pro includes 50,000 subscribers per audience.",
"usage": { "used": 50000, "limit": 50000, "plan": "pro" }
}Usar la API
La API de listas de contactos te permite crear, obtener, cambiar el nombre, listar y eliminar listas, y la API de suscriptores 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.
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. Un nombre duplicado devuelve 409.
Eventos
Los cambios en las listas y en los suscriptores generan eventos que puedes recibir con webhooks y que inician automatizaciones:
| Evento | Cuándo |
|---|---|
audience.created, audience.updated, audience.deleted |
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 |
Se añade a alguien a una lista desde el panel o con la API. Inicia las automatizaciones Added to audience. |
subscriber.updated |
Cambian los datos de un suscriptor o su indicador Subscribed. |
subscriber.deleted |
Se quita un suscriptor. Inicia las automatizaciones Removed from audience. |
Las importaciones y la URL de suscripción no envían eventos de suscriptores.