Reenvio automático
Um worker roda a cada 5 minutos e retoma as entregas cuja próxima tentativa já venceu.- Backoff exponencial, a partir de 30 segundos: cada falha afasta a tentativa seguinte.
- Cada entrega guarda a sua próxima tentativa; o worker só pega o que já venceu.
- Esgotadas as tentativas, a entrega vai para o estado terminal
deade para de ser reagendada. A partir daí, só o reenvio manual. - Endpoints desabilitados não recebem retry, automático nem manual.
Quando forçar um manual
Use o reenvio manual quando:- você corrigiu validação de assinatura ou parsing do payload e não quer esperar;
- a entrega já está
deade você quer uma última tentativa; - seu endpoint voltou e você quer recuperar agora.
Como reenviar
Pelo app, abra/integracoes?tab=webhooks, localize uma entrega com status
failed ou dead e clique em reenviar.
Também existe rota autenticada por sessão:
O que acontece em cada tentativa
- A entrega usa o mesmo
delivery.id. attemptsé incrementado.- A nova resposta atualiza status, erro e dados de entrega.
x-atriby-delivery, mantenha
idempotência e deduplicação no consumidor por esse cabeçalho. Com o reenvio
automático ligado, receber a mesma entrega duas vezes é o caso normal, não a
exceção.