Listes de contacts

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 Marketing›Audiences pour voir vos listes avec leur Name, leurs Subscribers et leur date Created. La colonne Subscribers indique le nombre d’abonnés de chaque liste par rapport à la limite de votre forfait, par exemple 1.2k/10k. Utilisez le menu de la ligne pour gérer les abonnés (Manage subscribers), renommer (Rename) ou supprimer (Delete) une liste.

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.

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 :

En dessous, le tableau des abonnés affiche Email, First name, Last name, Subscribed et Created, avec une recherche, des filtres et un menu de ligne pour modifier (Edit) ou supprimer (Delete) chaque abonné. Consultez Gérer les abonnés.

Limites

Chaque forfait limite le nombre d’abonnés qu’une liste peut contenir. Le nombre de listes n’est pas limité.

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 avec Request Increase sur la carte Sending Limits de la page d’accueil du tableau de bord.

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, renommer, lister 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 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.

É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 :

Les imports et l’URL d’inscription n’envoient pas d’événements d’abonné.

Étapes suivantes