Vue d’ensembleBêta
Automatisations
Les automatisations exécutent des étapes, comme envoyer un e-mail, attendre ou mettre à jour un contact, quand un déclencheur s’active. Contextes, statuts, exécutions, crédits et API.
Une automatisation est un workflow qui démarre tout seul : quand un déclencheur s’active, par exemple lorsqu’un contact rejoint une liste ou qu’un e-mail rebondit, Emailit démarre une exécution qui parcourt les étapes que vous avez reliées, comme envoyer un e-mail, attendre un jour ou mettre à jour le contact. Utilisez les automatisations pour les e-mails de bienvenue, les séquences d’onboarding, les e-mails d’anniversaire, le transfert et les alertes.
Fonctionnement
- Un déclencheur s’active. Chaque automatisation commence par un déclencheur, par exemple Added to audience. Des filtres facultatifs en restreignent la portée.
- Emailit démarre une exécution pour le contact ou l’e-mail qui l’a provoquée, et débite 3 crédits.
- L’exécution parcourt les étapes reliées au déclencheur, l’une après l’autre. Les étapes Wait mettent l’exécution en pause, et les étapes Condition l’envoient sur une branche Yes ou No.
- L’exécution se termine lorsqu’elle atteint la dernière étape de sa branche, ou échoue si une étape échoue.
Vous construisez le flux sur un canevas dans le tableau de bord, ou vous l’envoyez à l’API sous forme de liste d’étapes et de connexions. Consultez Déclencheurs et Étapes.
Contextes
Chaque automatisation a un contexte, qui détermine l’objet d’une exécution et les déclencheurs et étapes disponibles. Vous le choisissez à la création de l’automatisation, et il ne peut plus être modifié ensuite.
| Contexte | Libellé | Chaque exécution porte sur | Idéal pour | Déclencheurs |
|---|---|---|---|---|
| Contact | Easy | Un contact | Séries de bienvenue, onboarding, réengagement | Appartenance à une liste, modifications du contact, anniversaires de dates |
| Medium | Un e-mail | Traitement des réponses, transferts automatiques, alertes de rebond | Événements d’e-mail, comme livré, rebondi ou reçu | |
| Event | Advanced | Un appel API | Flux pilotés par l’API, intégrations personnalisées | Un déclencheur manuel que vous appelez avec l’API |
Dans le tableau de bord, le contexte Event affiche un badge Soon et ne peut pas encore être sélectionné. Vous pouvez créer des automatisations Event avec l’API.
Créer une automatisation
-
Commencez. Accédez à Email MarketingAutomations et sélectionnez New automation.
-
Choisissez le contexte. Choisissez Contact ou Email.
-
Choisissez un modèle. Choisissez l’une des recettes prêtes à l’emploi ou Start from scratch pour un canevas vierge ne contenant qu’un déclencheur.
-
Nommez-la. Saisissez un Name et une Description facultative, puis sélectionnez Create. L’automatisation s’ouvre en brouillon.
-
Construisez le flux. Dans l’onglet Editor, sélectionnez le déclencheur et chaque étape pour les configurer, et ajoutez des étapes avec les boutons plus. Sélectionnez Save.
-
Démarrez-la. Sélectionnez Start. Désormais, chaque déclencheur correspondant démarre une exécution.
La page de liste comporte des onglets pour les automatisations Contact, Email et Event, et affiche pour chacune les colonnes Name, Status, Last triggered et Created.
Statuts
| Statut | Les déclencheurs démarrent des exécutions | Modifiable dans le tableau de bord | Comment y parvenir |
|---|---|---|---|
| Draft | Non | Oui | Toute nouvelle automatisation commence en brouillon. |
| Running | Oui | Non | Démarrez (Start) un brouillon ou une automatisation en pause. |
| Paused | Non | Oui | Mettez en pause (Pause) une automatisation en cours. Start la reprend. |
| Stopped | Non | Non | Uniquement avec l’endpoint stop de l’API, qui annule aussi toutes les exécutions en cours. |
La mise en pause empêche le démarrage de nouvelles exécutions, mais les exécutions déjà en cours continuent, y compris celles qui attendent dans une étape Wait. Delete, dans le menu en haut de l’automatisation, la supprime quel que soit son statut.
Règles de modification
L’onglet Editor n’est disponible que lorsque l’automatisation est en brouillon ou en pause. Sur une automatisation en cours, l’onglet affiche Pause to edit.
Save vérifie l’ensemble du flux et met en évidence les étapes à corriger, par exemple une étape Send email sans modèle ou une attente de plus de 30 jours. Corrigez-les et enregistrez de nouveau avant de sélectionner Start : le démarrage ne relance pas les vérifications.
Exécutions
Une exécution est un passage dans l’automatisation pour un contact, un e-mail ou un appel API. Chaque exécution a un statut :
| Statut d’exécution | Signification |
|---|---|
| Running | L’exécution parcourt ses étapes ou attend. |
| Completed | Toutes les étapes du chemin de l’exécution sont terminées. |
| Failed | Une étape a échoué, ou l’espace de travail n’avait pas assez de crédits au démarrage de l’exécution. |
| Canceled | L’automatisation a été arrêtée avec l’API pendant l’exécution. |
Par défaut, chaque déclencheur démarre une nouvelle exécution, même si le même contact ou le même e-mail en a déjà une en cours. Un même événement ne démarre jamais deux exécutions d’une même automatisation. Pour l’historique des exécutions et le débogage, consultez Exécutions et statistiques.
Crédits
| Action | Crédits |
|---|---|
| Chaque exécution | 3, débités au démarrage de l’exécution |
| Chaque e-mail envoyé par une étape Send email | 1 |
| Chaque e-mail envoyé par une étape Forward email | 1 |
Si l’espace de travail n’a pas 3 crédits quand un déclencheur s’active, l’exécution est créée avec le statut Failed et la raison insufficient_credits dans son meta. Si les crédits s’épuisent au milieu d’une exécution, l’étape Send email ou Forward email échoue. Consultez Crédits.
Utiliser l’API
L’API des automatisations gère les automatisations et lit leurs exécutions. Elle nécessite une clé API Full Access.
| Endpoint | Utilisation |
|---|---|
| Créer, mettre à jour, récupérer, lister et supprimer | Gérer les automatisations. Les étapes et les connexions sont envoyées ensemble. |
| Démarrer, mettre en pause et arrêter | Changer le statut. |
| Déclencher une exécution | Activer un déclencheur Manual, avec un payload facultatif. L’automatisation doit être en cours. Ce n’est possible qu’avec l’API. |
| Lister les exécutions, récupérer une exécution, statistiques et statistiques par étape | Lire l’historique des exécutions et les résultats par étape. |
L’API accepte aussi des settings d’automatisation que le tableau de bord n’affiche pas encore :
| Paramètre | Par défaut | Effet |
|---|---|---|
allow_reentry |
true |
Réglez sur false pour ignorer les nouvelles exécutions d’un contact ou d’un e-mail qui a déjà une exécution en cours. |
max_concurrent_runs |
0 (sans limite) |
Ignore les nouvelles exécutions tant que ce nombre d’exécutions est en cours. |
cooldown_seconds |
0 |
Ignore les nouvelles exécutions d’un contact ou d’un e-mail qui a démarré une exécution au cours de ce nombre de secondes. |
on_step_failure |
stop |
stop fait échouer l’exécution quand une étape échoue. skip laisse l’exécution continuer. |
Les exécutions ignorées ne sont pas créées et ne consomment pas de crédits.
curl https://api.emailit.com/v2/automations \
-X POST \
-H "Authorization: Bearer $EMAILIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"context": "contact",
"name": "Welcome email",
"settings": { "allow_reentry": false },
"steps": [
{ "key": "trigger-1", "type": "trigger", "trigger": "contact.added_to_audience", "config": { "audience_id": "aud_5hJ2kL8mNp4Qr" } },
{ "key": "send_email-1", "type": "action", "action": "send_email", "config": { "type": "template", "template_id": "welcome" } }
],
"connections": [
{ "from": "trigger-1", "to": "send_email-1", "branch": "default" }
]
}'L’automatisation est créée en brouillon. Appelez Démarrer une automatisation pour l’activer.