Exécutions et statistiques des automatisations

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 :

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.

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.

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 Wait. Ouvrez-la pour voir à quelle étape elle en est.

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 paginez avec page et per_page (100 au maximum) :

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"

{
  "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 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 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 :

{
  "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