# Execuções e estatísticas de automações

> Acompanhe as execuções de uma automação, leia a visão geral e as estatísticas por etapa, depure execuções com falha e busque execuções e estatísticas pela API.

Toda vez que um gatilho dispara, a automação cria uma execução. Esta página mostra onde ver as execuções e os resultados delas, o que significam as estatísticas de cada etapa, como descobrir por que uma execução falhou e como ler os mesmos dados pela API.

## Aba Overview

Abra uma automação em **Email Marketing → Automations**. A aba **Overview** mostra:

- As contagens **Total executions**, **Completed**, **Failed** e **Running**.
- Um diagrama do fluxo, somente leitura. Selecione qualquer etapa para ver as **Stats** dela.
- **Edit**, que abre o editor enquanto a automação está em rascunho ou pausada.

Enquanto a automação está em execução, os números são atualizados a cada 10 segundos.

## Estatísticas das etapas

As **Stats** de cada etapa contam quantas execuções chegaram a ela e o que aconteceu ali. O que você vê depende da etapa:

| Etapa | Estatísticas |
| --- | --- |
| **Send email** | Um funil com **Accepted**, **Delivered**, **Opened** e **Clicked**, cada um como parcela dos e-mails aceitos, além das contagens de **Bounced**, **Failed**, **Complained** e **Unsubscribed**. As contagens acompanham cada e-mail depois que a etapa o enviou. |
| **Condition (If/Else)** | **Matched** (a execução seguiu por **Yes**) e **Not matched** (seguiu por **No**). |
| Call webhook (API) | **2xx Success**, **4xx Client Error**, **5xx Server Error**, **Timeout** e **Network Error**. |
| Random split (API) | Execuções por variante. |
| Todas as outras etapas | Execuções por status, como **Completed**, **Waiting** e **Failed**. |

Os e-mails de automações não têm rastreamento de carregamentos e cliques, então **Opened** e **Clicked** ficam em 0 para eles. Consulte [Send email](/pt/docs/automations/steps/#send-email).

## Aba Runs

A aba **Runs** lista todas as execuções, das mais recentes para as mais antigas, com o **Status**, o **Event** que a iniciou, quando ela começou (**Started**) e terminou (**Completed**) e a **Duration**. Filtre por status, evento ou data de criação.

Selecione uma execução para ver os detalhes: o status, os horários de início e de fim e cada etapa pela qual ela passou, em ordem, com o status e a duração da etapa. Expanda **Output data** em uma etapa para ver o que ela retornou, como o ID do e-mail que enviou, a ramificação que uma condição seguiu ou o erro que a fez falhar.

| Status da execução | Significado |
| --- | --- |
| **Running** | Percorrendo as etapas ou esperando em uma etapa **Wait**. |
| **Completed** | Todas as etapas do caminho dela terminaram. |
| **Failed** | Uma etapa falhou, ou o workspace não tinha créditos suficientes para iniciar a execução. |
| **Canceled** | A automação foi interrompida pela API enquanto a execução estava em andamento. |

## Depurar uma execução com falha

1. **Encontre as execuções com falha.** Na aba **Runs**, filtre por **Status** `failed`.

2. **Abra uma execução.** A etapa com falha aparece marcada em vermelho.

3. **Leia o erro.** Expanda **Output data** na etapa com falha. O campo `error` diz o que deu errado, por exemplo, `send_email: Sending domain is not verified or not found`. Consulte [Quando uma etapa falha](/pt/docs/automations/steps/#when-a-step-fails) para ver os erros comuns e como corrigi-los.

4. **Corrija a causa.** Se for uma configuração da etapa, selecione **Pause**, corrija a etapa na aba **Editor**, selecione **Save** e depois **Start**. Se for um problema do workspace, como falta de créditos ou um domínio não verificado, corrija-o em **Workspace** ou em **Email API**.

Uma execução com falha e sem etapas normalmente falhou porque o workspace não tinha os 3 créditos necessários para iniciá-la. Pela API, o `meta` dela mostra `"failure_reason": "insufficient_credits"`. [Recarregue créditos](/pt/docs/billing/credits/) ou ative a [recarga automática](/pt/docs/billing/auto-refill/) para que as execuções não falhem.

As execuções com falha não recebem novas tentativas. Novos gatilhos iniciam novas execuções normalmente. Para executar a automação de novo para um contato ou um e-mail que falhou, dispare o gatilho de novo, por exemplo, removendo o contato da lista de contatos e adicionando-o de volta.

Uma execução que fica em **Running** por muito tempo normalmente está em uma etapa **Wait**. Abra-a para ver em que etapa ela está.

## Usar a API

[Listar execuções](/pt/docs/api-reference/automations/runs/) retorna as execuções de uma automação, das mais recentes para as mais antigas. Filtre com `filter[status]` (`running`, `completed`, `failed` ou `canceled`) e pagine com `page` e `per_page` (até 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
}
```

[Obter uma execução](/pt/docs/api-reference/automations/run/) adiciona `run_steps`, com `step_id`, `status`, `data` (a saída, incluindo um eventual `error`), `started_at` e `completed_at` de cada etapa.

[Obter estatísticas](/pt/docs/api-reference/automations/stats/) retorna as estatísticas de todas as etapas, organizadas pela chave da etapa. Restrinja-as com `since` e `until` (ISO 8601) ou com `run_ids[]`. [Obter estatísticas das etapas](/pt/docs/api-reference/automations/step-stats/) retorna as estatísticas de uma etapa:

```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 como a etapa terminou em cada execução. `by_outcome` conta os resultados dela, como o status mais recente do e-mail que ela enviou ou `matched` e `not_matched` em uma condição. `funnel` aparece nas etapas **Send email**.

## Veja também

  - [Etapas](/pt/docs/automations/steps/): Configurações das etapas e erros comuns.
  - [Visão geral das automações](/pt/docs/automations/): Status, créditos e a API.

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