Os endpoints cadastrados para receber os eventos de webhook devem responder rapidamente com um status de sucesso (família 2xx), sem realizar o processamento do evento de forma síncrona antes da resposta. Isso é essencial para manter o fluxo saudável de eventos. A 180 pode determinar timeouts e considerar a entrega como falha caso o endpoint demore a responder.
Quando a tentativa inicial de envio do webhook falhar, serão realizadas até 3 retentativas automáticas, nos seguintes intervalos:
1ª retentativa: após 10 minutos
2ª retentativa: após 1 hora
3ª retentativa: após 4 horas
Essa estratégia busca aumentar a resiliência da entrega em cenários de falhas temporárias ou indisponibilidades momentâneas do sistema de destino. Caso todas as tentativas sejam esgotadas sem sucesso, a mensagem seguirá para o fluxo de tratamento do time de Suporte e Operações.
AtençãoNão é possível garantir a ordem em que os eventos serão entregues. De modo geral, espera-se que as entregas aconteçam à medida que os eventos ocorram e, portanto, na mesma ordem. No entanto, isso não pode ser garantido, principalmente em casos de falha na entrega e retentativas ou quando eventos acontecem muito próximos uns dos outros.
Também não há garantia de uma única entrega de cada evento. É possível que o mesmo evento seja entregue mais de uma vez. Recomenda-se que o processamento seja idempotente, considerando que o evento pode já ter sido processado, ou que seja mantido um controle dos id-evento já processados.