Descripción general
Listas de contactos
Las listas de contactos son las listas a las que envían tus campañas. Crea, fusiona y archiva listas, gestiona los suscriptores, configura el doble opt-in y un nombre público, 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, su Visibility, sus Subscribers y su fecha de Created. Debajo del nombre ves el nombre público cuando es distinto, y Visibility muestra Public o Private y un distintivo Double opt-in cuando está activado. La columna Subscribers muestra cuántos suscriptores tiene cada lista frente al límite de tu plan, por ejemplo 1.2k/10k. Todas las columnas se pueden ordenar.
El menú de la fila incluye Manage subscribers, Rename, Merge into another audience, Archive y Delete. Para actuar sobre varias listas, selecciónalas y usa Actions: Merge, Archive (o Unarchive en la pestaña Archived) y Delete.
Para crear una, selecciona Create audience, introduce un Name y selecciona Create. Los nombres tienen que ser únicos en el espacio de trabajo.
Archivar una lista de contactos
Archiva las listas que ya no uses para ordenar sin perder nada. Una lista archivada pasa a la pestaña Archived y:
- conserva todos sus suscriptores,
- se oculta en los selectores de listas de las campañas, los formularios, las automatizaciones y los contactos,
- no aparece en la página de gestión de suscripciones, salvo para las personas que siguen suscritas a ella,
- deja de aceptar altas mediante su URL de suscripción, que devuelve
404.
Las campañas, los formularios y las automatizaciones que ya la usan siguen funcionando. Selecciona Unarchive para recuperarla.
Fusionar listas de contactos
La fusión copia los suscriptores de una o varias listas en otra. Selecciona las listas, elige Actions > Merge y después elige la lista en la que se fusionan, o usa Merge into another audience en el menú de una fila. En la página de una lista, Merge audiences into this one, en el menú, hace lo mismo en sentido contrario.
- Las personas que ya están en la lista de destino conservan su estado en ella, así que nadie que se haya dado de baja se vuelve a suscribir.
- Una persona que está en varias de las listas fusionadas queda suscrita si al menos una de ellas la tiene suscrita.
- Con Delete the merged audiences afterwards, se eliminan las listas fusionadas y sus pertenencias, y las campañas dirigidas a ellas que todavía no han terminado de enviarse pasan a enviarse a la lista de destino. Los segmentos que tienen como origen una lista fusionada, o una regla sobre ella, también pasan a usar la lista de destino, y lo mismo ocurre con las automatizaciones que se inician con ella, añaden contactos a ella, la comprueban en una condición o terminan la ejecución cuando alguien sale de ella. Lo mismo ocurre con los formularios que añaden personas a ella o la ofrecen como opción, con los enlaces de doble opt-in que todavía no se han confirmado y con las ejecuciones de automatizaciones que esperan una condición sobre ella.
La fusión no envía eventos subscriber.*, no inicia automatizaciones y no envía emails de doble opt-in ni de confirmación. Después, los segmentos con seguimiento actualizan sus miembros. Se aplica el límite de suscriptores de la lista de destino: una fusión que lo superaría no añade a nadie.
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 |
|---|---|
| Subscribe URL | Muestra la URL de suscripción de esta lista y te permite restablecerla. Consulta URL de suscripción. |
| Import | Importa un archivo CSV o Excel directamente en esta lista. Consulta Importar suscriptores. |
| 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. |
| Settings (en el menú) | Abre la pestaña Settings. |
| Merge audiences into this one (en el menú) | Copia en esta lista los suscriptores de otras listas. Consulta Fusionar listas de contactos. |
| Archive (en el menú) | Archiva la lista, o la desarchiva. Consulta Archivar una lista de contactos. |
| Create segment (en el menú) | Empieza un nuevo segmento con esta lista como origen. Los segmentos están en alfa y solo están abiertos al equipo de Emailit. |
| 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. |
La pestaña Subscribers muestra las personas de la lista, con las vistas All, Engaged y Unengaged, columnas ordenables, búsqueda, filtros y acciones masivas. Consulta Gestionar los suscriptores.
La pestaña Settings contiene:
- Name and visibility: el nombre interno, el nombre público y la descripción que ven los suscriptores, y si la lista es pública o privada en la página de gestión de suscripciones.
- Double opt-in y Confirmation email: consulta Doble opt-in y emails de confirmación.
- Unengaged contacts: consulta Contactos sin interacción.
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 pide un límite mayor a support@emailit.com.
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, actualizar, listar, fusionar, actualizar de forma masiva 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 la configuración (visibility, public_name, public_description, double_opt_in, confirmation_email, unengaged, archived, archived_at), 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. Los listados omiten las listas archivadas, salvo que pases archived=true o archived=all.
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 modifica (también al archivarla) 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, la API, la URL de suscripción, un formulario, un enlace de doble opt-in o la página de gestión de suscripciones. 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 las fusiones no envían eventos de suscriptores.