REST-запрос в роботах и БП

Описание

REST-запрос в роботах и БП

Если следующему шагу автоматизации нужен номер заявки или статус из внешнего сервиса, его можно получить прямо в процессе. «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 КБ. Подставленные поля документа попадают во внешний сервис и журнал; ключи подключений маскируются.