Roboteka
Roboteka · Robots · Webhook tolerante a fallos

Webhook tolerante a fallos

El robot «Webhook tolerante a fallos» envía una solicitud HTTP a un endpoint externo con reintentos en los procesos de negocio y robots de Bitrix24 (Alaio). Comprueba el código de respuesta según los rangos seleccionados (2xx, 3xx, 4xx, 5xx más códigos adicionales), reintenta los intentos fallidos en un intervalo definido y puede notificar a los usuarios elegidos si el fallo es definitivo. Devuelve un indicador de entrega Y/N, el código y el cuerpo de la respuesta del último intento, y el número de intentos realizados. No se ejecuta en modo de demostración.

El robot entrega de forma fiable una solicitud HTTP (GET, POST, PUT, PATCH, DELETE) a un endpoint externo y, a diferencia de una solicitud HTTP normal, asume la entrega: decide qué cuenta como éxito y reintenta en caso de fallo. Parámetros: URL, método, cuerpo y cabeceras en formato JSON; el conjunto de códigos de éxito se elige mediante los rangos 2xx/3xx/4xx/5xx más códigos adicionales separados por comas (por defecto 2xx); el número de intentos es 1–10 (por defecto 3), el intervalo entre intentos es 1–3600 segundos (por defecto 60) y el tiempo de espera por intento es 1–25 segundos (por defecto 10). Si el fallo es definitivo, puede notificar a los usuarios elegidos con un mensaje de chat. Casos de uso típicos: enviar de forma fiable los datos de una negociación a un sistema externo o CRM; disparar un webhook de integración con reintentos garantizados cuando el servicio está temporalmente caído; avisar a la persona responsable si la entrega nunca llega a realizarse. Devuelve un indicador de entrega Y/N, el código HTTP y el cuerpo de la respuesta del último intento, y el número de intentos realizados — compruebe el Y/N en la condición del siguiente paso. El robot no se ejecuta mientras Bitrix24 (Alaio) está en modo de demostración.

¿Qué parámetros de entrada acepta el robot?

Parámetro Tipo ¿Obligatorio? Por defecto
URL del webhook string sí
Método HTTP (por defecto POST) select POST, GET, PUT, PATCH, DELETE — POST
Cuerpo de la solicitud string —
Cabeceras en formato JSON: {"Authorization":"Bearer xxx","Content-Type":"application/json"} string —
Qué códigos considerar como éxito (por defecto 2xx) select 2xx — éxito (200–299), 3xx — redirecciones (300–399), 4xx — errores de cliente (400–499), 5xx — errores de servidor (500–599) — 2xx
Códigos de éxito adicionales, separados por comas (p. ej. 409, 422) string —
Número de intentos (1–10, por defecto 3) int — 3
Intervalo entre intentos en segundos (1–3600, por defecto 60) int — 60
Tiempo de espera por intento en segundos (1–25, por defecto 10) int — 10
A quién notificar si falla la entrega user —

¿Qué devuelve el robot?

Parámetro Tipo
Entregado (Y/N) string
Código de estado HTTP del último intento int
Cuerpo de la respuesta del último intento string
Intentos realizados int

¿Qué errores puede devolver el robot?

El robot escribe estos mensajes en el registro del proceso de negocio cuando no puede completar un paso. El texto indica qué corregir en la configuración o en los datos.

  • Error: las cabeceras deben ser un objeto JSON
  • Error: nombre de cabecera no válido: {name}
  • Error: no se permiten caracteres de control en la cabecera {name}
  • Error: la cabecera {name} se establece automáticamente
  • Error de cURL: {error}
  • Este robot no se ejecuta mientras Bitrix24 está en modo de demostración o si no se pudo determinar el plan.

Escenario: enviar de forma fiable los datos de una negociación a un sistema externo

  1. Una negociación entra en la etapa «Pagado» y se inicia un proceso de negocio
  2. El robot envía una solicitud POST a la URL del sistema externo; ante una respuesta fuera de 2xx reintenta hasta 3 veces con un intervalo de 60 segundos
  3. Con éxito el proceso continúa por la rama Y; ante un fallo definitivo notifica a la persona responsable y sigue por la rama N

Robots similares

Artículos relacionados

Instalar Describa la tarea — construimos el robot gratis