Gatilhos de mensageria (recebida, entregue, lida, falha, interatividade WA)

Conheça os gatilhos que iniciam um workflow conforme o ciclo de vida de uma mensagem e a interação do cliente no WhatsApp.

Jun 26, 2026

Veja este passo no vídeo · Os filtros do gatilho

Os gatilhos de mensageria são os eventos que iniciam um workflow conforme o que acontece com uma mensagem: chega uma nova, ela é entregue, o cliente a lê, o envio falha, ou o cliente toca em um botão no WhatsApp. Eles são a base para automatizar respostas, acompanhamentos e alertas.

Quando usar

  • Responder na hora quando chega uma mensagem.
  • Avisar um agente quando uma mensagem de saída falha.
  • Encadear passos quando o cliente lê ou interage com uma mensagem.

Os gatilhos disponíveis

Gatilho Dispara quando… Uso típico
Mensagem recebida O contato envia uma mensagem de entrada Resposta automática, rotear para um time
Mensagem entregue Sua mensagem de saída chegou ao dispositivo Marcar etapas de um envio
Mensagem lida O contato abriu/leu sua mensagem Acompanhar só quem leu
Mensagem de saída falhou Uma mensagem não pôde ser enviada Alertar o agente, tentar outro canal
Botão clicado O contato toca um botão interativo do WhatsApp Menus, confirmações, ramificar o fluxo

"Mensagem entregue" e "Mensagem lida" dependem dos recibos (ticks) que o WhatsApp reporta; se o cliente desativou as confirmações de leitura, o evento de leitura pode não chegar.

Passos para usar um gatilho de mensageria

  1. Abra Automações → Workflows e clique em Novo (ou edite um fluxo).
  2. Da paleta, arraste para o canvas o nó de gatilho que precisa (por exemplo, Mensagem recebida).
  3. Selecione o gatilho e, no inspetor, ajuste seus filtros: a qual Canal se aplica e, conforme o gatilho, dados como ID da mensagem ou template.
  4. Conecte o gatilho às ações desejadas (enviar mensagem, atribuir, esperar, condição…).
  5. Salve e ative o workflow na lista.

Verificação

  • Provoque o evento real: envie uma mensagem de teste, ou peça ao contato que toque em um botão.
  • Verifique o histórico de execuções do fluxo e confirme que ele disparou com o gatilho esperado.
  • Use o teste do editor com dados de exemplo para validar a lógica antes de ir para produção.

Se não funcionar

  • Não dispara em "Mensagem recebida": confirme o filtro de Canal e que nenhum outro workflow capture o mesmo evento antes.
  • "Mensagem lida" não chega: é normal se o cliente desativou as confirmações de leitura; não construa lógica crítica só sobre este evento.
  • "Botão clicado" não dispara: garanta que o botão venha de uma mensagem interativa do WhatsApp e que o ID/título do botão seja único.

Dicas

  • No WhatsApp, lembre-se da janela de 24 horas: fora dela só é possível iniciar com template. Combine "Mensagem recebida" com suas ações para responder dentro da janela.
  • Mantenha títulos de botões únicos: a Meta exige IDs/títulos únicos nos botões de resposta para que "Botão clicado" funcione bem.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp