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.
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:
- Annulla un’esecuzione:
POST /v2/automations/{id}/runs/{run_id}/cancel, con unreasonfacoltativo. - Rimuovi un contatto da un’automazione:
POST /v2/automations/{id}/exitconcontact_idoemailannulla tutte le esecuzioni di quel contatto nell’automazione, ad esempio dal tuo shop quando un ordine viene pagato. - Elenca le esecuzioni di un contatto:
GET /v2/automations/runs?email=…mostra in quali automazioni si trova un contatto.
Per farlo automaticamente, usa invece le condizioni di uscita.
Esegui il debug di un’esecuzione non riuscita
-
Trova le esecuzioni non riuscite. Nella scheda Runs, filtra per Status
failed. -
Apri un’esecuzione. Il passaggio non riuscito è contrassegnato in rosso.
-
Leggi l’errore. Espandi Output data sul passaggio non riuscito. Il campo
errorindica cosa è andato storto, ad esempiosend_email: Sending domain is not verified or not found. Per gli errori comuni e le relative soluzioni, vedi Quando un passaggio non riesce. -
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):
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",
"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:
{
"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.