Resumen
Cuando Integrations envía un webhook saliente, registra el resultado de cada intento de entrega en el registro de webhooks. Si una entrega no tiene éxito, puede revisar la entrada fallida y volver a activarla directamente desde el registro para que la notificación llegue a su sistema externo. Este artículo explica cómo leer los estados de entrega y cómo reenviar o reintentar un webhook fallido.
Introducción
Los webhooks en Integrations envían notificaciones de eventos a un endpoint externo en el momento en que algo ocurre, de modo que los sistemas dependientes se mantienen sincronizados sin necesidad de consultas periódicas. La entrega está diseñada para ser confiable: cada solicitud está firmada con HMAC y, si falla, Integrations reintenta automáticamente con retroceso exponencial mientras el registro conserva un historial de cada intento.
Aun así, un endpoint puede permanecer inaccesible el tiempo suficiente para agotar los reintentos automáticos, o puede rechazar una solicitud mientras está mal configurado. Esta función la utilizan administradores y responsables de integraciones, las personas encargadas de mantener conectados los sistemas externos. Les permite diagnosticar esas entregas fallidas y volver a activarlas una vez que el endpoint esté sano de nuevo, en lugar de perder la notificación.
Conceptos clave
- Web hook log (registro de webhooks): el registro de entregas salientes de su cuenta, que conserva cada intento para que pueda confirmar la recepción o diagnosticar un fallo.
- Delivery status (estado de entrega): el resultado registrado para una entrega. Una entrega en curso o a la espera de su intento muestra Pending, una entrega que el endpoint aceptó muestra Success, y una que no se completó muestra Failed.
- Last run status (estado de la última ejecución): el valor que refleja el resultado del intento más reciente de esa entrega.
- Run count (recuento de ejecuciones): el valor que rastrea cuántas veces se ha intentado una entrega, incluidos los reintentos automáticos.
- Automatic retries with back-off (reintentos automáticos con retroceso): cuando una entrega falla, Integrations reintenta por su cuenta con retroceso exponencial, de modo que un endpoint brevemente no disponible generalmente se recupera sin ninguna acción manual.
- Resend and retry (reenviar y reintentar): acciones manuales que vuelven a activar una entrega desde el registro, utilizadas cuando se han agotado los reintentos automáticos o cuando ha corregido el endpoint y quiere enviar la notificación de nuevo inmediatamente.
Pasos a seguir
Abrir el registro de webhooks
Inicie sesión como administrador y abra el área de Integrations desde la configuración de su cuenta. Vaya a la sección de webhooks y abra el registro de entrega del endpoint que desea inspeccionar. El registro enumera las entregas recientes junto con su estado e historial de intentos.
Identificar las entregas fallidas
Revise el registro en busca de entradas cuyo estado sea Failed. El last run status le indica el resultado del intento más reciente, y el run count le indica cuántas veces se ha intentado ya esa entrega. Un recuento de ejecuciones alto con un estado de última ejecución Failed indica que se han ejecutado los reintentos automáticos con retroceso y el endpoint aún no aceptó la solicitud.
Diagnosticar la causa antes de volver a activar
Antes de volver a activar una entrega, confirme que el endpoint esté listo para recibirla. Compruebe que la endpoint URL sea accesible a través de HTTPS, que el servicio receptor esté en funcionamiento, y que acepte y verifique la firma HMAC en la solicitud. Reenviar a un endpoint que sigue caído simplemente volverá a fallar y aumentará el recuento de ejecuciones, así que vale la pena resolver primero el problema subyacente.
Reenviar o reintentar el webhook
Una vez que el endpoint esté sano, vuelva a activar la entrega fallida desde su entrada en el registro usando la acción de reenviar o reintentar. Esto envía la misma notificación de nuevo al endpoint configurado. La entrada pasa a Pending mientras el nuevo intento está en curso, el recuento de ejecuciones aumenta para reflejar el intento adicional, y el estado de la última ejecución se actualiza con el resultado de ese intento.
Confirmar que la entrega tuvo éxito
Después de volver a activar, actualice el registro y compruebe la entrada de nuevo. Una entrega que se completó muestra un estado Success y un estado de última ejecución actualizado. Si vuelve a Failed, el endpoint sigue rechazando o no recibiendo la solicitud, así que revise la configuración del endpoint y la verificación de firma antes de intentar otro reenvío.
Conclusión
El registro de webhooks le brinda una vista clara, por intento, de cada entrega saliente, para que pueda detectar fallos rápidamente usando el estado de entrega, el estado de la última ejecución, y el recuento de ejecuciones. Cuando los reintentos automáticos no son suficientes, corregir el endpoint y luego reenviar o reintentar la entrada fallida le permite recuperar la notificación perdida y mantener sus sistemas externos sincronizados.