O que é Webhook

Webhook resolve um problema específico: como saber que algo aconteceu em outro sistema sem ficar perguntando o tempo todo.

Sem webhook, a integração funciona por consulta repetida, o sistema pergunta a cada cinco minutos se há pedido novo. Isso gasta recurso, gera atraso de até cinco minutos e sobrecarrega a outra ponta com perguntas que quase sempre têm “não” como resposta.

Com webhook, a lógica inverte. O sistema de origem avisa no instante em que o evento acontece: um pedido foi criado, um pagamento foi confirmado, um documento foi assinado. A informação chega em segundos, sem consulta desperdiçada.

O cuidado que todo webhook exige é o tratamento de falha. Se o destino estiver fora do ar no momento do aviso, a mensagem pode se perder. Por isso uma integração bem construída sempre guarda o que recebeu e mantém uma fila de reprocessamento. Receber duas vezes é problema pequeno; perder um evento sem saber é problema grande.