← Voltar ao glossário

Webhook

Mecanismo em que um sistema avisa outro automaticamente quando algo acontece, enviando uma requisição HTTP para uma URL que você cadastrou. É o contrário de ficar perguntando: o evento vem até você.

Um webhook é uma notificação automática entre sistemas. Você cadastra uma URL sua no serviço de origem; quando um evento acontece lá (uma mensagem chega, um pagamento é aprovado, um formulário é enviado), o serviço faz uma requisição HTTP (geralmente um `POST` com um JSON descrevendo o evento) para essa URL, na hora.

A alternativa seria o *polling*: seu sistema perguntando de tempos em tempos "aconteceu algo novo?". Webhooks eliminam esse desperdício: nada de perguntas repetidas, o dado chega assim que existe. Por isso são a espinha dorsal de integrações e automações: plataformas como Zapier funcionam essencialmente recebendo e disparando webhooks entre centenas de apps.

Exemplo concreto: um chatbot de WhatsApp. A API de WhatsApp recebe a mensagem do cliente e imediatamente dispara um webhook para o servidor do bot, que processa o texto e responde. Sem webhook, o bot teria que consultar a API a cada poucos segundos para ver se chegou mensagem nova.

Na prática, quem recebe webhooks precisa cuidar de dois pontos: validar a origem (assinaturas ou tokens, para não aceitar requisições forjadas) e responder rápido (confirmar o recebimento e processar depois, para o serviço de origem não considerar a entrega falha e reenviar).

Categorias

Veja também