Webhook: o que é e como ele liga os sistemas da sua empresa sem ninguém digitar nada

Quando alguém paga um pedido, agenda um horário ou preenche o formulário do site, outro sistema da empresa precisa saber: a planilha de clientes, o CRM, o relatório de vendas. O webhook é a peça que leva esse aviso de um sistema para o outro no mesmo instante, sem alguém copiar e colar os dados.

O que é um webhook, em poucas palavras?

Webhook é um aviso automático entre sistemas. Quando um evento combinado acontece, o sistema de origem manda uma mensagem para um endereço na internet que você cadastrou. Esse endereço pertence ao sistema que precisa saber do evento, e ele faz o passo seguinte por conta própria.

O contrário do webhook é perguntar a toda hora. Sem ele, alguém (ou algum programa) teria de entrar no painel da plataforma de pagamento de tempos em tempos para ver se caiu venda nova. Com ele, a plataforma avisa assim que a venda cai.

Todo webhook tem quatro partes:

• O evento: o que dispara o aviso, como “compra aprovada”, “pedido pago” ou “horário agendado”.
• O endereço: a URL que recebe o aviso, informada por você no painel da plataforma.
• O conteúdo: os dados do evento, como número do pedido, produto, valor, nome e e-mail de quem comprou.
• A resposta: o sistema que recebe devolve um “recebi”. Sem essa resposta, a plataforma entende que o aviso se perdeu.

Como funciona um webhook na prática: a venda aprovada no contrate-me

O exemplo que conheço por dentro é o meu. O contrate-me, a minha loja de serviços, vende pelo checkout da Kiwify, que fica fora do meu site. Sem webhook, o meu site nunca saberia que uma venda aconteceu, porque o pagamento termina na página da Kiwify.

Em 27 de setembro de 2026, cadastrei na Kiwify um webhook para o evento “Compra aprovada”. A partir daí, a cada venda aprovada, este é o caminho:

1. A Kiwify manda o aviso para uma função do meu site, que roda no Cloudflare Pages, no plano gratuito.
2. A função confere a assinatura do aviso com o segredo combinado com a Kiwify. Aviso sem assinatura válida é recusado.
3. Ela confere se o produto é um serviço do site. A Kiwify só deixa escolher um produto por webhook ou todos, e a minha conta tem outros; os avisos desses recebem o “recebi” e são ignorados.
4. A venda vai para a Meta como evento de compra, pela API de Conversões, e para o GA4 como purchase, ligada à visita e ao anúncio de origem.
5. O comprador recebe um e-mail de boas-vindas com o prazo, as etapas do serviço e um botão para começar o briefing no WhatsApp.

Ninguém digita nada entre o pagamento e esses três envios. Sem o webhook, o meu relatório mostraria gente indo para o checkout e nunca uma venda. Quanto custa operar sem enxergar a venda está em a conta que ninguém faz: quanto custa não medir conversão.

Qual a diferença entre webhook e API?

A API é a porta que um sistema abre para outros programas pedirem dados ou mandarem ordens. O webhook é o aviso que esse sistema manda por iniciativa própria.

	API	Webhook
Quem começa	O seu sistema pergunta	A plataforma avisa
Quando acontece	Quando você decide consultar	No momento do evento
Exemplo	Consultar o status de um pedido	Receber o aviso de pedido pago
Custo de ficar sabendo	Perguntas repetidas, a maioria sem novidade	Um aviso por evento
Uso comum	Buscar dados completos, criar ou alterar registros	Disparar o passo seguinte de um processo

Na prática, os dois andam juntos. A documentação do Mercado Pago orienta, depois de receber o aviso de pagamento, consultar a API para buscar os dados completos daquele pagamento. A Nuvemshop manda avisos enxutos, com o tipo do evento e o número do pedido, e o resto dos dados também se busca pela API. O webhook diz “aconteceu”; a API conta os detalhes.

Os termos que aparecem junto com esses dois, como evento, conversão e atribuição, estão explicados no glossário de aquisição e dados.

Onde a sua empresa já tem webhooks sem saber?

Boa parte das ferramentas de uma pequena empresa já oferece webhook, num menu chamado “Integrações”, “Desenvolvedores”, “Apps” ou “Webhooks”:

• Na plataforma de pagamento: a Kiwify tem webhook no menu de apps, com eventos como compra aprovada e compra recusada. O Mercado Pago manda notificações de pagamento criado e de mudança de status (pendente, recusado, aprovado).
• Na loja virtual: a Nuvemshop tem eventos de pedido, como pedido pago, empacotado e cancelado. É o aviso que pode alimentar o controle de estoque ou a emissão da nota.
• Na agenda online: no Calendly, a central de ajuda (atualizada em março de 2026) diz que o webhook está disponível nos planos Standard, Professional, Teams e Enterprise, e ele dispara quando um horário é agendado ou cancelado.
• No formulário e no CRM: muitos construtores de formulário e CRMs mandam um aviso a cada contato novo ou a cada mudança de etapa da negociação. Confira no menu de integrações da ferramenta que você usa.

Para achar o primeiro webhook que vale ligar, pergunte qual informação alguém da equipe copia de um sistema para outro toda semana: o pagamento que vira linha na planilha, o agendamento que vira lembrete, o contato do formulário que vira negócio no CRM. Cada cópia tem um evento por trás, e o evento costuma ter webhook.

O que fazer com o aviso: ferramenta sem código ou um pequeno código?

O webhook só avisa. Alguém precisa receber o aviso e decidir o que fazer com ele. Há dois caminhos.

Ferramenta de integração sem código. O n8n tem um nó de webhook que inicia um fluxo quando outro serviço manda dados, com um endereço de teste e outro de produção, segundo a documentação do próprio n8n. O Make tem um gatilho de webhook personalizado. No Zapier, o recurso “Webhooks by Zapier” é um app premium e não fica ligado no plano gratuito, segundo a comunidade oficial da ferramenta. Nas três, você cola o endereço gerado no painel da plataforma de origem e monta os passos seguintes.

Um pequeno código. Quando a regra é particular, uma função curta resolve. Foi o caminho do contrate-me: filtrar produtos, ligar a venda ao anúncio e mandar o mesmo evento para dois lugares diferentes ficaria trabalhoso numa ferramenta de arrastar blocos.

O meu critério: se o fluxo cabe em “quando chegar o pagamento, grave na planilha e avise a equipe”, a ferramenta sem código resolve e qualquer pessoa entende o que está montado. Com filtro, conferência de assinatura e mais de um destino, o código fica mais curto e mais fácil de testar.

Que cuidados evitam um webhook que falha calado?

Webhook quebrado não costuma dar erro na tela de ninguém. A venda acontece, o aviso se perde e a planilha fica sem a linha. Estes são os quatro cuidados que tomei no contrate-me.

1. Conferir a assinatura. O endereço do webhook fica num painel e pode vazar. Por isso as plataformas assinam cada aviso com um segredo. A documentação da Kiwify explica que a assinatura é calculada com o token cadastrado no webhook e que, sem token, ela não prova nada. O Mercado Pago gera uma assinatura secreta por aplicação. Quem recebe confere a assinatura e recusa o que não bate. E o segredo fica guardado no servidor, nunca em print, planilha ou conversa.

2. Tratar o aviso repetido. A Kiwify avisa na documentação que o mesmo evento pode chegar mais de uma vez e recomenda tratar cada um pela combinação do número do pedido com o tipo do evento. No contrate-me, o serviço de e-mail recebe uma chave por pedido, então um reenvio da Kiwify não manda um segundo e-mail de boas-vindas. Pelo mesmo motivo, a venda vai à Meta com um identificador derivado do pedido. E deixei desligados o Pixel e o Google Analytics dentro da Kiwify: se ela também enviasse a compra, cada venda seria contada duas vezes.

3. Saber o que acontece quando o aviso falha. Pela documentação da Kiwify, qualquer resposta fora da faixa de sucesso, um redirecionamento ou a falta de resposta em até 40 segundos contam como falha, e a entrega é reenviada algumas vezes, com intervalo crescente de 1 a 10 minutos. O Mercado Pago espera a confirmação por 22 segundos, tenta de novo a cada 15 minutos e, depois da terceira tentativa, espaça os envios. Se o sistema que recebe ficar fora do ar por tempo demais, os avisos chegam atrasados ou alguém precisa reenviá-los à mão.

4. Guardar registro (log) de cada aviso. A Kiwify tem uma área de logs de onde dá para reenviar uma entrega manualmente. Do lado de quem recebe, vale registrar cada aviso, a resposta e o que foi feito com ele. No contrate-me, a resposta do webhook lista só os nomes dos dados enviados à Meta, nunca os valores. Dá para investigar sem expor segredos, e foi assim que resolvi o erro contado em Connection refused no Claude Code: olhando os nomes das variáveis, sem mostrar o conteúdo delas.

Teste antes de confiar. A Kiwify não tem ambiente de teste para webhooks, segundo a própria documentação; o botão “Testar Webhook” manda dados fictícios. Para o teste de ponta a ponta, uso um produto de teste que nunca entra nos dados reais, e o caminho inteiro do sinal (link do checkout, webhook, evento na Meta e no GA4) é conferido por testes automáticos antes de cada nova versão do site. Se o rastreamento quebrar, a versão não sobe.

Como pedir um webhook a um fornecedor?

Com estas perguntas em mãos, a conversa com quem vai montar a integração fica objetiva:

1. Qual evento dispara o aviso? Escreva em uma frase. “Quando o pagamento for aprovado” é mais preciso que “quando o cliente comprar”, que pode incluir boleto ainda não pago.
2. O que acontece depois, e em que ordem? Gravar onde, avisar quem, mandar qual mensagem.
3. Como a assinatura é conferida, e onde o segredo fica guardado?
4. O que acontece se o mesmo aviso chegar duas vezes? A resposta certa cita o número do pedido.
5. Onde fica o registro de cada aviso, e quem é alertado quando um falha?
6. Como vamos testar antes de ligar para valer? Peça para ver um teste com dados de verdade passando pelo caminho inteiro.
7. Em nome de quem ficam as contas e os acessos? A ferramenta de integração e o painel da plataforma ficam no nome da empresa, com o fornecedor como convidado.

Se a integração envolve medir venda para os anúncios, o desenho completo, do navegador ao servidor, está em rastreamento server-side explicado para quem decide.