Registros de webhook y reintentos de entrega

Actualizado el mes pasado

Los registros de webhook muestran cada intento de entrega del webhook de un trabajo, junto con su estado y el error registrado, y Hirevire reintenta automáticamente las entregas fallidas hasta un total de tres intentos. Esta referencia explica dónde encontrar los registros, qué significa cada estado de entrega y cuáles son las reglas exactas de reintento.

Abrir los registros del webhook

Abre los registros desde la configuración del webhook del trabajo, desde un correo electrónico sobre un fallo de entrega o desde la paleta de comandos.

Ver registros — en la sección Settings → Webhook del trabajo. Abre los registros filtrados para las entregas del webhook de ese trabajo.
Ver los registros de entrega — el enlace del correo electrónico que Hirevire envía cuando falla una entrega. Abre los mismos registros filtrados.
Ir a registros — desde la paleta de comandos. Abre la vista general de registros.

Los registros muestran primero las entregas más recientes y 100 registros por página. Filtra con Seleccionar un trabajo, Seleccionar intervalo de fechas o Todos los estados, y usa Recargar registros para actualizar la información.

Cada registro de entrega almacena el trabajo y la aplicación a los que pertenece, el tipo de evento, la URL de solicitud, los encabezados y el cuerpo enviados, el estado y el cuerpo de la respuesta, el estado de entrega, el número de intento, las marcas de tiempo de creación y ejecución, y el mensaje de error cuando falla una entrega.

Estados de entrega

Cada entrega tiene uno de cuatro estados.

Estado	Significado
Pendiente	La entrega está en cola y a la espera de ser enviada.
Reintentando	Un intento falló con un error que permite reintentos y el siguiente intento está programado.
Correcto	La entrega se completó correctamente.
Fallido	La entrega terminó sin éxito y no hay más intentos programados.

Programación de reintentos

Cada entrega tiene un máximo total de tres intentos.

Intento 1: la entrega inicial.
Intento 2: se envía 1 minuto después del primer fallo que permite reintentos.
Intento 3: se envía 10 minutos después del segundo fallo que permite reintentos.

El tercer intento es el definitivo: si tiene éxito, la entrega se marca como Correcto; si falla, se marca como Fallido.

Qué fallos se reintentan

Solo tres tipos de fallo activan un reintento; cualquier otro error HTTP hace que la entrega falle inmediatamente.

Fallo de transporte o red — el endpoint no respondió y se registró con el estado 0. Una solicitud que supera los 30 segundos de espera se registra con el mensaje "Tiempo de espera de la solicitud agotado"; los demás fallos de transporte registran el mensaje de error del transporte.
HTTP 429 — el endpoint devolvió una respuesta 429, registrada con el mensaje "HTTP 429".
HTTP 500 o superior — el endpoint devolvió un error del servidor, registrado con el mensaje "HTTP 500" o con el estado correspondiente.

Cualquier otro estado HTTP hace que la entrega falle inmediatamente y no se reintenta.

Cómo se envían las entregas

Cada entrega es una solicitud POST con un cuerpo JSON que incluye los encabezados de solicitud configurados y cualquier encabezado de firma. Las solicitudes superan el tiempo de espera después de 30 segundos, y ese tiempo agotado cuenta como un fallo de transporte que permite reintentos. El cuerpo de respuesta almacenado se trunca a los primeros 10.000 caracteres.

Desactivación automática del webhook

Un webhook se desactiva automáticamente después de 5 fallos de entrega consecutivos y definitivos.

El estado del webhook es independiente del estado de entrega: el webhook en sí puede estar Activo o Desactivado, mientras que cada entrega dentro de él puede estar Pendiente, Reintentando, Correcto o Fallido.

Cuando un webhook está desactivado, la configuración del webhook del trabajo muestra "Este webhook se desactivó automáticamente después de varios fallos", junto con la fecha y hora de su desactivación y un botón Volver a activar. El propietario de la organización también recibe un correo electrónico con el asunto "Hirevire: Webhook desactivado para [Job Title]".

Corrige el endpoint y, luego, haz clic en Volver a activar en la sección Settings → Webhook del trabajo. Al volver a activarlo, el webhook recupera el estado Activo, se borra el recuento de fallos consecutivos y la marca de tiempo de desactivación, y se muestra la confirmación "Webhook vuelto a activar".