Aller au contenu
Docs

Référence

Déclencheurs d’automatisation

Référence de tous les déclencheurs d’automatisation par contexte, avec leurs options et leurs filtres, ce qui les active et les clés de déclencheur à utiliser avec l’API.

Mis à jour le 20 nov. 2026

Un déclencheur détermine quand une automatisation démarre une exécution. Cette page liste tous les déclencheurs disponibles dans chaque contexte, ce qui les active, leurs options et la clé à utiliser dans l’API.

Fonctionnement des déclencheurs

  • Un seul déclencheur par automatisation dans le tableau de bord. Sélectionnez le déclencheur sur le canevas et changez-le avec Trigger type. Avec l’API, les automatisations Contact et Email peuvent avoir plusieurs déclencheurs, à condition qu’ils soient tous reliés à la même première étape. Les automatisations Event en ont exactement un. Chaque déclencheur activé démarre sa propre exécution, donc une seule inscription peut en démarrer deux : un formulaire qui ajoute le contact à une liste active Form submitted et Added to audience en même temps. Pour une seule exécution, dans l’onglet Settings, réglez Same contact again while a run is in progress sur Don’t start another run (allow_reentry: false).
  • L’automatisation doit être en cours. Les déclencheurs des automatisations en brouillon, en pause ou arrêtées sont ignorés. Les événements antérieurs au démarrage d’une automatisation ne démarrent pas d’exécution par la suite.
  • Les exécutions démarrent en quelques secondes. Emailit récupère les nouveaux événements toutes les quelques secondes. Les déclencheurs de date sont vérifiés toutes les 5 minutes.
  • Les automatisations Contact ont besoin d’un contact. Un événement qui ne peut pas être rattaché à un contact de l’espace de travail, comme une ouverture par une adresse qui n’est pas un contact, ne démarre pas d’exécution.
  • Les automatisations peuvent se démarrer entre elles. Les modifications effectuées par une étape, comme l’ajout d’un tag ou l’ajout d’un contact à une liste, activent les déclencheurs d’autres automatisations. Une automatisation ne se démarre jamais elle-même de cette façon, et une chaîne d’automatisations qui se démarrent les unes les autres s’arrête après 5 maillons.

Filtres

Contact updated, Custom event, Placed an order, Abandoned a cart, Viewed a product, Product back in stock et tous les déclencheurs d’e-mail acceptent un filtre facultatif. Chaque règle compare un champ de l’événement à une valeur :

  • Opérateurs : Equals, Not equals, Contains, Not contains, Greater than, Less than, Is set, Is not set, In, Not in, Starts with et Ends with. Greater than et Less than comparent des nombres. Les autres comparent du texte et sont sensibles à la casse.
  • Mode de correspondance : All rules match ou Any rule matches.

Avec l’API, un filtre s’écrit { "match": "all", "rules": [{ "field": "...", "operator": "equals", "value": "..." }] } dans le config.filter du déclencheur, avec match réglé sur all ou any. Les champs sont des chemins dans l’objet de l’événement, par exemple to, link.url ou, pour un événement personnalisé, properties.total. Pour vérifier le contact lui-même (tags, listes, score), ajoutez une étape Condition après le déclencheur.

Déclencheurs de contact

Déclencheur Clé API Options Démarre une exécution quand
Added to audience contact.added_to_audience Audience. Laissez vide pour n’importe quelle liste. Un contact rejoint la liste, ou y est ajouté de nouveau après s’être désinscrit.
Removed from audience contact.removed_from_audience Audience. Laissez vide pour n’importe quelle liste. L’appartenance d’un contact à la liste est supprimée.
Added to segment contact.added_to_segment Tracked segment (obligatoire), et inclusion ou non des membres actuels Un contact commence à correspondre à un segment avec suivi.
Removed from segment contact.removed_from_segment Tracked segment (obligatoire) Un contact cesse de correspondre à un segment avec suivi.
Contact created contact.created Aucune Un contact est créé.
Contact updated contact.updated Field that changed, filtre facultatif Les champs, les champs personnalisés, les tags, le score ou le statut marketing d’un contact changent.
Tag added contact.tag_added Tag. Laissez vide pour n’importe quel tag. Le contact reçoit le tag.
Tag removed contact.tag_removed Tag. Laissez vide pour n’importe quel tag. Le tag est retiré du contact.
Score changed contact.score_changed Crosses et Direction Le score de lead du contact change, ou franchit un seuil.
Unsubscribed contact.unsubscribed Audience. Laissez vide pour n’importe quelle liste. Le contact se désinscrit d’une liste, ou de tous les e-mails marketing.
Email opened contact.loaded_email Uniquement les e-mails envoyés par cette automatisation Le contact charge un e-mail suivi envoyé à son adresse.
Link clicked contact.clicked_in_email Link contains, uniquement les e-mails envoyés par cette automatisation Le contact clique sur un lien suivi dans un e-mail envoyé à son adresse.
Date in contact field contact.on_date Date field, décalage, heure, fuseau horaire, Repeat Une date enregistrée sur le contact arrive, ou se trouve à un nombre de jours donné.
Date anniversary contact.date_anniversary Date field, décalage, heure, fuseau horaire Chaque année, au mois et au jour d’une date enregistrée sur le contact.
Custom event contact.on_event Event name. Laissez vide pour n’importe quel événement. Votre application envoie un événement d’espace de travail ou un événement personnalisé pour le contact avec l’API des événements, comme un achat. Forfaits Business et Custom.
Form submitted form.submitted Form. Laissez vide pour n’importe quel formulaire. Une personne envoie un formulaire avec une adresse e-mail.
Placed an order contact.on_purchase Filtre facultatif Un contact passe une nouvelle commande.
Abandoned a cart contact.abandoned_cart Filtre facultatif Le panier d’un contact est abandonné.
Viewed a product contact.viewed_product Filtre facultatif Un contact consulte un produit sur votre site.
Product back in stock contact.back_in_stock Filtre facultatif Un produit qu’un contact a demandé est de nouveau disponible.

Added to audience

S’active quand une personne est ajoutée à une liste depuis le tableau de bord (Add subscriber, Add to audience, Add contact avec des listes), avec l’API (Ajouter un abonné, ou Créer un contact avec audiences), avec l’action groupée Add to audience, ou par l’étape Add to audience, Subscribe / unsubscribe ou Create contact d’une autre automatisation. Ajouter de nouveau une personne qui s’était désinscrite l’active aussi.

Il ne s’active pas pour les contacts ajoutés par un import de fichier ou une inscription par URL d’inscription, et réactiver Subscribed pour un abonné existant dans le tableau de bord ne compte pas non plus.

Removed from audience

S’active quand un abonné est supprimé : Delete sur la page de la liste, Remove from audience, Supprimer un abonné, une mise à jour de contact dont la liste audiences omet la liste, ou l’étape Remove from audience d’une autre automatisation. Supprimer un contact l’active une fois pour chaque liste à laquelle le contact appartenait. Une désinscription ne l’active pas, car la personne reste dans la liste ; utilisez Unsubscribed dans ce cas.

Pour arrêter les exécutions d’une séquence quand le contact quitte sa liste, vous n’avez pas besoin d’une deuxième automatisation : activez Leave when removed or unsubscribed from the audience that started the run dans l’onglet Settings. Consultez Conditions de sortie et objectifs.

Déclencheurs de segment

Added to segment et Removed from segment s’activent quand un contact entre dans un segment avec suivi ou en sort. Comme les segments, ces déclencheurs sont en alpha et réservés à l’équipe Emailit. Choisissez le segment sous Tracked segment. Seuls les segments avec suivi sont listés et acceptés, car les autres segments n’enregistrent pas les entrées et les sorties.

  • Quand ils s’activent. Quand un contact change, ses segments sont vérifiés de nouveau, et les exécutions démarrent généralement en moins d’une minute. Les imports et les listes supprimées sont vérifiés une fois terminés. Les règles qui évoluent avec le temps, comme Created au cours des 30 derniers jours, sont vérifiées par une synchronisation quotidienne à 0 h 30 UTC.
  • Les modifications du segment ne démarrent pas d’exécution. Les contacts qui entrent ou sortent parce que vous avez modifié la source ou les filtres du segment sont enregistrés et envoyés aux webhooks, mais ne démarrent pas d’automatisation.
  • Pas d’exécution pour le premier décompte. La création d’un segment avec suivi, ou la reprise du suivi après un passage à un forfait supérieur, enregistre les membres actuels sans démarrer d’exécution.
  • Inclure les membres actuels. Sur Added to segment, cochez Also start for contacts already in the segment when the automation is first started pour démarrer aussi une exécution pour chaque membre actuel. Cela se produit une seule fois, au premier démarrage de l’automatisation. Les paramètres de réentrée s’appliquent toujours.

Dans une exécution, {{payload.object.segment.name}} contient le nom du segment et {{payload.object.reason}} la raison de l’entrée ou de la sortie du contact : contact, schedule, ou existing_member pour les exécutions démarrées pour les membres actuels du segment.

Avec l’API, définissez config.segment_id sur l’ID seg_ du segment et, pour contact.added_to_segment, éventuellement config.include_current_members: true. Un segment utilisé par des automatisations ne peut pas être supprimé tant que vous n’avez pas modifié ces automatisations.

Contact updated

S’active chaque fois qu’un contact est mis à jour dans le tableau de bord, avec l’API ou par une étape d’automatisation, y compris lors des modifications de tags et de score et des actions groupées Unsubscribe et Resubscribe. Field that changed le limite à un seul champ, par exemple un champ personnalisé purchased que définit votre CRM. Le filtre peut vérifier les valeurs actuelles de Email, First name, Last name, Unsubscribed et des champs personnalisés, ainsi que leurs valeurs précédentes, listées sous Previous email, Previous first name, etc. Les valeurs précédentes ne sont présentes que pour les champs qui ont changé.

Par exemple, pour réagir quand un contact passe au forfait pro, ajoutez deux règles avec All rules match : custom_fields.plan Equals pro, et Previous plan (previous.custom_fields.plan) Not equals pro.

Tag added et Tag removed

S’activent quand un tag est ajouté au contact ou en est retiré, quelle que soit la voie : le tableau de bord, l’API, le serveur MCP ou une étape d’automatisation. Les tags sont comparés en minuscules : VIP et vip sont donc le même tag.

Score changed

S’active quand le score de lead du contact change. Avec Crosses défini, il ne s’active que lorsque le score franchit cette valeur : à la hausse (Going up, par défaut), l’ancien score était inférieur à la valeur et le nouveau lui est supérieur ou égal ; « les leads au-dessus de 50 entrent dans le workflow commercial » s’active donc une seule fois, et pas à chaque point. Going down s’active quand le score passe sous la valeur.

Unsubscribed

S’active quand le contact se désinscrit d’une liste (par un lien de désinscription, le tableau de bord, l’API ou une étape Subscribe / unsubscribe) ou de tous les e-mails marketing. Avec Audience défini, il ne s’active que pour cette liste, et pour les désinscriptions de tout.

S’activent quand le contact charge un e-mail suivi envoyé à son adresse ou clique dedans : campagnes, e-mails envoyés via l’API et SMTP, et e-mails d’automatisation. Le suivi nécessite les paramètres de suivi du domaine d’envoi et un CNAME de suivi vérifié. Only emails sent by this automation les limite aux e-mails de l’automatisation elle-même, et Link contains aux liens dont l’URL contient le texte, par exemple /pricing.

Pour réagir à l’ouverture ou au clic d’un e-mail que l’exécution vient d’envoyer, utilisez plutôt une étape Wait until avec Something happens. Consultez Wait until.

Date in contact field et Date anniversary

Choisissez un Date field, un champ personnalisé de type Date, comme une date de renouvellement ou une date d’anniversaire, puis le moment du démarrage :

  • Days avec Unit (days ou weeks) et When (before the date ou after the date), par exemple 3 jours avant un renouvellement. 0 correspond au jour même.
  • At time (par défaut 00:00) dans Timezone (un nom IANA comme Europe/Prague, par défaut UTC).
  • Repeat sur Date in contact field : Once, on that date ou Every year (anniversary). Date anniversary se répète toujours chaque année ; l’année du champ n’a pas d’importance : 1990-04-12 démarre donc une exécution chaque 12 avril. Les autres années, les anniversaires du 29 février démarrent le 28 février.

Emailit examine les 5 minutes à venir et démarre chaque exécution à la minute que vous avez définie. Chaque contact obtient une exécution par date (ou par an pour les anniversaires), et chaque vérification traite jusqu’à 100 000 contacts par automatisation.

Avec l’API, définissez config.date_field sur la clé du champ personnalisé, offset sur { "amount": 3, "unit": "days", "direction": "before" }, et éventuellement time, timezone et repeat: "yearly".

Custom event

Ce déclencheur est inclus dans les forfaits Business et Custom. Sur Pay as you go et Pro, une automatisation qui l’ajoute ne peut pas être enregistrée (403 avec "error": "plan_required"). Les automatisations qui l’utilisent déjà le gardent après un passage à un forfait inférieur.

S’active quand votre application envoie un événement personnalisé (événements c:) ou un événement d’espace de travail (événements w:) pour le contact avec l’API des événements. Les événements du script de suivi ne démarrent pas d’exécutions, car toute personne qui dispose de votre clé de suivi publique peut nommer n’importe quel visiteur. Nommez-le dans Event name :

  • purchase correspond à c:purchase et à w:purchase.
  • Un nom avec son préfixe, comme w:webinar.attended, ne correspond qu’à cet événement.
  • Laissez le champ vide pour démarrer sur n’importe quel événement d’espace de travail ou personnalisé.

Le champ propose les événements d’espace de travail que vous avez définis et les événements personnalisés que votre espace de travail a envoyés récemment. Sous Only when the properties match (optional), filtrez sur les propriétés de l’événement, par exemple properties.total Greater than 100. Pour un événement d’espace de travail, la liste des champs affiche ses propriétés définies.

L’événement doit désigner un contact de l’espace de travail par son ID ou son adresse e-mail. Les événements de visiteurs anonymes, ou concernant des adresses qui ne sont pas des contacts, ne démarrent pas d’exécution. Dans l’exécution, {{payload.object.properties.total}} et les variables similaires contiennent les propriétés.

Placed an order

Comme Commerce, ce déclencheur est en alpha et réservé à l’équipe Emailit. Les automatisations qui l’utilisent déjà continuent de fonctionner.

S’active une fois pour chaque nouvelle commande d’un contact, reçue par l’API des commandes ou par l’appel purchase du script de suivi. Les commandes importées comme historique et les commandes sans contact ne l’activent pas, et les mises à jour d’une commande ne l’activent pas de nouveau. Le filtre peut vérifier les champs Order total, Currency, Status, Source et Coupon codes de la commande, et les e-mails peuvent utiliser la commande sous la forme {{payload.object.total}}, {{payload.object.external_id}}, etc.

Abandoned a cart

Comme Commerce, ce déclencheur est en alpha et réservé à l’équipe Emailit. Les automatisations qui l’utilisent déjà continuent de fonctionner.

S’active chaque fois qu’un panier est abandonné : un panier d’un contact connu qui contient des articles et n’a pas changé pendant le délai défini dans les paramètres Commerce (60 minutes par défaut). Le filtre peut vérifier Cart total, Currency et Source. Dans les e-mails, {{cart}} affiche le panier : consultez Produits, coupons et panier.

Les étapes Send email d’une exécution démarrée par ce déclencheur sont ignorées dès que ce panier est devenu une commande, pour que les acheteurs ne reçoivent pas de rappel concernant ce qu’ils viennent d’acheter. Consultez la recette de panier abandonné.

L’API accepte aussi contact.visits_url, mais rien ne l’active encore.

Viewed a product

Comme Commerce, ce déclencheur est en alpha et réservé à l’équipe Emailit. Les automatisations qui l’utilisent déjà continuent de fonctionner.

Se déclenche quand un contact consulte un produit sur votre site, via la commande product du script de suivi ou le pixel Emailit sur Shopify. N’importe qui peut envoyer des consultations avec votre clé de suivi publique : seules les consultations d’un contact arrivé depuis l’un de vos e-mails (un lien signé) ou abonné à une liste le déclenchent. Le filtre peut vérifier Product ID (shop), Product title et Price. Les e-mails peuvent utiliser {{payload.object.product.title}}, ou afficher tout ce que le contact a consulté avec {{products "recently_viewed"}}.

Une visite compte généralement plusieurs consultations de produits. Pour l’abandon de navigation, réglez Wait between runs for the same contact (hours), attendez avant l’e-mail et sortez sur Placed an order, comme le fait le modèle Browse abandonment.

Product back in stock

Comme Commerce, ce déclencheur est en alpha et réservé à l’équipe Emailit. Les automatisations qui l’utilisent déjà continuent de fonctionner.

Se déclenche quand un produit qu’un contact a demandé avec le formulaire de retour en stock de votre boutique Shopify est de nouveau disponible, une fois par demande. Le filtre peut vérifier Product ID (shop), Product title et Variant ID. Les e-mails peuvent utiliser {{payload.object.product.title}}, {{payload.object.product.url}}, {{payload.object.product.image_url}} et {{payload.object.variant.title}}. Le modèle Back in stock envoie son e-mail comme e-mail transactionnel, car le contact l’a demandé.

Déclencheurs d’e-mail

Les déclencheurs d’e-mail s’activent pour les e-mails de votre espace de travail : tout ce que vous envoyez avec l’API ou SMTP, les e-mails de campagne et d’automatisation, et les e-mails entrants pour Email received. Chaque exécution porte sur un e-mail.

Déclencheur Clé API Démarre une exécution quand Champs de filtre
Email delivered email.delivered Le serveur du destinataire a accepté l’e-mail. From, To, Subject, Status
Email bounced email.bounced L’e-mail a échoué définitivement. From, To, Subject, Status
Email failed email.failed L’e-mail n’a pas pu être envoyé à cause d’une erreur. From, To, Subject, Status
Email suppressed email.suppressed L’e-mail n’a pas été envoyé car le destinataire est bloqué. From, To, Subject, Status
Email complained email.complained Le destinataire a signalé l’e-mail comme spam. From, To, Subject, Status
Email received email.received Un e-mail entrant est arrivé. Voir E-mails entrants. From, To, Subject
Email loaded email.loaded Le destinataire a chargé un e-mail suivi. Recipient, Sender, Subject, IP address, User agent
Email clicked email.clicked Le destinataire a cliqué sur un lien suivi. Recipient, Sender, Subject, Link URL, IP address, User agent

L’éditeur liste aussi Email accepted, Email scheduled, Email attempted et Email rejected. Les automatisations utilisant ces déclencheurs ne peuvent pas encore être enregistrées : choisissez donc l’un des déclencheurs ci-dessus. Avec l’API, vous pouvez aussi utiliser email.canceled, qui s’active quand un e-mail programmé ou en file d’attente est annulé.

Déclencheurs d’événement

Pour l’instant, les automatisations Event ne peuvent être créées qu’avec l’API.

Déclencheur Clé API Démarre une exécution quand
Manual trigger system.manual Vous appelez Déclencher une exécution.
Schedule system.schedule Réservé. Rien ne l’active encore : appelez plutôt l’endpoint de déclenchement depuis votre propre planificateur, comme une tâche cron.

Manual trigger

Appelez l’endpoint de déclenchement d’une automatisation en cours, avec un objet payload facultatif :

Terminal
curl https://api.emailit.com/v2/automations/aut_3Mv8Xq2nKp5Lt/trigger \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "payload": { "email": "ada@example.com", "plan": "pro" } }'

L’endpoint renvoie { "message": "Automation trigger dispatched." }, ou 422 si l’automatisation n’est pas en cours. Il ne démarre une exécution que de cette automatisation. Les étapes peuvent lire le payload sous la forme {{payload.email}}, {{payload.plan}}, etc. Emailit ajoute automation_id au payload.

system.manual fonctionne aussi comme déclencheur dans les automatisations Contact et Email créées avec l’API. Incluez contact_id (un ID con_) ou email_id dans le payload pour exécuter l’automatisation pour ce contact ou cet e-mail.

Données disponibles pour les étapes

Les paramètres des étapes, comme le destinataire de Send email, les valeurs de Update contact fields ou le corps d’un Webhook, peuvent contenir des variables remplacées pour chaque exécution :

Variable Contenu
{{contact.<field>}} Le contact de l’exécution dans les automatisations Contact, par exemple {{contact.email}}, {{contact.score}} ou {{contact.custom_fields.plan}}.
{{cf.<key>}} Un champ personnalisé du contact, par exemple {{cf.plan}}.
{{tags}} Les tags du contact, séparés par des virgules.
{{global.<key>}} Une valeur globale, par exemple {{global.webinar_date}}.
{{email.<field>}} L’e-mail de l’exécution dans les automatisations Email, par exemple {{email.rcpt_to}} ou {{email.subject}}.
{{payload.<path>}} L’événement qui a démarré l’exécution. Pour les événements de type webhook, les données de l’événement se trouvent sous payload.object, par exemple {{payload.object.to}}. Pour les déclencheurs manuels, il s’agit de votre payload.
{{meta.<path>}} Des données supplémentaires qu’Emailit enregistre sur l’exécution.
{{run.id}} L’ID de l’exécution (aur_…).

Les modèles d’e-mail envoyés par Send email utilisent Temple avec les mêmes données. Consultez Étapes.

Ce qu’une exécution peut faire une fois démarrée.
Les événements qui mettent fin à une exécution ou la déplacent.
Les événements derrière les déclencheurs de contact et d’e-mail.
Des tags et des scores pour les déclencheurs et les conditions.

Cette page vous a-t-elle été utile ?

Merci pour votre retour.

Merci, nous lisons chaque message.