Webhook

É um mecanismo pelo qual um sistema avisa outro quando algo acontece, enviando uma requisição HTTP para um endereço previamente registrado. Em vez de o segundo sistema ficar perguntando “já terminou?” de tempos em tempos, ele é notificado quando o evento ocorre. É a forma mais comum de integrar processamento assíncrono de IA: o produto envia um lote de documentos, e o serviço de IA avisa pelo webhook quando a análise está pronta. É simples de implementar e amplamente suportado por plataformas e fornecedores.

Em Produto, webhooks são ideais para capacidades que demoram, como processamento de documentos ou análises em lote. O produto não fica travado esperando; segue funcionando e reage quando o resultado chega. Dois cuidados técnicos que afetam a experiência: idempotência (o mesmo evento pode chegar duas vezes, e o sistema não pode processar em dobro) e tratamento de falha (o que acontece se a notificação não for entregue). Por exemplo, ao concluir a análise de 200 laudos, o serviço de IA chama o webhook do sistema de vistoria com os resultados, e o sistema atualiza os casos correspondentes.

Use webhook para eventos pontuais entre sistemas, quando um precisa avisar o outro. Use fila de mensagens para volume alto e garantia de entrega. Use polling (perguntar periodicamente) apenas quando não há alternativa. Uma forma simples de diferenciar: webhook avisa quando acontece; fila guarda até alguém processar; polling fica perguntando.

Termo cunhado por Jeff Lindsay (2007); padrão de notificação HTTP entre sistemas.

Lindsay, Web hooks to revolutionize the web (2007); OpenAI Platform docs, Webhooks