# Exécutions et statistiques des automatisations

> Suivez les exécutions d’une automatisation, lisez la vue d’ensemble et les statistiques par étape, déboguez les exécutions en échec, et récupérez exécutions et statistiques avec l’API.

Chaque fois qu’un déclencheur s’active, l’automatisation crée une exécution. Cette page indique où consulter les exécutions et leurs résultats, ce que signifient les statistiques de chaque étape, comment découvrir pourquoi une exécution a échoué et comment lire les mêmes données avec l’API.

## Onglet Overview

Ouvrez une automatisation depuis **Email Marketing → Automations**. L’onglet **Overview** affiche :

- Les compteurs **Total executions**, **Completed**, **Failed** et **Running**.
- Un diagramme du flux en lecture seule. Sélectionnez n’importe quelle étape pour voir ses **Stats**.
- **Edit**, qui ouvre l’éditeur lorsque l’automatisation est en brouillon ou en pause.

Pendant que l’automatisation est en cours, les chiffres sont actualisés toutes les 10 secondes.

## Statistiques par étape

Les **Stats** de chaque étape comptent combien d’exécutions l’ont atteinte et ce qui s’y est passé. Ce que vous voyez dépend de l’étape :

| Étape | Statistiques |
| --- | --- |
| **Send email** | Un entonnoir **Accepted**, **Delivered**, **Opened** et **Clicked**, chacun en proportion des e-mails acceptés, plus les nombres de **Bounced**, **Failed**, **Complained** et **Unsubscribed**. Ces nombres suivent chaque e-mail après son envoi par l’étape. |
| **Condition (If/Else)** | **Matched** (l’exécution a pris **Yes**) et **Not matched** (elle a pris **No**). |
| Call webhook (API) | **2xx Success**, **4xx Client Error**, **5xx Server Error**, **Timeout** et **Network Error**. |
| Random split (API) | Exécutions par variante. |
| Toute autre étape | Exécutions par statut, comme **Completed**, **Waiting** et **Failed**. |

Les e-mails d’automatisation ne font pas l’objet d’un suivi des chargements et des clics : **Opened** et **Clicked** restent donc à 0 pour eux. Consultez [Send email](/fr/docs/automations/steps/#send-email).

## Onglet Runs

L’onglet **Runs** liste toutes les exécutions, de la plus récente à la plus ancienne, avec leur **Status**, l’**Event** qui les a démarrées, leurs heures de début (**Started**) et de fin (**Completed**), et leur **Duration**. Filtrez par statut, par événement ou par date de création.

Sélectionnez une exécution pour voir ses détails : son statut, ses heures de début et de fin, et chaque étape qu’elle a traversée, dans l’ordre, avec le statut et la durée de l’étape. Développez **Output data** sur une étape pour voir ce qu’elle a renvoyé, comme l’ID de l’e-mail envoyé, la branche prise par une condition ou l’erreur qui l’a fait échouer.

| Statut d’exécution | Signification |
| --- | --- |
| **Running** | Parcourt ses étapes, ou attend dans une étape **Wait**. |
| **Completed** | Toutes les étapes de son chemin sont terminées. |
| **Failed** | Une étape a échoué, ou l’espace de travail n’avait pas assez de crédits pour démarrer l’exécution. |
| **Canceled** | L’automatisation a été arrêtée avec l’API pendant l’exécution. |

## Déboguer une exécution en échec

1. **Trouvez les exécutions en échec.** Dans l’onglet **Runs**, filtrez par **Status** `failed`.

2. **Ouvrez une exécution.** L’étape en échec est signalée en rouge.

3. **Lisez l’erreur.** Développez **Output data** sur l’étape en échec. Le champ `error` indique ce qui s’est mal passé, par exemple `send_email: Sending domain is not verified or not found`. Pour les erreurs courantes et leurs solutions, consultez [Quand une étape échoue](/fr/docs/automations/steps/#when-a-step-fails).

4. **Corrigez la cause.** Pour un réglage d’étape, sélectionnez **Pause**, corrigez l’étape dans l’onglet **Editor**, sélectionnez **Save**, puis **Start**. Pour un problème lié à l’espace de travail, comme des crédits insuffisants ou un domaine non vérifié, corrigez-le dans **Workspace** ou **Email API**.

Une exécution en échec sans aucune étape a généralement échoué parce que l’espace de travail n’avait pas les 3 crédits nécessaires pour la démarrer. Avec l’API, son `meta` indique `"failure_reason": "insufficient_credits"`. [Rechargez vos crédits](/fr/docs/billing/credits/) ou activez la [recharge automatique](/fr/docs/billing/auto-refill/) pour que les exécutions n’échouent pas.

Les exécutions en échec ne sont pas relancées. Les nouveaux déclenchements démarrent de nouvelles exécutions comme d’habitude. Pour exécuter de nouveau l’automatisation pour un contact ou un e-mail en échec, activez de nouveau son déclencheur, par exemple en retirant le contact de la liste puis en l’y ajoutant de nouveau.

Une exécution qui reste longtemps **Running** se trouve généralement dans une étape **Wait**. Ouvrez-la pour voir à quelle étape elle en est.

## Utiliser l’API

[Lister les exécutions](/fr/docs/api-reference/automations/runs/) renvoie les exécutions d’une automatisation, de la plus récente à la plus ancienne. Filtrez avec `filter[status]` (`running`, `completed`, `failed` ou `canceled`) et paginez avec `page` et `per_page` (100 au maximum) :

```bash
curl -G "https://api.emailit.com/v2/automations/aut_3Mv8Xq2nKp5Lt/runs" \
  --data-urlencode "filter[status]=failed" \
  --data-urlencode "per_page=25" \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

```json
{
  "data": [
    {
      "id": "aur_7Kp2Vx9mQt4Lw",
      "automation_id": "aut_3Mv8Xq2nKp5Lt",
      "contact_id": "con_2kq8Vt4xLm7Rz",
      "email_id": null,
      "event_id": null,
      "event": "contact.added_to_audience",
      "payload": { "object": { "id": "sub_7Rt2vX9kLm3Qp", "object": "subscriber" } },
      "meta": { "source_event_id": "evt_2Hn6Wq8rTc3Mz" },
      "status": "failed",
      "started_at": "2026-10-01T09:30:00Z",
      "completed_at": "2026-10-01T09:30:02Z",
      "created_at": "2026-10-01T09:30:00Z",
      "updated_at": "2026-10-01T09:30:02Z"
    }
  ],
  "total_records": 1,
  "per_page": 25,
  "current_page": 1,
  "total_pages": 1
}
```

[Récupérer une exécution](/fr/docs/api-reference/automations/run/) ajoute `run_steps`, avec pour chaque étape son `step_id`, son `status`, ses `data` (la sortie, y compris une éventuelle `error`), son `started_at` et son `completed_at`.

[Récupérer les statistiques](/fr/docs/api-reference/automations/stats/) renvoie les statistiques de toutes les étapes, indexées par clé d’étape. Restreignez-les avec `since` et `until` (ISO 8601) ou `run_ids[]`. [Récupérer les statistiques d’une étape](/fr/docs/api-reference/automations/step-stats/) renvoie les statistiques d’une seule étape :

```json
{
  "data": {
    "send_email-1": {
      "total": 120,
      "by_status": { "completed": 118, "failed": 2 },
      "by_outcome": { "delivered": 110, "bounced": 3, "accepted": 5, "error": 2 },
      "funnel": { "accepted": 115, "delivered": 110, "loaded": 0, "clicked": 0, "bounced": 3, "failed": 0, "complained": 0, "unsubscribed": 0 }
    }
  }
}
```

`by_status` compte comment l’étape s’est terminée dans chaque exécution. `by_outcome` compte ses résultats, comme le dernier statut de l’e-mail envoyé, ou `matched` et `not_matched` pour une condition. `funnel` apparaît pour les étapes **Send email**.

## Voir aussi

  - [Étapes](/fr/docs/automations/steps/): Paramètres des étapes et erreurs courantes.
  - [Vue d’ensemble des automatisations](/fr/docs/automations/): Statuts, crédits et API.

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