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. 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. Solo disponible en los planes de pago.
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 solo está disponible en los planes de pago de Bitrix24.
¿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 |
| 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 |
| 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 |
Escenario: enviar de forma fiable los datos de una negociación a un sistema externo
- Una negociación entra en la etapa «Pagado» y se inicia un proceso de negocio
- 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
- 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