# Contactos

> Los contactos son las personas de tu espacio de trabajo. Descubre cómo se relacionan los contactos, las listas de contactos y los suscriptores, qué muestran la página Contacts y el perfil del contacto, y cómo funcionan las bajas.

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.

| | Contacto | Lista de contactos | Suscriptor |
| --- | --- | --- | --- |
| **Qué es** | Una persona | Una lista con nombre a la que envías campañas | La pertenencia de un contacto a una lista |
| **Prefijo del ID** | `con_` | `aud_` | `sub_` |
| **Único por** | Dirección de email, por espacio de trabajo | Nombre, por espacio de trabajo | Uno por contacto y lista |
| **Contiene** | Email, nombre, apellidos, campos personalizados, estado de marketing | Nombre, número de suscriptores, URL de suscripción | Un indicador **Subscribed** con las fechas de alta y de baja |
| **Al eliminarlo** | También se quita el contacto de todas las listas | Se eliminan todos sus suscriptores. Los contactos se conservan. | Se elimina esa pertenencia. El contacto se conserva. |

```text
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](/es/docs/suppressions/).

Un contacto que está en varias de las listas seleccionadas recibe una sola copia. Consulta [Crear una campaña](/es/docs/campaigns/create/) 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.

| Qué cambias | Cómo | Efecto en las campañas |
| --- | --- | --- |
| Estado de marketing | **Unsubscribe** o **Resubscribe** masivo en la página Contacts, o `unsubscribed` en la API | Los contactos **Unsubscribed** se omiten en todas las listas. Su pertenencia a las listas no cambia. |
| La suscripción a una lista | **Unsubscribe** o **Resubscribe** en la página del contacto o en la lista, o `subscribed` en el suscriptor | El contacto se omite solo en las campañas a esa lista. |
| El destinatario hace clic en el enlace de baja | La página de baja alojada | El contacto se da de baja de todas las listas a las que pertenece. |

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](/es/docs/suppressions/). [Bajas](/es/docs/audiences/unsubscribes/) 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](/es/docs/contacts/custom-fields/). 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](/es/docs/contacts/import-export/).

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](/es/docs/api-reference/contacts/update/).

### 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.

| Acción | Qué hace |
| --- | --- |
| **Add to audience** | Añade los contactos a la lista que elijas. Las pertenencias existentes no cambian. Los contactos cuyo estado de marketing es **Unsubscribed** se unen como suscriptores dados de baja. |
| **Remove from audience** | Elimina su pertenencia a la lista que elijas. Los contactos se conservan. |
| **Unsubscribe** | Cambia su estado de marketing a **Unsubscribed**. |
| **Resubscribe** | Vuelve a cambiar su estado de marketing a **Subscribed**. Las suscripciones a las listas no cambian. |
| **Delete** | Elimina los contactos y todas sus pertenencias. Esta acción no se puede deshacer. |

## 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.

| Sección | Qué muestra |
| --- | --- |
| **Details** | El email, el nombre, los apellidos, el estado de marketing y las fechas de creación y de actualización. |
| **Custom fields** | Todos los campos personalizados definidos en el espacio de trabajo y el valor del contacto. |
| **Metrics and Insights** | **Emails sent**, **Loads**, **Clicks**, **Last activity**, **Subscribed audiences** (suscritas sobre el total) y **Marketing status**. Los recuentos incluyen todos los emails salientes enviados a la dirección, no solo las campañas. |
| **Audiences** | Cada lista a la que pertenece el contacto, con su estado y las fechas de alta y de baja. El menú de la fila permite **Unsubscribe** o **Resubscribe** al contacto en esa lista, o **Remove from audience**. **Add to audience** añade una nueva pertenencia. |
| **Sent emails** | Los emails salientes enviados a la dirección, con el asunto, el estado, la campaña, las cargas, los clics y la hora de envío. |
| **Activity log** | Una cronología de los eventos del contacto, como «Contact created», «Added to Newsletter», «Unsubscribed from Newsletter» y «Email delivered». |

## Usar la API

La [API de contactos](/es/docs/api-reference/contacts/) cubre todo lo que hacen la lista y el perfil, salvo la importación de archivos:

- [Crea](/es/docs/api-reference/contacts/create/), [obtén](/es/docs/api-reference/contacts/get/), [actualiza](/es/docs/api-reference/contacts/update/), [lista](/es/docs/api-reference/contacts/list/) y [elimina](/es/docs/api-reference/contacts/delete/) 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](/es/docs/api-reference/contacts/bulk/) sobre un máximo de 100 contactos y [exporta](/es/docs/api-reference/contacts/export/) hasta 10.000 en CSV o XLSX.

```bash
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`](/es/docs/webhooks/events/contact/), y los cambios en las pertenencias generan eventos [`subscriber.*`](/es/docs/webhooks/events/subscriber/), que puedes recibir con [webhooks](/es/docs/webhooks/).

## Próximos pasos

  - [Campos personalizados](/es/docs/contacts/custom-fields/): Guarda datos adicionales en los contactos y úsalos en filtros y emails.
  - [Importar y exportar](/es/docs/contacts/import-export/): Importa contactos desde un archivo CSV o Excel y descárgalos.
  - [Listas de contactos](/es/docs/audiences/): Agrupa los contactos en listas a las que puedes enviar campañas.
  - [Bajas](/es/docs/audiences/unsubscribes/): Cómo funcionan las bajas y cómo respetarlas.

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