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.
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.
Email opened et Link clicked
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 (
daysouweeks) et When (before the dateouafter the date), par exemple 3 jours avant un renouvellement.0correspond au jour même. - At time (par défaut
00:00) dans Timezone (un nom IANA commeEurope/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-12dé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 :
purchasecorrespond àc:purchaseet à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 :
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.