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

> **Les automatisations sont en bêta:** Les automatisations fonctionnent dans tous les espaces de travail, mais certaines options sont encore en cours de finalisation. Lorsque le tableau de bord et l’API diffèrent, ces pages le précisent.

## Fonctionnement

1. **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.
2. **Emailit démarre une exécution** pour le contact ou l’e-mail qui l’a provoquée, et débite 3 crédits.
3. **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**.
4. **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](/fr/docs/automations/triggers/) et [Étapes](/fr/docs/automations/steps/).

## 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 |
| **Email** | 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

1. **Commencez.** Accédez à **Email Marketing → Automations** et sélectionnez **New automation**.

2. **Choisissez le contexte.** Choisissez **Contact** ou **Email**.

3. **Choisissez un modèle.** Choisissez l’une des [recettes prêtes à l’emploi](/fr/docs/automations/recipes/) ou **Start from scratch** pour un canevas vierge ne contenant qu’un déclencheur.

4. **Nommez-la.** Saisissez un **Name** et une **Description** facultative, puis sélectionnez **Create**. L’automatisation s’ouvre en brouillon.

5. **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**.

6. **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](/fr/docs/api-reference/automations/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](/fr/docs/automations/runs/).

## 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](/fr/docs/billing/credits/).

## Utiliser l’API

L’[API des automatisations](/fr/docs/api-reference/automations/) gère les automatisations et lit leurs exécutions. Elle nécessite une clé API **Full Access**.

| Endpoint | Utilisation |
| --- | --- |
| [Créer](/fr/docs/api-reference/automations/create/), [mettre à jour](/fr/docs/api-reference/automations/update/), [récupérer](/fr/docs/api-reference/automations/get/), [lister](/fr/docs/api-reference/automations/list/) et [supprimer](/fr/docs/api-reference/automations/delete/) | Gérer les automatisations. Les étapes et les connexions sont envoyées ensemble. |
| [Démarrer](/fr/docs/api-reference/automations/start/), [mettre en pause](/fr/docs/api-reference/automations/pause/) et [arrêter](/fr/docs/api-reference/automations/stop/) | Changer le statut. |
| [Déclencher une exécution](/fr/docs/api-reference/automations/trigger/) | 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](/fr/docs/api-reference/automations/runs/), [récupérer une exécution](/fr/docs/api-reference/automations/run/), [statistiques](/fr/docs/api-reference/automations/stats/) et [statistiques par étape](/fr/docs/api-reference/automations/step-stats/) | 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.

```bash
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](/fr/docs/api-reference/automations/start/) pour l’activer.

## Étapes suivantes

  - [Déclencheurs](/fr/docs/automations/triggers/): Tous les déclencheurs et leurs options.
  - [Étapes](/fr/docs/automations/steps/): Toutes les étapes, leurs paramètres et le fonctionnement des branches.
  - [Recettes](/fr/docs/automations/recipes/): Les six modèles prêts à l’emploi.
  - [Exécutions et statistiques](/fr/docs/automations/runs/): Suivez les exécutions et déboguez les échecs.

---
Source: https://emailit.com/fr/docs/automations/