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

> Webhook é um aviso automático que um sistema manda para outro no momento em que algo acontece, como uma venda aprovada, um formulário enviado ou um horário agendado. O aviso chega a um endereço na internet com os dados do acontecimento, e o sistema que recebe faz o passo seguinte sozinho: grava o cliente, manda um e-mail ou registra a venda. A diferença para a API é a direção: na API alguém pergunta, no webhook o sistema avisa.

Publicado em 2026-11-07. Por [Paulo Sabbanelli](https://paulosabbanelli.com.br/sobre/), especialista em tecnologia para comunicação, marketing e vendas.
URL: https://blog.paulosabbanelli.com.br/automacao-crm-e-gestao-de-leads/webhook/

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.

![Peças de dominó caindo em sequência sobre fundo cinza claro, as pretas no começo e as coloridas no fim](https://blog.paulosabbanelli.com.br/img/como-escalar-uma-campanha-sem-perder-roas.jpg "Um evento derruba o próximo sozinho")

## 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](/autoral-e-visao-de-mercado/a-conta-que-ninguem-faz-quanto-custa-nao-medir-conversao/).

<ChamadaServico servico="rastreamento-server-side" artigo="webhook" />

## 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](/estrategia-e-presenca-digital/glossario-de-aquisicao-e-dados-os-termos-que-uso-e-o-que-significam/).

## 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](/automacao-crm-e-gestao-de-leads/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.

![Ilustração de uma mangueira de jardim que sai de uma torneira na parede e solta só uma gota num balde vazio, enquanto um nó laranja na mangueira, escondido atrás de um arbusto, impede a água de chegar](https://blog.paulosabbanelli.com.br/img/claude-code-para-nao-programadores-3.jpg "O nó escondido que ninguém vê")

**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](/inteligencia-artificial/claude-code/claude-code-avancado/api-error-connection-refused-a-firewall-or-proxy-may-be-blocking-it-econnrefused-resolvido-em-setembro-de-2026/): 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](/dados-rastreamento-e-atribuicao/rastreamento-server-side/rastreamento-server-side-explicado-para-quem-decide-nao-para-quem-implementa/).

## Perguntas frequentes sobre webhook

### Para que serve um webhook?

Para um sistema avisar outro, na hora, que algo aconteceu. Com o aviso, o segundo sistema faz o próximo passo sozinho, como cadastrar o cliente no CRM ou mandar a confirmação por e-mail.

### Qual a diferença entre webhook e API?

Na API, o seu sistema pergunta e recebe a resposta quando quer. No webhook, o outro sistema avisa por conta própria quando o evento acontece, sem ninguém perguntar.

### Webhook é seguro?

É, quando quem recebe confere a assinatura de cada aviso com um segredo combinado com a plataforma. Sem essa conferência, qualquer pessoa que descubra o endereço pode mandar um aviso falso.

### Precisa saber programar para usar webhook?

Não. Ferramentas de integração como n8n, Make e Zapier recebem o aviso e repassam os dados sem código; o código entra quando a regra é muito particular.

### O que acontece se o webhook falhar?

Depende da plataforma. A Kiwify reenvia algumas vezes e o Mercado Pago espaça as novas tentativas; sem um registro de cada aviso, a falha passa sem ninguém ver.


[Se os seus anúncios otimizam com dados incompletos, o rastreamento server-side com a API de Conversões devolve os eventos que o navegador perde.](https://contrate-me.paulosabbanelli.com.br/rastreamento-server-side/?de=webhook)