Vai al contenuto
Docs

Guida pratica

Esecuzioni e statistiche delle automazioni

Segui le esecuzioni di un’automazione, leggi la panoramica e le statistiche per passaggio, annulla esecuzioni, esegui il debug di quelle non riuscite e recupera esecuzioni e statistiche con l’API.

Aggiornato il 9 ott 2026

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 annullare un’esecuzione, come scoprire perché un’esecuzione non è riuscita e come fare le stesse cose con l’API.

Scheda Overview

Apri un’automazione da Email MarketingAutomations. 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:

Passaggio Statistiche
Send email Un funnel di Accepted, Delivered, Opened e Clicked, ciascuno come quota delle email accettate, più i conteggi di Bounced, Failed, Complained e Unsubscribed. I conteggi seguono ogni email dopo che il passaggio l’ha inviata.
Condition (If/Else) Matched (l’esecuzione ha preso Yes) e Not matched (ha preso No).
Webhook 2xx Success, 4xx Client Error, 5xx Server Error, Timeout e Network Error.
Random split (API) Esecuzioni per variante.
Tutti gli altri passaggi Esecuzioni per stato, come Completed, Waiting, Skipped e Failed.

Opened e Clicked vengono conteggiati quando il dominio di invio traccia caricamenti e clic. Le email di marketing saltate perché il contatto si è disiscritto hanno l’esito skipped. Gli esiti di un passaggio Wait until sono matched e timeout, quelli di un Goal sono reached e not_reached.

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), il contatto (Contact), una nota (Note) che spiega perché un’esecuzione annullata si è fermata, 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, cosa sta attendendo e ogni passaggio attraversato, in ordine, con lo stato, l’esito 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.

Stato dell’esecuzione Significato
Running Sta percorrendo i passaggi, oppure è in attesa in un passaggio Time delay o Wait until.
Completed Ha raggiunto la fine del suo percorso o un passaggio End automation, oppure è passata a un’altra automazione.
Failed Un passaggio non è riuscito, oppure il workspace non aveva crediti sufficienti per avviare l’esecuzione.
Canceled Si è fermata in anticipo. La Note indica il motivo: Met an exit condition, Left the audience, Canceled by a user, Removed with the API, Removed by another automation, Automation stopped o Contact deleted.

I passaggi saltati perché l’esecuzione è passata a un obiettivo risultano skipped.

Annulla un’esecuzione

Per far uscire un contatto da un’automazione, apri la sua esecuzione nella scheda Runs e seleziona Cancel run. I passaggi in attesa vengono annullati e non vengono eseguiti altri passaggi. Le esecuzioni annullate non si possono riprendere; un nuovo trigger avvia una nuova esecuzione.

Con l’API:

Per farlo automaticamente, usa invece le condizioni di uscita.

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 Time delay o Wait until. Aprila per vedere a quale passaggio si trova e cosa sta attendendo.

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 filter[contact_id], e pagina con page e per_page (fino a 100):

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
}

Recupera un’esecuzione aggiunge run_steps, con step_id, step_key, action, status, outcome, data (l’output, compreso un eventuale error), started_at e completed_at di ogni passaggio, e waits, i passaggi Wait until e Goal in cui l’esecuzione è o è stata in attesa, con cosa attendono (kind, event), il loro status e timeout_at.

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:

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

Impostazioni dei passaggi ed errori comuni.
Termina le esecuzioni automaticamente.

Questa pagina ti è stata utile?

Grazie del feedback.

Grazie, leggiamo ogni messaggio.