Boas Práticas Recomendadas

1. Confirmação de Recebimento

Sua aplicação deve confirmar o recebimento de cada evento de forma clara para o nosso serviço.

• Status Code: Responda sempre com HTTP 200 OK.
• Falhas: Qualquer código de resposta diferente de 2xx (como 400 ou 500) será interpretado como uma falha na entrega.

2. Tempo de Resposta e Performance

O Webhook é um serviço sensível ao tempo. Processamentos demorados do seu lado podem causar falhas em cascata.

• Timeout Rígido: Nossa plataforma aguarda no máximo 5 segundos por uma resposta.
• Consequência: Requisições que ultrapassarem este tempo serão encerradas e marcadas como falha.
• Recomendação de Ouro: Se precisar realizar operações complexas (como chamadas a outros serviços ou consultas pesadas em banco de dados), processe a mensagem em background (segundo plano) e responda ao webhook imediatamente.

3. Política de Retentativa (Retry Policy)

Caso ocorra uma falha (erro de status ou timeout), o serviço de Webhook realizará até 5 tentativas de entrega dentro de um intervalo de 40 minutos.

Abaixo, veja o cronograma de disparos em caso de erro persistente:

Esgotamento: Após a 5ª tentativa sem sucesso, a mensagem é definitivamente marcada como falha e não será reenviada.

4. Idempotência de Fluxos

Intermitências de rede podem fazer com que uma mensagem que você já processou com sucesso seja reenviada pelo nosso serviço de retentativa.

• Preparação: Sua aplicação deve estar preparada para receber a mesma mensagem (mesmo ID de proposta e evento) mais de uma vez.
• Ação: Implemente uma lógica de verificação para garantir que o processamento de um evento duplicado não gere inconsistências no seu sistema.