Saltar al contenido principal

Reintento de webhook

El reintento de webhook te permite ver las entregas de webhook fallidas y reintentarlas manualmente.

Acceder a webhooks fallidos​

Ve a Configuración → Registros y monitorización y abre la pestaña Reintentos de webhook. (La antigua página independiente Configuración → Webhooks se integró aquí y ahora redirige a Registros). La pestaña muestra una lista de todas las tareas de webhook fallidas con estos detalles:

  • ID de tarea -- Identificador único de la tarea de webhook.
  • URL -- El endpoint de destino y el método HTTP.
  • Error -- El motivo por el que falló la entrega.
  • Intentos -- Cuántas veces intentó el sistema entregar el webhook.
  • Falló el -- Cuándo falló el último intento.

Reintentar un webhook fallido​

Haz clic en Reintentar en cualquier tarea fallida para volver a ponerla en cola de entrega. El sistema intentará enviar el webhook de nuevo con la misma carga y configuración.

Después de un reintento correcto, la tarea se eliminará de la lista de fallidas.

Ritmo de entrega​

Para evitar saturar un destino, los webhooks salientes se regulan por host de destino (de forma independiente para cada espacio de trabajo): las entregas al mismo host se distribuyen para mantenerse por debajo de una velocidad configurada por segundo, y el volumen de un espacio de trabajo nunca limita el de otro. Cuando un host supera temporalmente la velocidad, esas entregas se retrasan brevemente y después se envían: no se descarta nada y un retraso no cuenta como intento fallido. Por separado, un host que sigue fallando se interrumpe mediante un cortacircuitos hasta que se recupere.

Configura tus propias velocidades por host en Configuración → Entrega de webhooks (solicitudes/segundo por host de destino). Cada velocidad está limitada por un máximo de plataforma que define tu operador, y un valor predeterminado global se aplica a cualquier host que no anules. La mayoría de endpoints no necesitan ajustes.

Paginación​

Si hay muchas tareas fallidas, la lista se pagina. Usa Anterior y Siguiente para navegar entre páginas.

Consejos​

  • Investiga el mensaje de error antes de reintentar: si el endpoint de destino no está disponible, el reintento volverá a fallar.
  • Comprueba la URL de webhook, las cabeceras de autenticación y las reglas de firewall al depurar fallos persistentes.
  • El sistema reintenta automáticamente los webhooks fallidos varias veces antes de marcarlos como fallidos.