# Contacts

> Les contacts sont les personnes de votre espace de travail. Découvrez les liens entre contacts, listes et abonnés, ce qu’affichent la liste Contacts et la fiche d’un contact, et comment fonctionnent les désinscriptions.

Un contact est une personne de votre espace de travail, identifiée par son adresse e-mail. Les contacts contiennent les noms et les valeurs de champs personnalisés qui servent à personnaliser les campagnes, et ils rejoignent des listes de contacts, les listes auxquelles les campagnes sont envoyées. Cette page explique comment ces éléments s’articulent et ce que vous pouvez faire avec les contacts dans le tableau de bord et via l’API.

## Contacts, listes et abonnés

Emailit sépare les personnes et les listes. Une personne existe une seule fois en tant que contact, et chaque liste dont elle fait partie correspond à un enregistrement d’abonné distinct, avec son propre état d’inscription.

| | Contact | Liste | Abonné |
| --- | --- | --- | --- |
| **Nature** | Une personne | Une liste nommée à laquelle vous envoyez des campagnes | L’appartenance d’un contact à une liste |
| **Préfixe d’ID** | `con_` | `aud_` | `sub_` |
| **Unicité** | Adresse e-mail, par espace de travail | Nom, par espace de travail | Un par contact et par liste |
| **Contenu** | Adresse e-mail, prénom, nom, champs personnalisés, statut marketing | Nom, nombre d’abonnés, URL d’inscription | Un indicateur **Subscribed** avec les dates d’inscription et de désinscription |
| **Suppression** | Retire aussi le contact de toutes les listes | Supprime tous ses abonnés. Les contacts restent. | Supprime cette appartenance. Le contact reste. |

```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 pratique :

- Un contact peut être abonné à de nombreuses listes, avec un indicateur **Subscribed** distinct dans chacune.
- Ajouter une personne à une liste par son adresse e-mail crée d’abord le contact s’il n’existe pas encore.
- Les noms et les champs personnalisés sont stockés sur le contact. Les modifier depuis une liste modifie le contact : le changement apparaît donc partout.

### Qui reçoit une campagne

Une campagne est envoyée à chaque contact qui remplit les trois conditions suivantes :

1. Le contact est abonné à au moins une des listes de la campagne, avec **Subscribed** activé.
2. Le statut marketing du contact est **Subscribed**.
3. L’adresse ne figure pas dans votre [liste d’adresses bloquées](/fr/docs/suppressions/).

Un contact présent dans plusieurs des listes sélectionnées reçoit un seul exemplaire. Pour les règles complètes, consultez [Créer une campagne](/fr/docs/campaigns/create/).

## Statut marketing

Chaque contact a aussi un **statut marketing** valable pour tout l’espace de travail : **Subscribed** ou **Unsubscribed** (le champ `unsubscribed` dans l’API). Il s’agit d’une désinscription globale, qui prime sur l’indicateur propre à chaque liste.

| Ce que vous modifiez | Comment | Effet sur les campagnes |
| --- | --- | --- |
| Statut marketing | Action groupée **Unsubscribe** ou **Resubscribe** dans la liste Contacts, ou `unsubscribed` dans l’API | Les contacts **Unsubscribed** sont ignorés dans toutes les listes. Leurs appartenances aux listes ne changent pas. |
| L’abonnement à une liste | **Unsubscribe** ou **Resubscribe** sur la page du contact ou dans la liste, ou `subscribed` sur l’abonné | Le contact est ignoré uniquement pour les campagnes envoyées à cette liste. |
| Le destinataire clique sur le lien de désinscription | La page de désinscription hébergée | Le contact est désinscrit de toutes les listes dont il fait partie. |

Le statut marketing et les abonnements aux listes ne concernent que les campagnes. Ils ne bloquent pas les e-mails que vous envoyez via l’API ou SMTP, ni les e-mails envoyés par les automatisations. Pour arrêter tous les e-mails vers une adresse, ajoutez-la à vos [adresses bloquées](/fr/docs/suppressions/). La page [Désinscriptions](/fr/docs/audiences/unsubscribes/) décrit toutes les façons de se désinscrire.

## La liste Contacts

Ouvrez **Email Marketing → Contacts** pour voir tous les contacts de l’espace de travail, du plus récent au plus ancien.

- **Colonnes.** **Email** est toujours affichée. Affichez ou masquez **First name**, **Last name**, **Audiences**, **Created** et **Updated** sous **Display options > Edit columns**, ou sélectionnez **Show full name** pour fusionner les noms en une seule colonne **Name**. Dans la colonne **Audiences**, le badge de chaque liste est vert tant que le contact y est abonné et rouge après sa désinscription.
- **La recherche** porte sur l’adresse e-mail, le prénom et le nom.
- **Filtrez** par Email, Name, First name, Last name, Unsubscribed, Created, Updated, Audiences ou Audience, et par n’importe quel [champ personnalisé](/fr/docs/contacts/custom-fields/). Avec deux filtres ou plus, choisissez s’il faut qu’ils correspondent tous ou au moins l’un d’eux.
- **Triez** en sélectionnant un en-tête de colonne.
- **Import** et **Export** font entrer et sortir des contacts sous forme de fichiers. Consultez [Importer et exporter des contacts](/fr/docs/contacts/import-export/).

Sélectionnez une ligne pour ouvrir le contact. Le menu de la ligne propose **Edit** et **Delete**.

### Ajouter un contact

Sélectionnez **Add contact** et saisissez l’**Email** et, si vous le souhaitez, **First name**, **Last name** et **Audiences**. Sélectionnez **Show custom fields** pour renseigner les valeurs des champs personnalisés. Une adresse e-mail ne peut exister qu’une fois par espace de travail : l’ajout d’une adresse existante échoue donc.

Pour modifier un contact plus tard, sélectionnez **Edit**. Vous pouvez modifier les noms et les champs personnalisés. L’adresse e-mail ne peut pas être modifiée dans le tableau de bord. Utilisez plutôt le champ `email` de [Mettre à jour un contact](/fr/docs/api-reference/contacts/update/).

### Actions groupées

Sélectionnez des contacts avec les cases à cocher (la case de l’en-tête sélectionne toute la page), puis ouvrez **Actions**. Chaque action s’applique à 100 contacts au maximum à la fois.

| Action | Effet |
| --- | --- |
| **Add to audience** | Ajoute les contacts à la liste choisie. Les appartenances existantes restent inchangées. Les contacts dont le statut marketing est **Unsubscribed** la rejoignent en tant qu’abonnés désinscrits. |
| **Remove from audience** | Supprime leur appartenance à la liste choisie. Les contacts restent. |
| **Unsubscribe** | Passe leur statut marketing à **Unsubscribed**. |
| **Resubscribe** | Repasse leur statut marketing à **Subscribed**. Les abonnements aux listes ne changent pas. |
| **Delete** | Supprime les contacts et toutes leurs appartenances. Cette action est irréversible. |

## La page d’un contact

La page d’un contact affiche tout ce qu’Emailit sait d’une personne. Utilisez **Edit** et **Delete** en haut de la page.

| Section | Contenu |
| --- | --- |
| **Details** | Adresse e-mail, prénom, nom, statut marketing, dates de création et de mise à jour. |
| **Custom fields** | Chaque champ personnalisé défini dans l’espace de travail et la valeur du contact. |
| **Metrics and Insights** | **Emails sent**, **Loads**, **Clicks**, **Last activity**, **Subscribed audiences** (listes abonnées sur le total) et **Marketing status**. Les compteurs incluent tous les e-mails sortants envoyés à l’adresse, pas seulement les campagnes. |
| **Audiences** | Chaque liste dont le contact fait partie, avec son statut et ses dates d’inscription et de désinscription. Le menu de la ligne permet de désinscrire (**Unsubscribe**) ou de réinscrire (**Resubscribe**) le contact pour cette liste, ou de l’en retirer (**Remove from audience**). **Add to audience** ajoute une nouvelle appartenance. |
| **Sent emails** | Les e-mails sortants envoyés à l’adresse, avec l’objet, le statut, la campagne, les chargements, les clics et l’heure d’envoi. |
| **Activity log** | Une chronologie des événements du contact, comme « Contact created », « Added to Newsletter », « Unsubscribed from Newsletter » et « Email delivered ». |

## Utiliser l’API

L’[API des contacts](/fr/docs/api-reference/contacts/) couvre tout ce que font la liste et la fiche, sauf l’import de fichiers :

- [Créez](/fr/docs/api-reference/contacts/create/), [récupérez](/fr/docs/api-reference/contacts/get/), [mettez à jour](/fr/docs/api-reference/contacts/update/), [listez](/fr/docs/api-reference/contacts/list/) et [supprimez](/fr/docs/api-reference/contacts/delete/) des contacts. Partout où un ID est attendu, vous pouvez transmettre l’adresse e-mail du contact au lieu de son ID `con_`.
- Transmettez `audiences` (un tableau d’ID `aud_`) à la création d’un contact pour l’inscrire immédiatement. Lors d’une mise à jour, `audiences` remplace les appartenances du contact.
- [Exécutez une action groupée](/fr/docs/api-reference/contacts/bulk/) sur 100 contacts au maximum, et [exportez](/fr/docs/api-reference/contacts/export/) jusqu’à 10 000 contacts en CSV ou 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"]
  }'
```

Créer un contact avec une adresse e-mail qui existe déjà renvoie `409` avec le contact existant dans `existing`. L’API des contacts nécessite une clé API **Full Access**.

Les modifications de contacts produisent les événements [`contact.created`, `contact.updated` et `contact.deleted`](/fr/docs/webhooks/events/contact/), et les modifications d’appartenance produisent les événements [`subscriber.*`](/fr/docs/webhooks/events/subscriber/), que vous pouvez recevoir avec des [webhooks](/fr/docs/webhooks/).

## Étapes suivantes

  - [Champs personnalisés](/fr/docs/contacts/custom-fields/): Stockez des données supplémentaires sur les contacts et utilisez-les dans les filtres et les e-mails.
  - [Import et export](/fr/docs/contacts/import-export/): Importez des contacts depuis un fichier CSV ou Excel, et téléchargez-les.
  - [Listes de contacts](/fr/docs/audiences/): Regroupez les contacts dans des listes auxquelles envoyer des campagnes.
  - [Désinscriptions](/fr/docs/audiences/unsubscribes/): Comment fonctionnent les désinscriptions et comment les respecter.

---
Source: https://emailit.com/fr/docs/contacts/