Webhook parece assunto de desenvolvedor e acaba ficando de fora da conversa de negócio. Mas é ele que decide se o seu WhatsApp é uma ilha ou parte do seu sistema.
O conceito, sem jargão
Existem dois jeitos de um sistema saber que algo aconteceu em outro.
O primeiro é perguntar de tempos em tempos: “tem mensagem nova? E agora? E agora?”. Funciona, desperdiça recurso e sempre chega atrasado.
O segundo é o webhook: o WhatsApp avisa seu sistema no instante em que o evento acontece. Seu sistema não pergunta nada — ele é chamado.
A diferença prática é latência. Com webhook, o pedido entra no seu ERP no segundo em que o cliente confirma. Sem ele, entra quando alguém lembrar de consultar.
Os eventos que mais valem
Nem todo evento merece integração. Na prática, quatro resolvem a maioria dos casos:
- Mensagem recebida — o mais usado. Dispara criação de lead, abertura de chamado, registro no CRM.
- Status de entrega — enviada, entregue, lida. Serve para medir alcance real de campanha.
- Falha de envio — número inválido, bloqueio. Alimenta a higienização da base.
- Mudança na conta — restrição ou alerta de política. Este é subestimado: é como você fica sabendo de um problema na conta sem precisar olhar o painel todo dia.
O que dá para montar com isso
Alguns fluxos que resolvem problema real:
Lead direto no CRM. Mensagem chega → cria contato com a origem registrada. Ninguém digita nada, e você para de perder lead que ficou só no celular.
Pedido para o ERP. Confirmação no WhatsApp → pedido criado no sistema de gestão.
Aviso interno. Cliente marcado como prioritário escreveu → alerta no canal da equipe.
Higienização. Falha de entrega repetida → contato marcado como inválido na base.
Reação a restrição. Aviso de violação → alerta imediato para quem cuida da conta, em vez de descobrir quando as campanhas pararem.
Sem programar
Se você não tem equipe técnica, plataformas de automação visual conectam o webhook a centenas de sistemas por arrastar e soltar. As mais usadas são n8n, Make e Zapier.
Escrevemos um passo a passo específico em como integrar o WhatsApp com n8n.
Os erros que derrubam integração
Não confirmar o recebimento. Seu endpoint precisa responder 200 OK a cada notificação. A documentação da Meta é explícita sobre o que acontece quando ele não responde isso: a entrega é repetida com frequência decrescente por até 7 dias. Se o seu fluxo processa tudo antes de confirmar, ele acumula reenvio em cima de trabalho que já está rodando. Receba, confirme, processe depois.
Não tratar duplicata. Consequência direta do item anterior — e a documentação diz com todas as letras que o tratamento é do seu lado: “your server should handle deduplication in these cases”. Se o seu fluxo cria um pedido por evento recebido, você vai duplicar pedido. Guarde o identificador da mensagem e ignore o que já processou.
Endpoint sem autenticação. Uma URL pública que aceita qualquer requisição é um convite. Não precisa inventar mecanismo: a Meta assina todo payload com SHA256 e envia a assinatura no cabeçalho X-Hub-Signature-256. Você recalcula a assinatura com o App Secret e compara. Se não bater, a requisição não veio de lá.
Ignorar erro silenciosamente. Integração que falha sem avisar é pior que integração inexistente — você acredita que os dados estão lá.
Vale a pena para você?
Se sua equipe copia informação do WhatsApp para outro sistema à mão, vale. Esse trabalho manual é onde nascem os erros de digitação, os leads esquecidos e o “achei que você tinha lançado”.
Se o WhatsApp é um canal isolado e de baixo volume, não vale a complexidade ainda.