Déclencheurs d’automatisation

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.
• 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.

Filtres

Contact updated et tous les déclencheurs d’e-mail acceptent un filtre facultatif, sous Filter events (optional). 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 ou link.url.

Déclencheurs de contact

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), ou avec l’action groupée Add to audience. 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, une inscription par URL d’inscription ou l’étape Add to audience ou Create contact d’une autre automatisation, et réactiver Subscribed pour un abonné existant 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é, ou une mise à jour de contact dont la liste audiences omet la liste. 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.

Contact updated

S’active chaque fois qu’un contact est mis à jour dans le tableau de bord ou avec l’API, y compris par les actions groupées Unsubscribe et Resubscribe. 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.

Date anniversary

Choisissez un Date field, un champ personnalisé de type date, comme une date d’anniversaire. Une fois par jour, Emailit démarre une exécution pour chaque contact dont la date correspond au mois et au jour courants, en UTC. L’année n’a pas d’importance : un contact avec 1990-04-12 obtient donc une exécution chaque 12 avril. Chaque automatisation traite au maximum 10 000 contacts par jour.

Déclencheurs de contact réservés à l’API

L’API accepte aussi contact.visits_url, contact.on_purchase et contact.on_event, mais rien ne les active encore.

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.

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.

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. 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 ou les valeurs de Edit contact, peuvent contenir des variables remplacées pour chaque exécution :

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

Voir aussi