Onde fica no painel
No editor do fluxo (/automations/flows/<id>), botão Execuções. O botão só
aparece depois que o fluxo foi salvo pela primeira vez.
- À esquerda, as execuções mais recentes, 25 por vez, com status e lead. O botão de atualizar recarrega a lista.
- À direita, a execução escolhida: data e hora, gatilho, duração, a mensagem de erro (se houver) e uma linha por passo, com o nome do bloco, se deu certo, a saída escolhida nas condições (Sim ou Não) e o tempo em milissegundos.
Como ler cada status
Se o fluxo não aparece com nenhuma execução, ele não foi disparado: ou está
desligado, ou o gatilho está em breve e não pode rodar (ver
de onde vem cada gatilho),
ou o evento não aconteceu do jeito esperado (ex.: a mudança foi feita por uma ação
em massa no CRM, ou numa propriedade pela API, que não disparam fluxos).
Limites
Disparos automáticos também têm proteção contra duplicidade: “Primeira mensagem” e
“Conversa encerrada” rodam uma vez por conversa, e “Responsável alterado” ignora a
mesma troca repetida dentro do mesmo minuto (duplo clique).
Como funciona por trás
- Cada passo é um item numa fila. Entre um passo e outro, o estado fica gravado na execução. Por isso uma execução pode ficar Em andamento por alguns segundos.
- Um passo com resposta de erro (status 400 ou maior) para a execução. Os passos seguintes não rodam.
- Um passo nunca roda duas vezes na mesma execução, mesmo que a fila entregue de novo: uma mensagem não sai em dobro.
- O histórico mostra o que rodou e o erro, mas não o conteúdo das requisições. Headers que parecem segredo ficam mascarados no registro.
Roteiro de depuração
1
O fluxo está ligado?
Na lista de fluxos, a chave precisa estar ligada. Fluxo desligado não gera
execução.
2
O gatilho está disponível?
Novo lead criado, Mensagem recebida, Propriedade alterada e Lead inativo estão
indisponíveis hoje (em breve). Ações em massa no CRM não disparam fluxos.
3
Há execução? Qual o status?
Abra Execuções. Sem execução: o evento não chegou. Ignorado: o filtro do
gatilho não bateu; pela API, a resposta de
/flows/trigger traz o motivo em
reason.4
Falhou: qual passo e qual erro?
O passo em vermelho mostra o erro, no formato
MÉTODO caminho respondeu STATUS.
Causas comuns na tabela abaixo.5
Concluído mas sem efeito?
Veja a saída de cada condição (Sim/Não). Lembre que
{{lead.*}} é a foto do
início: uma condição depois de “Mover no Kanban” ainda vê a coluna antiga.6
Teste com um lead seu
Dispare de novo com o seu número (mova seu lead, aplique a tag, ou chame a API
com uma
idempotency_key nova) e acompanhe a execução.Pelo MCP
O MCP não lê execuções. Para depurar, use o painel pelo navegador (botão Execuções no editor) ou a resposta do disparo pela API, que trazmatched, dispatched e o reason de cada fluxo ignorado. Ver
Diagnóstico de um projeto.
Armadilhas
- Execução sem lead. A lista mostra “Sem lead associado” quando o lead foi excluído depois.
- Excluir o fluxo apaga as execuções dele.
- “Concluído” não garante entrega no WhatsApp. Quer dizer que a Zatten aceitou o envio. A entrega aparece no chat e em Logs.
- Notificar responsável conta como Concluído mesmo sem responsável: o passo registra que não havia para quem enviar e a execução segue.
Perguntas frequentes
Dá para reexecutar uma execução que falhou?
Dá para reexecutar uma execução que falhou?
Não há botão. Corrija o fluxo e dispare o evento de novo (ou chame
/flows/trigger com uma idempotency_key nova).Por quanto tempo as execuções ficam guardadas?
Por quanto tempo as execuções ficam guardadas?
Não há limpeza automática: as execuções ficam guardadas no histórico do fluxo.
Para saber mais
- Trigger Flow: conceitos
- Trigger Flow: catálogo de blocos
- Trigger Flow: disparar pela API e receber webhooks
- Logs
- Termos para buscar: “execuções”, “Ignorado”, “Falhou”, “teto de 100 passos”, “timeout”.