Aller au contenu
Docs

Guide pratique

Exécutions et statistiques des automatisations

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

Mis à jour le 9 oct. 2026

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 annuler une exécution, comment découvrir pourquoi une exécution a échoué et comment faire de même avec l’API.

Onglet Overview

Ouvrez une automatisation depuis Email MarketingAutomations. 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).
Webhook 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, Skipped et Failed.

Opened et Clicked sont comptés quand le domaine d’envoi suit les chargements et les clics. Les e-mails marketing ignorés parce que le contact s’est désinscrit ont le résultat skipped. Les résultats d’une étape Wait until sont matched et timeout, et ceux d’une étape Goal, reached et not_reached.

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, le Contact, une Note qui indique pourquoi une exécution annulée s’est arrêtée, 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, ce qu’elle attend, et chaque étape qu’elle a traversée, dans l’ordre, avec le statut, le résultat 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 Time delay ou Wait until.
Completed Elle a atteint la fin de son chemin ou une étape End automation, ou elle est passée dans une autre automatisation.
Failed Une étape a échoué, ou l’espace de travail n’avait pas assez de crédits pour démarrer l’exécution.
Canceled Elle s’est arrêtée avant la fin. La Note indique pourquoi : Met an exit condition, Left the audience, Canceled by a user, Removed with the API, Removed by another automation, Automation stopped ou Contact deleted.

Les étapes ignorées parce que l’exécution a sauté jusqu’à un objectif apparaissent comme skipped.

Annuler une exécution

Pour faire sortir un contact d’une automatisation, ouvrez son exécution dans l’onglet Runs et sélectionnez Cancel run. Ses étapes en attente sont annulées et plus aucune étape ne s’exécute. Les exécutions annulées ne peuvent pas être reprises ; un nouveau déclenchement démarre une nouvelle exécution.

Avec l’API :

Pour le faire automatiquement, utilisez plutôt des conditions de sortie.

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.

  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 ou activez la recharge automatique 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 Time delay ou Wait until. Ouvrez-la pour voir à quelle étape elle en est et ce qu’elle attend.

Utiliser l’API

Lister les exécutions 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 filter[contact_id], et paginez avec page et per_page (100 au maximum) :

Terminal
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",
      "cancel_reason": null,
      "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 ajoute run_steps, avec pour chaque étape son step_id, sa step_key, son action, son status, son outcome, ses data (la sortie, y compris une éventuelle error), son started_at et son completed_at, ainsi que waits, les étapes Wait until et Goal dans lesquelles l’exécution attend ou a attendu, avec ce qu’elles attendent (kind, event), leur status et leur timeout_at.

Récupérer les statistiques 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 renvoie les statistiques d’une seule étape :

JSON
{
  "data": {
    "send_email-1": {
      "total": 120,
      "by_status": { "completed": 118, "failed": 2 },
      "by_outcome": { "accepted": 5, "delivered": 58, "loaded": 43, "clicked": 9, "bounced": 3, "error": 2 },
      "funnel": { "accepted": 115, "delivered": 110, "loaded": 52, "clicked": 9, "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.

Paramètres des étapes et erreurs courantes.
Mettez fin aux exécutions automatiquement.

Cette page vous a-t-elle été utile ?

Merci pour votre retour.

Merci, nous lisons chaque message.