Pular para o conteúdo

Novas tentativas

Uma entrega tem sucesso quando o seu endpoint responde com um status 2xx em até 15 segundos. Qualquer outra coisa (status que não seja 2xx, redirecionamento, timeout, erro de conexão, erro de TLS) é uma falha e será repetida.

O SpacePost faz até 8 tentativas: a primeira imediatamente e, depois, novas tentativas com atrasos crescentes após cada falha.

Tentativa Atraso após a falha anterior Aproximadamente após o evento
1 imediata 0
2 5 segundos 5 s
3 5 minutos 5 min
4 30 minutos 35 min
5 2 horas 2 h 35 min
6 5 horas 7 h 35 min
7 10 horas 17 h 35 min
8 10 horas 27 h 35 min

Depois da 8ª tentativa com falha, a entrega é marcada como failed e nenhuma outra tentativa automática é feita. Você pode reenviá-la manualmente.

  • O webhook-id é o mesmo em todas as tentativas, e o corpo é idêntico. O webhook-timestamp e a assinatura são regenerados a cada tentativa.
  • A entrega é feita pelo menos uma vez. Um 2xx lento que chega depois do timeout é tratado como falha, então o seu endpoint pode receber o mesmo evento duas vezes. Faça a deduplicação pelo webhook-id.
  • A ordem não é garantida. Um email.delivered repetido pode chegar depois de um email.opened posterior. Use o created_at do payload e nunca faça o estado de um e-mail retroceder.
  • Webhooks desativados ou excluídos deixam de receber entregas; as entregas pendentes deles são marcadas como failed.
  • Os corpos das respostas (o primeiro 1 KB) e os códigos de status das tentativas recentes ficam visíveis no log de entregas do painel, que guarda 30 dias de histórico.