REST-запрос в роботах и БП
HTTP-запросы из автоматизации с результатом в процессе
-
Оценка
-
Установок29
-
РазработчикAventra
Если следующему шагу автоматизации нужен номер заявки или статус из внешнего сервиса, его можно получить прямо в процессе. «REST-запрос в роботах и БП» отправляет HTTP-запрос из бизнес-процесса или робота Битрикс24 и возвращает код, тело ответа и выбранные значения JSON. Полученный результат используется в следующих шагах без ручного копирования.
Администратор или интегратор задаёт адрес, метод, авторизацию и формат по документации API сервиса. Базовый адрес и ключ можно сохранить в подключении и использовать в нескольких роботах. Поддерживаются тела запросов в формате JSON, формы и обычного текста. Для начала можно выполнить настоящий запрос и увидеть ответ рядом с формой.
Журнал связывает вызов с документом: показывает ответ, попытки, ошибку и факт возврата результата в процесс. Проверка и ручной повтор действительно обращаются к сервису. Если выбранный метод записывает данные, они могут измениться во внешней системе или CRM; первую проверку стоит проводить методом чтения либо в тестовом сценарии сервиса.
Для робота нужен тариф с роботами, для дизайнера бизнес-процессов соответствующая возможность тарифа. Приложение работает в облаке и коробке; коробке нужен публичный HTTPS-адрес. Запросы идут только на публичные адреса, HTTP разрешается отдельно в подключении. Внутренние сети, редиректы, скачивание файлов и ожидание обратного вызова не поддерживаются.
Вопросы и ответы
Что робот вернёт в процесс?
Признак успеха, код и тело ответа, ошибку, длительность, номер вызова и до пяти значений, извлечённых из JSON по заданным путям. Проверочный запрос из приложения в процесс ничего не передаёт.
Что произойдёт при сбое и может ли повтор создать дубль?
Доступно до трёх повторов при сетевой ошибке, таймауте, ответах 429 и 5xx. Если попытки исчерпаны, процесс получает неуспех и ошибку. Повтор может повторить запись во внешнем сервисе: отсутствие дублей не гарантируется. Ручной повтор создаёт отдельный вызов и не продолжает завершённый процесс.
Можно ли вызвать метод самого Битрикс24?
Да, через входящий вебхук, созданный администратором с нужными правами. Для этих вызовов используется вебхук, а не токен приложения.
Какие действуют ограничения?
До 50 подключений и 1 000 вызовов в час на портал. Тело запроса до 256 КБ, чтение ответа до 1 МБ, таймаут от 5 до 60 секунд. Готовых настроек для любого сервиса нет: нужно знать параметры его API.
Что сохраняется в журнале?
Запрос и ответ, по умолчанию на 30 дней; администратор выбирает срок от 7 до 90 дней. Тело запроса сохраняется до 16 КБ, ответ до 64 КБ. Подставленные поля документа попадают во внешний сервис и журнал; ключи подключений маскируются.
