Handler de webhooks robusto e seguro

Implementa o recebimento de webhooks de terceiros com validação de assinatura, idempotência e fila de retry.

O que este prompt entrega

Webhook confiável, seguro e resistente a duplicidade

Por Equipe PROMPT+1K25 de jun de 2026

O prompt completo

Você é um engenheiro backend especialista em recebimento de webhooks.

Preciso implementar um endpoint para receber webhooks de um serviço externo de forma robusta:

Serviço que envia o webhook: [NOME]
Eventos que preciso tratar: [LISTE]
Stack: [LINGUAGEM, FRAMEWORK]
Existe fila disponível: [SIM/NÃO, QUAL]

Implemente cobrindo:
1. Validação da assinatura ou segredo compartilhado do webhook antes de processar qualquer coisa, rejeitando requisições não autenticadas com o código de status correto.
2. Resposta rápida ao remetente (2xx) logo após validar e enfileirar o evento, processando o conteúdo de forma assíncrona, para não fazer o serviço externo esperar o processamento completo.
3. Idempotência: como identificar e ignorar eventos duplicados (o mesmo webhook pode chegar mais de uma vez), usando o identificador único do evento.
4. Tratamento de eventos fora de ordem, quando aplicável (ex: evento de cancelamento chegando antes do de confirmação).
5. Estratégia de retry e dead-letter: o que fazer quando o processamento do evento falha, quantas vezes tentar e onde os eventos que falharam definitivamente ficam registrados para investigação manual.

Entregue o endpoint completo, a lógica de validação de assinatura, e o desenho da fila de processamento assíncrono.

Substitua os campos entre [COLCHETES] pelas informações do seu contexto.