Engenharia
O que é Webhook?
Webhook é uma notificação HTTP que um serviço envia pra sua URL quando um evento acontece (pagamento confirmado, cancelamento, etc) — "API ao contrário".
Em vez de polling ("perguntar a cada 5 minutos"), o serviço empurra evento na hora. Stripe, Mercado Pago, GitHub, Twilio, Slack — todos usam webhook.
Boas práticas: validar assinatura (HMAC), retornar 200 rápido (processa async), idempotência (mesmo evento pode chegar 2x), e fila pra retry. Sem isso, webhook frágil quebra produção.
Termos relacionados
Perguntas frequentes
Webhook é seguro?
Só se validar assinatura (HMAC com secret do provider). Sem isso, qualquer um pode mandar payload fake pra sua URL.
Como debugar webhook que falha?
Logs estruturados + dashboard do provider (Stripe/MP mostram histórico) + ferramentas como Webhook.site pra capturar payload real.