O fluxo não disparou

Checklist para descobrir por que uma automação não começou ou não mandou a mensagem: status, linha, palavra-chave, regras de re-entrada, AI Mode, opt-out e janela de 24 horas.

Resposta rápida

Abra o fluxo e clique em Execuções. Se o contato aparece lá, o fluxo disparou e o problema está num bloco (veja o erro da execução). Se não aparece, o gatilho não casou: confira se o fluxo está Ativo, se a linha está em Linhas do fluxo, se a palavra-chave bate e se nenhuma regra de re-entrada ou de AI Mode bloqueou a entrada.

Primeiro: disparou ou não disparou?

No editor do fluxo, clique em Execuções (ou, na lista de Automações, em Ver execuções no menu do card). Filtre por Falharam se quiser ver só os erros.

O contato aparece com status Falhou ou Parcial: o fluxo começou, mas um bloco deu erro. Abra a execução e leia o erro. Vá para O fluxo começou, mas a mensagem não chegou.
O contato não aparece: o gatilho não casou ou foi bloqueado. Siga o checklist abaixo.

Checklist: o gatilho não casou

1
O fluxo está Ativo e salvo?
Na lista de Automações, o card precisa estar com o selo Ativo. Um fluxo novo só pode ser ativado depois do primeiro Salvar. Alterações feitas e não salvas não valem.
2
A mensagem chegou por uma linha do fluxo?
Em Ajustes do fluxo > Linhas do fluxo, se alguma linha estiver marcada, o fluxo só dispara pelas marcadas. Nenhuma marcada vale para todas.
12
1. 1Enviar por
2. 2Linhas do fluxo
3
A palavra-chave bate?
Em Texto exato, a mensagem precisa ser igual à palavra (maiúsculas e minúsculas não importam, mas acentos sim: preço e preco são diferentes; cadastre as duas). Em Contém a palavra, basta a mensagem conter a palavra. Se a lista de palavras estiver vazia, esses dois tipos nunca disparam.
4
Outro fluxo atendeu primeiro?
Uma mensagem dispara um fluxo só. Antes de um gatilho de palavra-chave vem o clique em botão de um fluxo; depois vêm as respostas a perguntas de outro fluxo e, por último, Primeira mensagem do contato e Qualquer mensagem. Se dois fluxos ativos usam a mesma palavra, o painel do gatilho avisa que a palavra "já está(ão) em uso no fluxo ativo", com o nome do outro fluxo.
5
Alguma regra de re-entrada segurou?
- Cooldown de re-entrada no gatilho: o mesmo contato só entra de novo depois desse tempo.
- Bloquear reentrada se contato já tem agendamentos ativos (ligada por padrão): quem ainda tem uma espera em andamento neste fluxo não entra de novo.
- Não interromper contato que já está em outro fluxo (nos gatilhos pega-tudo, ligada por padrão): ignora quem entrou em outro fluxo nas últimas 24 horas.
- Primeira mensagem do contato dispara uma vez na vida de cada contato. Quem já falou com você antes não entra.
- Re-entrada após objetivo em Ajustes do fluxo: com bloqueio, quem já cumpriu o objetivo não entra mais.
6
O contato está em AI Mode?
Se o contato está sendo atendido por um fluxo com AI Mode, cada gatilho segue o seu Comportamento em AI Mode. No Mensagem Recebida, o padrão é Ignorar silenciosamente. Mude para Disparar mesmo assim se esse gatilho precisa interromper a IA. Veja IA nos fluxos.
7
O gatilho combina com o tipo de linha?
Mensagem em Grupo, Entrou no Grupo e Saiu do Grupo só funcionam em linhas QR. Entrou no Grupo e Saiu do Grupo só valem para grupos de uma campanha de grupos.
8
É um gatilho de webhook ou de checkout?
No Webhook HTTP, o mapeamento precisa estar salvo (Salvar Mapeamento) e com o telefone mapeado. Na Ticto e na Hubla, confira se a URL do bloco está cadastrada na plataforma e se a saída do evento está ligada a algum bloco. Veja Receber dados de outros sistemas.

O fluxo começou, mas a mensagem não chegou

Sintoma	Causa provável	O que fazer
Erro de janela de 24 horas numa linha oficial	O contato não falou com você nas últimas 24 horas, e texto livre só sai dentro da janela	Use um bloco Template WhatsApp nesse ponto. Veja Janela de 24 horas
O bloco foi pulado e o fluxo seguiu	O contato está em opt-out: mensagens para ele são puladas, o resto do fluxo continua	Confira o selo Opt-out na ficha do contato. Veja Opt-out
Erro de linha desconectada	A linha usada pelo fluxo caiu. O envio nunca troca de número sozinho	Reconecte a linha em Integrações ou ajuste Enviar por nos Ajustes do fluxo
Respondeu pela linha errada	A opção Enviar por não é a que você queria	Escolha Linha do gatilho, Linha ativa do contato ou Linha fixa
A IA não respondeu	Falta a chave do provedor escolhido no bloco Agente AI	Cadastre em Configurações > IA. Veja IA nos fluxos
O fluxo parou num ponto e não andou mais	O bloco Fazer Pergunta espera a resposta do contato	Defina Expirar em para seguir pela saída Expirou quando ele não responder
Outros códigos de erro da Meta	Limite da linha, número inválido, conta com problema	Veja A mensagem não chegou

Perguntas frequentes

O fluxo funcionou comigo e não funciona com um cliente. Por quê?

Os motivos mais comuns são as regras de re-entrada (o cliente já passou pelo fluxo), o AI Mode e a janela de 24 horas. Compare as duas execuções em Execuções.

Como testo de novo com o mesmo número?

Se o Cooldown de re-entrada ou a regra de agendamentos ativos estiverem segurando, espere o prazo ou use outro número. Primeira mensagem do contato nunca dispara de novo para quem já mandou mensagem antes.

Mudei o fluxo e ele continua fazendo o antigo.

Confira se você clicou em Salvar. Embaixo do nome do fluxo aparece quando ele foi salvo ou alterado pela última vez.

Posso ver o conteúdo que chegou no webhook?

Sim. Abra a execução em Execuções: ela mostra os dados recebidos no gatilho.

#Primeiro: disparou ou não disparou?

#Checklist: o gatilho não casou

#O fluxo começou, mas a mensagem não chegou

#Perguntas frequentes

Primeiro: disparou ou não disparou?

Checklist: o gatilho não casou

O fluxo começou, mas a mensagem não chegou

Perguntas frequentes