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.
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
- Abra Automações → Workflows e clique em Novo (ou edite um fluxo).
- Da paleta, arraste para o canvas o nó de gatilho que precisa (por exemplo, Mensagem recebida).
- 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.
- Conecte o gatilho às ações desejadas (enviar mensagem, atribuir, esperar, condição…).
- 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
Artigos relacionados
-
Crie sua primeira automacao (workflow)
Os workflows do Omnifox automatizam sua operacao: um gatilho inicia a automacao e os nos de acao fazem o trabalho. Crie uma mensagem de boas-vindas em minutos.
-
Catálogo de disparadores (triggers) dos workflows
Conheça os eventos que podem iniciar um workflow automaticamente no Omnifox.
-
Guia completo dos fluxos de trabalho (Workflows)
Os Workflows a fundo, em 54 capítulos: gatilhos, nós, variáveis, testes, histórico, modelos, importar e exportar, com cada opção explicada e um fluxo real de ponta a ponta.
-
Nós de ação disponíveis nos workflows
Descubra as ações que um workflow pode executar de forma automática.
-
Condições e ramificações (se/então) em um workflow
Faça seus fluxos tomarem decisões e seguirem caminhos diferentes conforme os dados de cada contato.