O que é Webhook? Como funciona na prática | Mais Social

Webhook é o mecanismo pelo qual um sistema avisa outro automaticamente quando um evento acontece, em tempo real. Diferente de uma API tradicional (onde você precisa perguntar), o webhook empurra a informação assim que ela existe. É a base de integrações em tempo real: comentário novo, venda finalizada, pagamento confirmado.

O que é Webhook?

Webhook (também chamado de "callback HTTP") é uma forma de um sistema enviar informação automaticamente para outro sistema assim que um evento acontece. Imagine como um SMS automático: você não precisa ficar perguntando, o sistema avisa quando algo muda.

É o oposto da abordagem tradicional de API:

API "puxa" (polling): você pergunta a cada X minutos "tem novidade?"
Webhook "empurra" (push): o sistema avisa no instante em que acontece

Como funciona

Você cadastra uma URL (endpoint) no sistema origem
Sistema origem registra: "quando evento X acontecer, mande POST pra essa URL"
Evento acontece (ex: alguém finaliza compra)
Sistema origem envia automaticamente um POST com payload JSON pra sua URL
Seu sistema recebe e processa

Exemplo prático

E-commerce conectado com automação de e-mail via webhook:

Você cadastra a URL https://seudominio.com/webhooks/compra no Shopify. Quando alguém compra, Shopify envia:

POST https://seudominio.com/webhooks/compra
Content-Type: application/json

{
  "order_id": "5894371",
  "customer_email": "ana@exemplo.com",
  "total": 289.90,
  "items": [
    { "name": "Hidratante Facial", "qty": 1 }
  ],
  "created_at": "2026-06-05T14:32:01Z"
}

Sua automação recebe e:

Adiciona Ana à lista "Compradores recentes"
Dispara e-mail de agradecimento em 5 minutos
Agenda e-mail de cross-sell em 14 dias
Envia o evento Purchase pro Pixel via Conversions API

Casos de uso comuns

E-commerce: compra → automação de e-mail, CRM, BI
Pagamento: Stripe/Pagar.me → confirma e libera serviço
Redes sociais: comentário novo → equipe de SAC
Conversions API: evento → Meta Ads
WhatsApp Business API: mensagem recebida → chatbot
Github/Gitlab: push → deploy automático

Boas práticas

Validar assinatura (HMAC) pra confirmar que o webhook veio da origem real
Responder 200 OK rapidamente (em até 5 segundos)
Processar em fila assíncrona pra não bloquear
Implementar idempotência (mesmo evento pode chegar 2x)
Logar tudo pra debug
Ter endpoint público com HTTPS

Erros comuns

Não validar assinatura — qualquer um pode enviar requisição falsa
Demorar pra responder e o origem retentar várias vezes
Não tratar duplicatas (mesmo pagamento processado 2x)
Endpoint HTTP (sem SSL) — origem moderna recusa
Não monitorar falhas (webhook caiu e você descobre 3 dias depois)

Webhook