Vue d’ensemble
Listes de contacts
Les listes de contacts sont les listes auxquelles vos campagnes sont envoyées. Créez, fusionnez et archivez des listes, gérez les abonnés, configurez le double opt-in et un nom public, et utilisez les listes via l’API.
Une liste de contacts est un ensemble nommé de contacts, comme « Newsletter » ou « Nouveautés produit ». Vous choisissez une ou plusieurs listes comme destinataires d’une campagne, et vous pouvez ajouter des personnes à une liste manuellement, par import, via l’API ou avec une URL d’inscription hébergée.
Fonctionnement des listes de contacts
Chaque personne d’une liste est un abonné : un lien entre un contact et la liste, avec son propre indicateur Subscribed. Un même contact peut figurer dans plusieurs listes, être abonné à certaines et désinscrit d’autres.
- Les campagnes sont envoyées aux abonnés dont l’indicateur Subscribed est activé, dont le contact n’est pas désinscrit de toutes les listes et dont l’adresse n’est pas bloquée. Un contact présent dans plusieurs des listes sélectionnées reçoit un seul exemplaire.
- La désinscription désactive l’indicateur mais conserve l’abonné dans la liste, ce qui préserve l’historique. Consultez Désinscriptions.
- Supprimer un abonné retire la personne de la liste. Le contact reste dans votre espace de travail.
La page Audiences
Accédez à Email MarketingAudiences pour voir vos listes avec leur Name, leur Visibility, leurs Subscribers et leur date Created. Sous le nom figure le nom public lorsqu’il est différent, et Visibility affiche Public ou Private, ainsi qu’un badge Double opt-in lorsque celui-ci est activé. La colonne Subscribers indique le nombre d’abonnés de chaque liste par rapport à la limite de votre forfait, par exemple 1.2k/10k. Toutes les colonnes peuvent être triées.
Le menu de la ligne propose Manage subscribers, Rename, Merge into another audience, Archive et Delete. Pour agir sur plusieurs listes, sélectionnez-les et utilisez Actions : Merge, Archive (ou Unarchive dans l’onglet Archived) et Delete.
Pour en créer une, sélectionnez Create audience, saisissez un Name et sélectionnez Create. Les noms doivent être uniques dans l’espace de travail.
Archiver une liste
Archivez les listes que vous n’utilisez plus pour faire le tri sans rien perdre. Une liste archivée passe dans l’onglet Archived et :
- conserve tous ses abonnés,
- n’apparaît plus dans les sélecteurs de listes des campagnes, des formulaires, des automatisations et des contacts,
- ne figure pas sur la page de gestion des abonnements, sauf pour les personnes qui y sont encore abonnées,
- n’accepte plus d’inscriptions via son URL d’inscription, qui renvoie
404.
Les campagnes, les formulaires et les automatisations qui l’utilisent déjà continuent de fonctionner. Sélectionnez Unarchive pour la rétablir.
Fusionner des listes
La fusion copie les abonnés d’une ou de plusieurs listes dans une autre. Sélectionnez les listes et choisissez Actions > Merge, puis choisissez la liste cible, ou utilisez Merge into another audience dans le menu d’une ligne. Sur la page d’une liste, Merge audiences into this one dans le menu fait la même chose dans l’autre sens.
- Les personnes qui figurent déjà dans la liste cible y conservent leur statut : aucune personne désinscrite n’est donc réinscrite.
- Une personne présente dans plusieurs des listes fusionnées est abonnée si au moins l’une de ces listes la compte comme abonnée.
- Avec Delete the merged audiences afterwards, les listes fusionnées et leurs inscriptions sont supprimées, et les campagnes dont l’envoi à ces listes n’est pas terminé sont envoyées à la liste cible à la place. Les segments qui puisent dans une liste fusionnée, ou qui ont une règle portant sur elle, utilisent eux aussi la liste cible à la place, de même que les automatisations qui démarrent à partir d’elle, y ajoutent des personnes, la vérifient dans une condition ou font sortir les contacts qui la quittent. C’est aussi le cas des formulaires qui y ajoutent des personnes ou la proposent comme choix, des liens de double opt-in qui n’ont pas encore été confirmés et des exécutions d’automatisation qui attendent une condition portant sur elle.
La fusion n’envoie pas d’événements subscriber.*, ne démarre pas d’automatisations et n’envoie pas d’e-mails de double opt-in ni de confirmation. Les segments avec suivi mettent ensuite à jour leurs membres. La limite d’abonnés de la liste cible s’applique : une fusion qui la dépasserait n’ajoute personne.
La page d’une liste
Ouvrez une liste pour gérer ses abonnés. L’en-tête affiche le nombre d’abonnés et le badge de limite, avec ces actions :
| Action | Effet |
|---|---|
| Subscribe URL | Affiche l’URL d’inscription de cette liste et permet de la réinitialiser. Voir URL d’inscription. |
| Import | Importe un fichier CSV ou Excel directement dans cette liste. Voir Importer des abonnés. |
| Add subscriber | Ajoute une personne à partir de son adresse e-mail. Remplacé par Upgrade quand une liste sur Pay as you go est pleine. |
| Settings (dans le menu) | Ouvre l’onglet Settings. |
| Merge audiences into this one (dans le menu) | Copie les abonnés d’autres listes dans celle-ci. Voir Fusionner des listes. |
| Archive (dans le menu) | Archive la liste, ou la désarchive. Voir Archiver une liste. |
| Create segment (dans le menu) | Crée un nouveau segment avec cette liste comme source. Les segments sont en alpha et réservés à l’équipe Emailit. |
| Delete (dans le menu) | Supprime la liste et tous ses abonnés. Les contacts restent dans votre espace de travail. Cette action est irréversible. |
L’onglet Subscribers liste les personnes de la liste, avec les vues All, Engaged et Unengaged, des colonnes triables, une recherche, des filtres et des actions en masse. Consultez Gérer les abonnés.
L’onglet Settings regroupe :
- Name and visibility : le nom interne, le nom public et la description que voient les abonnés, et la visibilité de la liste, publique ou privée, sur la page de gestion des abonnements.
- Double opt-in et Confirmation email : consultez Double opt-in et e-mails de confirmation.
- Unengaged contacts : consultez Contacts inactifs.
Limites
Chaque forfait limite le nombre d’abonnés qu’une liste peut contenir. Le nombre de listes n’est pas limité.
| Pay as you go | Pro | Business | Custom | |
|---|---|---|---|---|
| Abonnés par liste | 10 000 | 50 000 | 250 000 | Illimité |
La limite compte tous les abonnés de la liste, y compris les personnes désinscrites. Pour faire de la place, supprimez les abonnés dont vous n’avez plus besoin, passez à un forfait supérieur ou demandez une limite plus élevée à support@emailit.com.
Quand une liste est pleine, Add subscriber est désactivé et tout ajout de personnes, y compris via l’API, les imports et l’URL d’inscription, est rejeté avec 422 et un message comme « Pro includes 50,000 subscribers per audience. ». L’erreur de l’API inclut l’objet usage actuel :
{
"error": "Pro includes 50,000 subscribers per audience.",
"usage": { "used": 50000, "limit": 50000, "plan": "pro" }
}Utiliser l’API
L’API des listes permet de créer, récupérer, mettre à jour, lister, fusionner, modifier en masse et supprimer des listes, et l’API des abonnés gère les personnes qui y figurent. Vous pouvez utiliser le nom d’une liste au lieu de son ID aud_ dans l’URL. L’API nécessite une clé API 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" }'Les réponses portant sur une liste incluent les paramètres (visibility, public_name, public_description, double_opt_in, confirmation_email, unengaged, archived, archived_at), subscribers_count et un objet usage avec used, limit et plan. La création, la récupération et la mise à jour d’une liste renvoient aussi son token, la partie secrète de son URL d’inscription. Un nom en double renvoie 409. L’endpoint de liste omet les listes archivées, sauf si vous transmettez archived=true ou archived=all.
Événements
Les modifications des listes et des abonnés produisent des événements que vous pouvez recevoir avec des webhooks et qui démarrent des automatisations :
| Événement | Déclenché lorsque |
|---|---|
audience.created, audience.updated, audience.deleted |
Une liste est créée, modifiée (archivage compris) ou supprimée. La suppression d’une liste n’envoie pas d’événement pour chacun de ses abonnés. |
subscriber.created |
Une personne est ajoutée à une liste depuis le tableau de bord, l’API, l’URL d’inscription, un formulaire, un lien de double opt-in ou la page de gestion des abonnements. Démarre les automatisations Added to audience. |
subscriber.updated |
Les informations d’un abonné ou son indicateur Subscribed changent. |
subscriber.deleted |
Un abonné est retiré. Démarre les automatisations Removed from audience. |
Les imports et les fusions n’envoient pas d’événements d’abonné.