Contacts

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.

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.

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.

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.

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. La page Désinscriptions 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é. 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.

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.

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.

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.

Utiliser l’API

L’API des contacts couvre tout ce que font la liste et la fiche, sauf l’import de fichiers :

• Créez, récupérez, mettez à jour, listez et supprimez 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 sur 100 contacts au maximum, et exportez jusqu’à 10 000 contacts en CSV ou 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"]
  }'

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, et les modifications d’appartenance produisent les événements subscriber.*, que vous pouvez recevoir avec des webhooks.

Étapes suivantes