¿Qué ocurre cuando se enviaron webhooks pero no pudieron entregarse? – URBANTZ | SUPPORT

A veces los webhooks no pueden entregarse al endpoint configurado. Aquí te explicamos qué se puede hacer al respecto. Cuando se configura un webhook, se espera que la información se envíe desde Urbantz a otro sistema en función de ciertos disparadores. Por diversas razones, el endpoint receptor puede no estar disponible y los webhooks no pueden recibirse ni procesarse.

Dos opciones ayudan a minimizar el impacto de la no disponibilidad del endpoint: las notificaciones por email y el Supervisor de Sistema. Este artículo se centra en la opción de email. Descripción general

Configuración
Contenido del email
Mecanismo de reintento de webhook
Repetición de webhook

1. Configuración

Al configurar los webhooks, verás un interruptor que, si está activado, te permite introducir una dirección de email a la que se enviarán las notificaciones de error de webhook.

Se enviará un email si, tras un primer intento de envío del webhook y dos reintentos adicionales, no hemos podido entregarlo correctamente (= 3 intentos en total).
Para evitar saturar la dirección de email, los emails no se envían en tiempo real. Agrupamos los resultados que recibimos y enviamos un email cada 5 minutos (si ha habido intentos fallidos en ese intervalo de 5 minutos).

2. Contenido del email

El email contiene la siguiente información:

Endpoint: la URL a la que debía enviarse el webhook
Payloads fallidos (#): cuántos payloads no pudieron enviarse correctamente
Errores encontrados: código(s) de estado y mensaje(s) de error devueltos por el endpoint
Adjunto: el/los payload(s) en formato JSON

Gracias a estos emails, puedes cargar la información faltante en el sistema que debe actualizarse y resolver el problema que está experimentando el endpoint.

3. Mecanismo de reintento de webhook

Si un webhook no se envía correctamente, nuestro sistema lo reintenta automáticamente hasta 9 veces. Solo los webhooks que siguen en estado fallido tras los 9 reintentos se almacenan en nuestro lado. El último reintento se produce 4 horas después del intento inicial. No existe un SLA estricto para la entrega de webhooks.

4. Repetición de webhook

Si los webhooks fallan en tu sistema y la interrupción dura más tiempo que la ventana de reintento de 4 horas, esos webhooks permanecerán en estado "failed" y no se enviarán automáticamente.

Sin embargo, puedes solicitar una repetición de estos webhooks a Urbantz, y nuestros equipos los reenviarán por ti. Ten en cuenta lo siguiente:

Se trata de una intervención de pago. Para enviar una solicitud, ponte en contacto con nuestro equipo de Soporte, que coordinará internamente con Ingeniería. Debes especificar claramente los datos que deben reenviarse (por ejemplo: webhooks fallidos de actualización de task enviados entre las 13:00 y las 17:00 CET).

Recomendamos proporcionar el máximo detalle posible para garantizar una repetición rápida y precisa.