Skip to main content
Entrega que falha é reenviada sozinha. O retry manual existe para quando você não quer esperar a próxima janela.

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 dead e 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á dead e 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.
Como a mesma entrega é reenviada com o mesmo 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.