Entrega y repetición
Entrega, reintentos y pausa automática
Una entrega fallida (respuesta que no sea 2xx, tiempo de espera agotado o error de red) se reintenta con retroceso exponencial: 5 s, 30 s, 2 min, 10 min, 1 h, 4 h, y luego un último intento aproximadamente 24 horas después del primero. Si un endpoint falla durante 72 horas continuas, se pausa automáticamente y se notifica por correo a quien lo creó; no se entregan más eventos hasta corregirlo y reanudarlo.
Solucionar problemas de entrega
Resultados de respuesta habituales y cómo solucionar cada uno.
No se puede conectar | Asegúrate de que tu host sea accesible públicamente y no esté bloqueado por un firewall. |
Redirección 3xx | Las redirecciones se tratan como fallos. Apunta el endpoint directamente a la URL final. |
Error de cliente 4xx | Tu servidor rechazó la solicitud. Comprueba que la URL sea correcta y no requiera una autenticación que no enviamos. |
Error de servidor 5xx | Tu servidor falló al procesar la solicitud. Revisa los registros de tu aplicación. |
Tiempo de espera agotado | Tu endpoint tardó demasiado. Devuelve un 2xx de inmediato y procesa el evento de forma asíncrona. |
El orden de los eventos no está garantizado
Los eventos pueden llegar desordenados, y los reintentos implican que el mismo evento puede entregarse más de una vez. No dependas del orden de entrega y elimina duplicados usando el id del sobre, nunca created_at, ya que dos eventos pueden compartir marca de tiempo.
Repetición
Cualquier entrega individual, correcta o fallida, puede repetirse a demanda desde el historial de entregas en Configuración → Desarrollador → Webhooks. Una repetición vuelve a entrar en la misma canalización de entrega con un nuevo ciclo de reintentos; no reenvía nada retroactivamente por sí sola.
Probar tu endpoint
Usa «Enviar evento de prueba» en Configuración → Desarrollador → Webhooks para disparar un evento sintético ping.sent a través de la canalización de entrega real, firmado igual que cualquier otro evento, para que puedas verificar tu endpoint sin esperar a que ocurra uno real.