Ir al contenido

Reintentos

Una entrega tiene éxito cuando tu endpoint responde con un estado 2xx en menos de 15 segundos. Cualquier otra cosa (un estado que no sea 2xx, una redirección, un tiempo de espera agotado, un error de conexión, un error de TLS) es un fallo y se reintenta.

SpacePost hace hasta 8 intentos: el primero de inmediato y después reintentos con esperas crecientes tras cada fallo.

Intento Espera tras el fallo anterior Aproximadamente tras el evento
1 inmediato 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

Tras el 8.º intento fallido, la entrega se marca como failed y no se hacen más intentos automáticos. Puedes reenviarla manualmente.

  • El webhook-id es el mismo en cada intento y el cuerpo es idéntico. El webhook-timestamp y la firma se regeneran en cada intento.
  • La entrega es de al menos una vez. Un 2xx lento que llega después del tiempo de espera se trata como un fallo, así que tu endpoint puede recibir el mismo evento dos veces. Deduplica por webhook-id.
  • El orden no está garantizado. Un email.delivered reintentado puede llegar después de un email.opened posterior. Usa created_at del payload y nunca hagas retroceder el estado de un correo.
  • Los webhooks desactivados o eliminados dejan de recibir entregas; las entregas pendientes se marcan como fallidas.
  • Los cuerpos de respuesta (el primer 1 KB) y los códigos de estado de los intentos recientes son visibles en el registro de entregas del panel, que conserva 30 días de historial.