Webhook tolerante a falhas
O robô «Webhook tolerante a falhas» envia uma solicitação HTTP a um endpoint externo com novas tentativas em processos de negócios e robôs do Bitrix24. Verifica o código de resposta conforme as faixas selecionadas (2xx, 3xx, 4xx, 5xx mais códigos adicionais), repete as tentativas que falharam em um intervalo definido e pode notificar os usuários escolhidos em caso de falha definitiva. Retorna um indicador de entrega Y/N, o código e o corpo da resposta da última tentativa e o número de tentativas realizadas. Disponível apenas nos planos pagos.
O robô entrega de forma confiável uma solicitação HTTP (GET, POST, PUT, PATCH, DELETE) a um endpoint externo e, ao contrário de uma solicitação HTTP comum, assume a entrega: decide o que conta como sucesso e repete em caso de falha. Parâmetros: URL, método, corpo e cabeçalhos em formato JSON; o conjunto de códigos de sucesso é escolhido pelas faixas 2xx/3xx/4xx/5xx mais códigos adicionais separados por vírgula (padrão 2xx); o número de tentativas é 1–10 (padrão 3), o intervalo entre as tentativas é 1–3600 segundos (padrão 60) e o tempo limite por tentativa é 1–25 segundos (padrão 10). Em caso de falha definitiva, pode notificar os usuários escolhidos com uma mensagem no chat. Casos típicos de uso: enviar de forma confiável os dados de um negócio para um sistema externo ou CRM; disparar um webhook de integração com novas tentativas garantidas quando o serviço está temporariamente indisponível; alertar a pessoa responsável se a entrega nunca for concluída. Retorna um indicador de entrega Y/N, o código HTTP e o corpo da resposta da última tentativa e o número de tentativas realizadas — verifique o Y/N na condição da etapa seguinte. O robô está disponível apenas nos planos pagos do Bitrix24.
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| URL do webhook | string | sim | |
| Método HTTP (padrão POST) | select | — | POST |
| Corpo da solicitação | string | — | |
| Cabeçalhos em formato JSON: {"Authorization":"Bearer xxx","Content-Type":"application/json"} | string | — | |
| Quais códigos considerar como sucesso (padrão 2xx) | select | — | 2xx |
| Códigos de sucesso adicionais, separados por vírgula (p. ex. 409, 422) | string | — | |
| Número de tentativas (1–10, padrão 3) | int | — | 3 |
| Intervalo entre tentativas em segundos (1–3600, padrão 60) | int | — | 60 |
| Tempo limite por tentativa em segundos (1–25, padrão 10) | int | — | 10 |
| Quem notificar em caso de falha na entrega | user | — |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| Entregue (Y/N) | string |
| Código de status HTTP da última tentativa | int |
| Corpo da resposta da última tentativa | string |
| Tentativas realizadas | int |
Cenário: enviar de forma confiável os dados de um negócio para um sistema externo
- Um negócio entra na etapa «Pago» e um processo de negócios inicia
- O robô envia uma solicitação POST para a URL do sistema externo; diante de uma resposta fora de 2xx repete até 3 vezes com um intervalo de 60 segundos
- Com sucesso o processo continua pelo ramo Y; diante de uma falha definitiva notifica a pessoa responsável e segue pelo ramo N