O que é webhook e por que sua automação para sem ele

Toda vez que alguém me pergunta por que a automação parou de funcionar do nada, a resposta mora quase sempre no mesmo lugar: um webhook que parou de chegar, ou que nunca existiu e o sistema estava rodando por um “puxar dados a cada 10 minutos” que ninguém percebeu que era frágil.

Webhook é um conceito simples que vira confuso porque pouca gente explica sem jargão. Vou tentar sem.

O que é um webhook, na prática

Um webhook é um aviso automático. Quando algo acontece em um sistema (um pedido é pago, um lead preenche formulário, um boleto vence), esse sistema manda uma mensagem HTTP pra um endereço que você configurou, avisando “isso aconteceu, aqui estão os dados”. Não é você que vai buscar a informação. É o sistema que te avisa no exato momento em que ela existe.

A alternativa se chama polling: seu sistema fica perguntando “mudou alguma coisa? mudou alguma coisa?” de tempos em tempos. Funciona, mas tem custo: atraso (a resposta só existe no próximo ciclo), limite de requisições (a maioria das APIs bloqueia se você perguntar demais) e desperdício (boa parte das perguntas volta “não, nada mudou”).

Automação boa depende de saber o momento certo de agir. Webhook resolve isso. Polling tenta compensar a falta de webhook, com um atraso que às vezes é aceitável e às vezes quebra tudo, como um lead esperando resposta de um agente de IA no WhatsApp minutos depois de preencher o formulário.

Por que a automação “parou sozinha”

Quando um cliente me diz que a automação “estava funcionando e parou”, quase sempre é uma destas situações:

O endereço do webhook mudou (troca de servidor, troca de domínio) e ninguém atualizou a configuração lá na origem.

O sistema de origem revogou ou expirou o token de autenticação, e o webhook começou a chegar, mas sendo rejeitado silenciosamente.

Alguém trocou de plano ou de conta na ferramenta de origem, e o recurso de webhook simplesmente não está incluso naquele plano.

O endpoint que recebe o webhook começou a responder devagar ou com erro, e a ferramenta de origem, depois de algumas tentativas, desiste de mandar de novo.

Nenhum desses problemas aparece “na tela”. Você só percebe quando o lead não recebe resposta, o pedido não sincroniza ou o estoque fica errado. Por isso monitoramento de webhook, mesmo que simples (tipo logar cada recebimento), é parte do trabalho, não luxo.

Nem todo sistema tem webhook

Aqui entra uma limitação real: nem toda ferramenta oferece webhook pra tudo. Tem sistema que só manda notificação de um evento específico, tem sistema que não manda nada e obriga polling, e tem sistema que só libera webhook em planos mais caros.

Quando isso acontece, a saída costuma ser um meio-termo: polling inteligente, com intervalo curto só onde importa e cache pra não estourar limite de requisição. Não é tão bom quanto webhook nativo, mas resolve.

Onde isso aparece no seu dia a dia

Se você usa CRM, ERP, e-commerce ou ferramenta de marketing, provavelmente já depende de webhook sem saber: notificação de pagamento aprovado, novo lead que entra num funil, pedido que muda de status, boleto que vence. Cada uma dessas notificações, se estiver bem configurada, dispara uma ação automática. Se estiver mal configurada, ou simplesmente não existir, vira trabalho manual disfarçado de sistema.

Isso é o que costumo olhar primeiro quando pego uma integração de sistemas pra montar ou revisar: quais eventos realmente têm webhook disponível, quais dependem de polling, e onde estão os pontos cegos que podem parar de funcionar sem avisar ninguém.

Conclusão

Webhook não é um detalhe técnico chato. É a diferença entre um sistema que reage em tempo real e um sistema que reage “quando alguém perceber que parou”. Se sua operação depende de automação, seja WhatsApp, CRM, ERP ou e-commerce, vale a pena entender onde estão seus webhooks, e onde não tem nenhum.

Quer revisar as integrações da sua operação e achar os pontos cegos antes que eles virem problema? Fale comigo.