Guia prático
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, cancele execuções, 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 cancelar uma execução, como descobrir por que uma execução falhou e como fazer o mesmo pela API.
Aba Overview
Abra uma automação em Email MarketingAutomations. 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). |
| Webhook | 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, Skipped e Failed. |
Opened e Clicked contam quando o domínio de envio rastreia carregamentos e cliques. Os e-mails de marketing ignorados porque o contato se descadastrou têm o resultado skipped. Os resultados de uma etapa Wait until são matched e timeout, e os de uma Goal, reached e not_reached.
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, o Contact, uma Note que diz por que uma execução cancelada parou, 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, o que ela está esperando e cada etapa pela qual ela passou, em ordem, com o status, o resultado 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 Time delay ou Wait until. |
| Completed | Chegou ao fim do caminho dela ou a uma etapa End automation, ou passou para outra automação. |
| Failed | Uma etapa falhou, ou o workspace não tinha créditos suficientes para iniciar a execução. |
| Canceled | Parou antes do fim. A Note diz por quê: Met an exit condition, Left the audience, Canceled by a user, Removed with the API, Removed by another automation, Automation stopped ou Contact deleted. |
As etapas ignoradas porque a execução pulou para uma meta aparecem como skipped.
Cancelar uma execução
Para tirar um contato de uma automação, abra a execução dele na aba Runs e selecione Cancel run. As etapas em espera dela são canceladas, e nenhuma outra etapa é executada. As execuções canceladas não podem ser retomadas; um novo gatilho inicia uma nova execução.
Pela API:
- Cancelar uma execução:
POST /v2/automations/{id}/runs/{run_id}/cancel, com umreasonopcional. - Remover um contato de uma automação:
POST /v2/automations/{id}/exitcomcontact_idouemailcancela todas as execuções desse contato na automação, por exemplo, a partir da sua loja quando um pedido é pago. - Listar as execuções de um contato:
GET /v2/automations/runs?email=…mostra em quais automações um contato está.
Para fazer isso automaticamente, use condições de saída.
Depurar uma execução com falha
-
Encontre as execuções com falha. Na aba Runs, filtre por Status
failed. -
Abra uma execução. A etapa com falha aparece marcada em vermelho.
-
Leia o erro. Expanda Output data na etapa com falha. O campo
errordiz 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. -
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 Time delay ou Wait until. Abra-a para ver em que etapa ela está e o que está esperando.
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 filter[contact_id], 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",
"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
}Obter uma execução adiciona run_steps, com step_id, step_key, action, status, outcome, data (a saída, incluindo um eventual error), started_at e completed_at de cada etapa, e waits, as etapas Wait until e Goal em que a execução está ou esteve esperando, com o que elas esperam (kind, event), o status delas e timeout_at.
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": { "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 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.