Como funciona
Em vez de o cliente perguntar repetidamente se algo mudou (polling), o servidor envia uma requisição HTTP POST para uma URL configurada quando o evento ocorre. O receptor processa o payload e responde com 2xx para confirmar o recebimento. Isso inverte o fluxo: quem tem a informação a envia, economizando recursos.
Exemplo prático
Quando um pagamento é aprovado, o gateway envia um POST para https://seusite.com/webhooks/pagamento com os dados da transação. Seu sistema atualiza o pedido sem precisar consultar a API periodicamente, reduzindo latência e carga.
Para que serve
Automatiza integrações em tempo real com pouco código. É a base de notificações entre serviços, pipelines de IA e automações, como acionar um agente quando um novo issue é criado no GitHub.
Boas práticas
Valide a origem da requisição, use HTTPS, responda rapidamente e processe de forma assíncrona se necessário. Isso evita perda de eventos e falhas silenciosas em produção.