# Esecuzioni e statistiche delle automazioni

> Segui le esecuzioni di un’automazione, leggi la panoramica e le statistiche per passaggio, esegui il debug delle esecuzioni 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 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:

| 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**). |
| Call webhook (API) | **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** e **Failed**. |

Per le email delle automazioni non vengono tracciati caricamenti e clic, quindi **Opened** e **Clicked** restano a 0. Vedi [Send email](/it/docs/automations/steps/#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.

| Stato dell’esecuzione | Significato |
| --- | --- |
| **Running** | Sta percorrendo i passaggi, oppure è in attesa in un passaggio **Wait**. |
| **Completed** | Tutti i passaggi sul suo percorso sono terminati. |
| **Failed** | Un passaggio non è riuscito, oppure il workspace non aveva crediti sufficienti per avviare l’esecuzione. |
| **Canceled** | L’automazione è stata interrotta con l’API mentre l’esecuzione era in corso. |

## 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](/it/docs/automations/steps/#when-a-step-fails).

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](/it/docs/billing/credits/) o attiva la [ricarica automatica](/it/docs/billing/auto-refill/) 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](/it/docs/api-reference/automations/runs/) 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):

```bash
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",
      "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](/it/docs/api-reference/automations/run/) 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](/it/docs/api-reference/automations/stats/) 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](/it/docs/api-reference/automations/step-stats/) restituisce le statistiche di un singolo passaggio:

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

  - [Passaggi](/it/docs/automations/steps/): Impostazioni dei passaggi ed errori comuni.
  - [Panoramica delle automazioni](/it/docs/automations/): Stati, crediti e API.

---
Fonte: https://emailit.com/it/docs/automations/runs/