Contactos

Un contacto es una persona de tu espacio de trabajo, identificada por su dirección de email. Los contactos guardan los nombres y los valores de los campos personalizados que usas para personalizar las campañas, y se unen a listas de contactos, que son las listas a las que se envían las campañas. Esta página explica cómo encajan las piezas y qué puedes hacer con los contactos en el panel y con la API.

Contactos, listas de contactos y suscriptores

Emailit mantiene separadas las personas y las listas. Una persona existe una sola vez como contacto, y cada lista en la que está es un registro de suscriptor independiente con su propio estado de consentimiento.

Workspace
├── Contacts ────────────── one per email address
│   ├── email, first_name, last_name, custom_fields
│   └── marketing status (unsubscribed: true | false)
└── Audiences ───────────── named lists, for example "Newsletter"
    └── Subscribers ─────── one per contact on the list
        └── subscribed: true | false

En la práctica:

• Un contacto puede ser suscriptor de muchas listas, con un indicador Subscribed distinto en cada una.
• Al añadir a alguien a una lista por su email, primero se crea el contacto si todavía no existe.
• Los nombres y los campos personalizados están en el contacto. Si los editas desde una lista, cambia el contacto, así que el cambio se ve en todas partes.

Quién recibe una campaña

Una campaña se envía a todos los contactos que cumplen las tres condiciones:

1. El contacto es suscriptor de al menos una de las listas de la campaña, con Subscribed activado.
2. El estado de marketing del contacto es Subscribed.
3. La dirección no está en tu lista de direcciones bloqueadas.

Un contacto que está en varias de las listas seleccionadas recibe una sola copia. Consulta Crear una campaña para ver todas las reglas.

Estado de marketing

Cada contacto tiene además un Marketing status para todo el espacio de trabajo: Subscribed o Unsubscribed (el campo unsubscribed en la API). Es una baja global que está por encima del indicador de cada lista.

El estado de marketing y las suscripciones a las listas solo controlan las campañas. No bloquean los emails que envías con la API o por SMTP, ni los que envían las automatizaciones. Para detener todo el correo a una dirección, añádela a tus direcciones bloqueadas. Bajas explica todas las formas de darse de baja.

La página Contacts

Abre Email Marketing›Contacts para ver todos los contactos del espacio de trabajo, de más reciente a más antiguo.

• Columnas. Email se muestra siempre. Activa o desactiva First name, Last name, Audiences, Created y Updated en Display options > Edit columns, o selecciona Show full name para juntar los nombres en una sola columna Name. En la columna Audiences, el distintivo de cada lista es verde mientras el contacto está suscrito a ella y rojo cuando se da de baja.
• Buscar busca en el email, el nombre y los apellidos.
• Filtra por Email, Name, First name, Last name, Unsubscribed, Created, Updated, Audiences o Audience, y por cualquier campo personalizado. Con dos o más filtros, elige si deben cumplirse todos o cualquiera de ellos.
• Ordena seleccionando el encabezado de una columna.
• Import y Export importan y exportan contactos como archivos. Consulta Importar y exportar contactos.

Selecciona una fila para abrir el contacto. El menú de la fila tiene Edit y Delete.

Añadir un contacto

Selecciona Add contact e introduce el Email y, opcionalmente, First name, Last name y Audiences. Selecciona Show custom fields para rellenar los valores de los campos personalizados. Una dirección de email solo puede existir una vez por espacio de trabajo, así que añadir una dirección existente falla.

Para cambiar un contacto más adelante, selecciona Edit. Puedes cambiar los nombres y los campos personalizados. La dirección de email no se puede cambiar en el panel. Usa en su lugar el campo email de Actualizar un contacto.

Acciones masivas

Selecciona los contactos con las casillas (la casilla del encabezado selecciona toda la página) y después abre Actions. Cada acción se aplica a un máximo de 100 contactos a la vez.

La página del contacto

La página del contacto muestra todo lo que Emailit sabe de una persona. Usa Edit y Delete en la parte superior.

Usar la API

La API de contactos cubre todo lo que hacen la lista y el perfil, salvo la importación de archivos:

• Crea, obtén, actualiza, lista y elimina contactos. Siempre que se espera un ID, puedes pasar la dirección de email del contacto en lugar de su ID con_.
• Pasa audiences (un array de ID aud_) al crear un contacto para suscribirlo de inmediato. Al actualizarlo, audiences sustituye las pertenencias del contacto.
• Ejecuta una acción masiva sobre un máximo de 100 contactos y exporta hasta 10.000 en CSV o XLSX.

curl https://api.emailit.com/v2/contacts \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ada@example.com",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "custom_fields": { "company": "Acme", "plan": "pro" },
    "audiences": ["aud_2kq8Vt4xLm7Rz"]
  }'

Si creas un contacto con un email que ya existe, se devuelve 409 con el contacto existente en existing. La API de contactos necesita una clave de API con Full Access.

Los cambios en los contactos generan eventos contact.created, contact.updated y contact.deleted, y los cambios en las pertenencias generan eventos subscriber.*, que puedes recibir con webhooks.

Próximos pasos