Skip to main content
Cada vez que um fluxo é disparado para um lead, a Zatten grava uma execução: quando começou, o gatilho, o lead, o status e o passo a passo do que rodou. É o primeiro lugar para olhar quando um fluxo “não funcionou”.

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.
Só admin e editor veem as execuções.

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 traz matched, 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

Não há botão. Corrija o fluxo e dispare o evento de novo (ou chame /flows/trigger com uma idempotency_key nova).
Não há limpeza automática: as execuções ficam guardadas no histórico do fluxo.

Para saber mais