Esecuzioni e statistiche delle automazioni

Ogni volta che scatta un trigger, l’automazione crea un’esecuzione. Questa pagina mostra dove vedere le esecuzioni e i loro risultati, cosa significano le statistiche di ogni passaggio, come scoprire perché un’esecuzione non è riuscita e come leggere gli stessi dati con l’API.

Scheda Overview

Apri un’automazione da Email Marketing›Automations. La scheda Overview mostra:

• I conteggi Total executions, Completed, Failed e Running.
• Un diagramma del flusso in sola lettura. Seleziona un passaggio qualsiasi per vederne le Stats.
• Edit, che apre l’editor mentre l’automazione è in bozza o in pausa.

Mentre l’automazione è in esecuzione, i numeri si aggiornano ogni 10 secondi.

Statistiche dei passaggi

Le Stats di ogni passaggio contano quante esecuzioni lo hanno raggiunto e cosa è successo lì. Cosa vedi dipende dal passaggio:

Per le email delle automazioni non vengono tracciati caricamenti e clic, quindi Opened e Clicked restano a 0. Vedi Send email.

Scheda Runs

La scheda Runs elenca tutte le esecuzioni, a partire dalla più recente, con lo stato (Status), l’evento che l’ha avviata (Event), l’inizio (Started), la fine (Completed) e la durata (Duration). Filtra per stato, evento o data di creazione.

Seleziona un’esecuzione per vederne i dettagli: lo stato, gli orari di inizio e fine e ogni passaggio attraversato, in ordine, con lo stato e la durata del passaggio. Espandi Output data su un passaggio per vedere cosa ha restituito, come l’ID dell’email inviata, la diramazione presa da una condizione o l’errore che lo ha fatto fallire.

Esegui il debug di un’esecuzione non riuscita

1. Trova le esecuzioni non riuscite. Nella scheda Runs, filtra per Status failed.

2. Apri un’esecuzione. Il passaggio non riuscito è contrassegnato in rosso.

3. Leggi l’errore. Espandi Output data sul passaggio non riuscito. Il campo error indica cosa è andato storto, ad esempio send_email: Sending domain is not verified or not found. Per gli errori comuni e le relative soluzioni, vedi Quando un passaggio non riesce.

4. Risolvi la causa. Per un’impostazione del passaggio, seleziona Pause, correggi il passaggio nella scheda Editor, seleziona Save e poi Start. Per un problema del workspace, come crediti mancanti o un dominio non verificato, risolvilo in Workspace o Email API.

Un’esecuzione non riuscita senza passaggi di solito non è riuscita perché il workspace non aveva i 3 crediti necessari per avviarla. Con l’API, il suo meta mostra "failure_reason": "insufficient_credits". Ricarica i crediti o attiva la ricarica automatica così le esecuzioni non falliscono.

Le esecuzioni non riuscite non vengono ritentate. I nuovi trigger avviano nuove esecuzioni come di consueto. Per eseguire di nuovo l’automazione per un contatto o un’email la cui esecuzione non è riuscita, fai scattare di nuovo il suo trigger, ad esempio rimuovendo il contatto dalla lista e aggiungendolo di nuovo.

Un’esecuzione che resta Running a lungo di solito si trova in un passaggio Wait. Aprila per vedere a quale passaggio si trova.

Usa l’API

Elenca le esecuzioni restituisce le esecuzioni di un’automazione, a partire dalla più recente. Filtra con filter[status] (running, completed, failed o canceled) e pagina con page e per_page (fino a 100):

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
}

Recupera un’esecuzione aggiunge run_steps, con step_id, status, data (l’output, compreso un eventuale error), started_at e completed_at di ogni passaggio.

Recupera le statistiche restituisce le statistiche di ogni passaggio, indicizzate per chiave del passaggio. Restringile con since e until (ISO 8601) o con run_ids[]. Recupera le statistiche dei passaggi restituisce le statistiche di un singolo passaggio:

{
  "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 conta come è terminato il passaggio in ogni esecuzione. by_outcome conta i suoi risultati, come l’ultimo stato dell’email inviata oppure matched e not_matched per una condizione. funnel compare per i passaggi Send email.

Vedi anche