Um cliente fez a compra, mandou a mensagem ou recebeu a tag, e nada aconteceu no fluxo. Para esse tipo de dúvida existe a página Execuções do fluxo, com a busca Por que não disparou. Ela mostra o que os gatilhos do fluxo decidiram para aquele cliente: entrou ou não entrou, e por quê.

Esta página é diferente do diálogo Execuções do fluxo. O diálogo, aberto pelo menu ⋮ › Execuções, procura clientes por nome ou e-mail, mas só encontra quem já entrou no fluxo. A página descrita neste artigo pede o ID do cliente, e serve justamente para os casos em que o cliente pode não ter entrado. Para o diálogo, veja Como validar o que aconteceu com um cliente no fluxo.

A página Execuções do fluxo

A página tem o título Execuções do fluxo e a explicação "Consulta por cliente e por objeto — para entender o que aconteceu num caso específico." Ela é aberta por um link direto do fluxo, no formato painel.martz.com.br/flows/ID-DO-FLUXO/runs.

Ela tem duas buscas, uma abaixo da outra:

Busca	Para que serve
Por que não disparou	"Busque um cliente para ver o que os gatilhos deste fluxo decidiram para ele."
Linha do tempo	"Busque o cliente para ver as execuções deste fluxo e abrir a linha do tempo de uma delas."

As duas pedem o ID do cliente. Nome e e-mail não funcionam aqui. O botão Buscar só habilita depois que você digita o ID.

Como encontrar o ID do cliente

O ID é um código com letras e números separados por hífens, único para cada cliente. Hoje esta página não ajuda a descobrir o ID: ela só o aceita. Por isso:

Se você não tem o ID em mãos, peça ao suporte da Martz, informando o nome do fluxo e o nome ou e-mail do cliente.
Se o seu objetivo é só ver o que aconteceu com alguém que já entrou no fluxo, você não precisa do ID: use o diálogo Execuções do fluxo (menu ⋮ › Execuções), que aceita nome ou e-mail.

Como ler o resultado de "Por que não disparou"

Digite o ID do cliente no campo de Por que não disparou e clique em Buscar. O resultado é uma lista de cartões, um para cada vez que um gatilho do fluxo analisou um evento daquele cliente.

Cada cartão tem duas linhas:

O resultado, em destaque. Cartão verde com Entrou no fluxo significa que o cliente entrou.
O gatilho e o momento, em letra menor: a identificação do gatilho que analisou o evento, seguida da data e hora. No exemplo, commerce.order.paid · 09/10/2026, 01:24:28 é o gatilho Pedido pago.

No exemplo da imagem, o cliente entrou duas vezes no fluxo, em dias diferentes. Isso é possível quando a regra de reentrada permite (veja mais abaixo).

Compare com a Linha do tempo

Na mesma página, a busca Linha do tempo com o mesmo ID mostra as execuções desse cliente. É a prova cruzada: cada cartão Entrou no fluxo costuma ter uma execução com o mesmo horário, com diferença de um ou dois segundos.

Clicar em uma execução abre a linha do tempo dela, igual à do diálogo. Para aprender a ler, veja Como validar o que aconteceu com um cliente no fluxo.

Os motivos de um cliente não entrar

Quando o gatilho decide que o cliente não entra, o cartão traz o motivo em português. Veja o que cada um significa e o que fazer.

Motivo na tela	O que significa	O que fazer
Já estava no fluxo	O cliente ainda estava dentro do fluxo quando o gatilho voltou a ocorrer. Enquanto o cliente está no fluxo, uma nova entrada não é criada.	Normalmente não há o que corrigir: espere o cliente sair do fluxo. Se você quer que cada gatilho abra uma nova jornada, vá em Configurações do fluxo › Reentrada no fluxo, escolha Sem limite e ligue Permitir que o cliente esteja no fluxo mais de uma vez ao mesmo tempo. Pense bem antes: isso pode gerar mensagens repetidas.
Reentrada não permitida	O cliente já passou pelo fluxo e a regra de reentrada não deixa que ele entre de novo.	Revise Reentrada no fluxo em Configurações do fluxo. As opções são Apenas uma vez, Com limite (máximo de entradas em uma janela de dias) e Sem limite. Veja também o Intervalo mínimo entre entradas.
Fora do período de validade do fluxo	O evento aconteceu antes do Início ou depois do Fim do fluxo. Fora do período, nenhum cliente entra, e quem ficou de fora não entra depois.	Confira o Período de execução em Configurações do fluxo: a data de início e a data de fim.
Não passou no filtro do gatilho (…)	O gatilho tem um filtro e o evento do cliente não atendeu. O texto entre parênteses diz qual filtro barrou.	Abra o gatilho no editor e revise os filtros. Veja se eles estão como você pretendia.
Cliente sem identidade resolvida	Não foi possível identificar quem é o cliente do evento, então o fluxo não consegue colocá-lo para dentro.	Fale com o suporte, informando o fluxo e o horário aproximado do evento.
Evento duplicado (a redação na tela pode variar)	O mesmo evento chegou mais de uma vez. Só a primeira vez conta.	Em geral, nada. O cliente já foi tratado na primeira ocorrência.
Evento de histórico (a redação na tela pode variar)	O evento veio de dados importados ou de histórico. Fluxos nunca disparam por dados históricos.	Nada a corrigir: é uma regra para proteger seus clientes de mensagens sobre fatos antigos.
Motivo não reconhecido (…)	A tela recebeu um motivo que ainda não tem explicação em português. O texto entre parênteses é o código.	Fale com o suporte e copie o texto exato do cartão.

Dica: num fluxo com mais de um gatilho, o cliente entra por qualquer um deles. Se um cartão diz que o filtro não passou, ele se refere ao gatilho que analisou aquele evento. Lembre-se disso ao revisar os filtros.

E se aparecer um motivo que não está nesta lista?

Alguns motivos de não entrada podem aparecer com redação diferente da desta tabela, ou ainda não ser exibidos. Se o cliente não entrou e a página não explica por quê, fale com o suporte.

E se não aparecer nenhum cartão?

Se você buscou o ID e nenhum cartão apareceu, isso quer dizer que, no período em que a Martz guarda esse histórico, os gatilhos deste fluxo não registraram nenhuma decisão para esse cliente. As causas mais prováveis são:

O evento esperado não aconteceu para esse cliente. Por exemplo, o pedido não chegou a ser marcado como pago, a mensagem não foi recebida ou a tag não foi aplicada. Nesse caso, o problema está antes do fluxo, e não nas configurações dele.
O ID está errado. Confira cada caractere do código.
O evento é antigo. O histórico de decisões dos gatilhos fica disponível por tempo limitado. Eventos mais antigos podem já não aparecer.
O gatilho do fluxo não corresponde ao evento. Veja se o gatilho do fluxo é realmente o que você espera, em Gatilhos: visão geral.

Cartões que explicam o motivo (como Já estava no fluxo) querem dizer o oposto: o fluxo viu o evento e decidiu não entrar. Nesses casos, o ajuste costuma estar nas Configurações do fluxo ou nos filtros do gatilho.

Resumo para decidir o próximo passo

O que você viu	Próximo passo
Cartão verde Entrou no fluxo	O cliente entrou. Veja a execução dele em Como validar o que aconteceu com um cliente no fluxo.
Cartão com motivo de reentrada ou de período	Ajuste Configurações do fluxo (guia).
Cartão de filtro do gatilho	Revise os filtros do gatilho no editor.
Nenhum cartão	Confirme o ID e se o evento realmente aconteceu para esse cliente.
Motivo desconhecido ou sem identidade	Fale com o suporte.

Por que o fluxo não disparou para um cliente