Gatilhos de automação: como configurar sem levar susto
As portas de entrada de um fluxo, o cuidado com a chave do webhook e o teste que evita descobrir o disparo duplicado pelo cliente.
Um cliente recebeu a mesma mensagem de confirmação quatro vezes em dois minutos. O fluxo estava certo, a mensagem estava certa, o problema eram os gatilhos de automação: o sistema externo reenviava o evento a cada falha de resposta e eu tinha apontado esse webhook direto para o fluxo, sem nenhum controle de repetição.
Descobri isso pelo print que o comercial mandou no grupo. Nunca esqueci. Gatilho é a peça que ninguém olha até ela disparar errado, e quando dispara errado, dispara para todo mundo.
Aqui vai como eu configuro hoje: as portas de entrada disponíveis, o cuidado com a chave do webhook e o teste que faço antes de ligar. Para entender o fluxo que vai ser acordado, comece por o que é o Flow Builder.
As portas de entrada e os gatilhos de automação
Um fluxo ativo sem porta de entrada é decoração. Existem quatro caminhos para acordar uma jornada, e escolher o errado gera aquele bug esquisito em que tudo parece certo e nada acontece.
| Porta de entrada | Quando ela é a escolha certa |
|---|---|
| Gatilho de automação | O disparo nasce de um evento do próprio CRM |
| Webhook por chave | O disparo vem de sistema externo, em automacao/webhook/{chave} |
| Regra de auto atendimento | A entrada é a mensagem espontânea do contato |
| Chamada por bloco Flow | A jornada é um subfluxo acionado por outra |
A confusão mais comum que eu vejo é montar um fluxo lindo, ativar e esperar. Sem gatilho, ele fica ali, ativo e mudo. Confira o bloco Início, que mostra conexão, gatilho e modo real do fluxo, antes de sair procurando defeito no desenho.
Gatilho interno: o evento manda no comportamento
Gatilho ligado a evento do CRM é o caminho mais previsível, porque o evento acontece dentro de casa e você consegue reproduzir na hora que quiser. Comece por aqui sempre que puder.
O cuidado principal é com evento que dispara mais do que você imagina. Antes de ligar, pergunte quantas vezes por dia esse evento acontece no volume atual. Já liguei um gatilho achando que seriam dez disparos por dia e eram quatrocentos.
Webhook por chave: a porta que vem de fora
A entrada em `automacao/webhook/{chave}` recebe chamada de sistema externo. É o caminho natural quando o disparo nasce numa plataforma de e-commerce, num sistema legado ou em qualquer coisa que ninguém quer tocar mais.
- Trate a chave como segredo: quem tem a chave dispara o fluxo
- Confirme quantas vezes o sistema de origem reenvia em caso de falha
- Combine o formato do que chega antes de desenhar a jornada
- Tenha um caminho para o payload que chega incompleto ou fora do esperado
- Registre o recebimento antes de qualquer envio ao cliente
O segundo item é a origem do meu problema das quatro mensagens. Sistema externo reenvia. Sempre. Se o seu fluxo manda mensagem logo no primeiro bloco, cada reenvio vira uma mensagem para o cliente.
O teste que eu faço antes de ligar
- Deixe o fluxo inativo e o gatilho apontadoAssim você observa a chegada do evento sem que ninguém receba mensagem.
- Dispare o evento de propósitoReproduza a ação no CRM ou chame o webhook manualmente com um caso real do dia.
- Repita o mesmo disparoDuas ou três vezes seguidas, para ver como o fluxo se comporta com repetição.
- Verifique o que chegouConfira se os dados esperados vieram e o que acontece quando falta um campo.
- Ative em horário de pouco volumeCom alguém acompanhando as primeiras conversas ao vivo, pronto para desligar.
Esse roteiro entra no checklist de publicação junto com a validação estrutural. Separar as duas coisas é o que me faz esquecer uma delas.
Quando o gatilho conversa com outras áreas
Evento de pedido, de pagamento e de entrega costumam nascer fora do atendimento. Antes de ligar o gatilho, converse com quem cuida da origem e pergunte se aquele evento pode ser reprocessado, cancelado ou corrigido depois. Reprocessamento em massa vira disparo em massa.
Aconteceu comigo com uma correção de status feita em lote no cadastro do ERP. Alguém arrumou trezentos registros de uma vez, o evento disparou trezentas vezes e o fluxo fez o trabalho dele com perfeição. Foi um belo desastre bem executado.
Depois de ligar, olhe os números
Volume de disparos por dia é o primeiro indicador que eu abro depois de ativar um gatilho novo. Se o número surpreende, alguma coisa está diferente do combinado. As leituras estão em métricas de automação do chatbot e valem mais nos primeiros sete dias do que em qualquer outro momento.