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

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:

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.

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.

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 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 ou ative a recarga automática 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 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):

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
}

Obter uma execução 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 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 retorna as estatísticas de uma etapa:

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