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
Motivos de Cancelado:
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).
Uma execução por fluxo e lead
Um fluxo tem no máximo uma execução ativa (Em andamento ou Aguardando) por lead. Se o mesmo fluxo dispara de novo para o mesmo lead, a execução anterior é cancelada (“Cancelada: substituída por novo disparo”) e a nova começa. Fluxos diferentes no mesmo lead não se cancelam, e o mesmo fluxo em leads diferentes também não. Consequência para quem monta o fluxo: se uma ação dispara o próprio fluxo (ex.: “Responsável alterado” → … → “Definir responsável”), a execução nova substitui a que está rodando, e os blocos depois dessa ação não rodam. Deixe essa ação por último no ramo.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.
- Cada condição e cada ação relê o lead antes de rodar:
{{lead.*}}é o valor atual, não o do início. Se o lead foi excluído no meio, a execução falha com “Lead não existe mais”. - 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?
Mensagem recebida, Propriedade alterada e Lead inativo por… estão indisponíveis
hoje (em breve). Ações em massa no CRM não disparam fluxos. Novo lead criado não
roda para lead importado por CSV, criado por mensagem enviada pelo celular, nem
para o lead de teste.
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
Cancelado ou Aguardando?
Cancelado mostra o motivo no detalhe: em geral o fluxo disparou de novo para o
mesmo lead, ou, num fluxo de inatividade, o outro lado respondeu. Aguardando
mostra quando retoma.
5
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.6
Concluído mas sem efeito?
Veja a saída de cada condição (Sim/Não). Ela usa os dados atuais do lead, no
momento em que roda.
7
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.
- Muitos Cancelado seguidos num fluxo costumam indicar um laço: o fluxo dispara a si mesmo (ex.: “Definir responsável” num fluxo de “Responsável alterado”).
- 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”, “Aguardando”, “Cancelado”, “substituída por novo disparo”, “teto de 100 passos”, “timeout”.