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

Если доставка, телефония или система партнёра работают вне Битрикс24, процессу нужно передать данные и получить ответ сервиса. «REST-запрос в роботах и БП» добавляет такой обмен в автоматизацию. Администратор или интегратор настраивает запрос к публичному API, а следующие шаги получают код, тело ответа и выбранные значения JSON. Это позволяет использовать результат сервиса без ручного переноса данных.

Настройте адрес, метод и тело запроса с полями документа, чтобы робот отправлял нужные сведения в ходе процесса. Задайте путь к значению в JSON, например идентификатору созданной записи, и используйте его дальше. До пяти таких значений возвращаются вместе с кодом и телом ответа. Базовый адрес и авторизацию можно сохранить в подключении, чтобы не вписывать ключ в каждый робот заново.

Проверьте параметры на подходящем тестовом адресе: получите настоящий ответ и убедитесь, что нужные поля извлечены. При сбое откройте вызов в журнале, чтобы увидеть попытки, ошибку и факт возврата результата. Ручной повтор создаёт новый вызов для проверки исправленных условий и не продолжает завершённый процесс.

После установки администратор создаёт подключение и выдаёт доступ к проверке и журналу. Отправьте первый запрос с тестовыми данными, проверьте ответ и примените параметры в роботе. Нужны доступ к API выбранного сервиса, подписка Битрикс24 Маркетплейс и тариф с роботами либо бизнес-процессами для соответствующего способа запуска.

Да. Отправка запроса, проверка подключения и ручной повтор действительно обращаются к сервису. Записывающий метод может изменить внешнюю систему или портал. Используйте предусмотренный сервисом тестовый сценарий.

Только публичные API: внутренние сети отклоняются, переходы по редиректам не выполняются. HTTP разрешается отдельно в подключении, предпочтителен HTTPS. Методы Битрикс24 вызываются через созданный администратором вебхук с нужными правами. Готовых настроек для любых сервисов нет.

До трёх повторов при сетевом сбое, таймауте, 429 и 5xx. Повтор записи может повторить действие: нужен предусмотренный сервисом ключ повторной обработки либо отключение повторов. После исчерпания попыток процесс получает неуспех и ошибку. Ручной повтор не возвращает результат уже завершённому процессу.

До 50 подключений и 1000 вызовов в час на портал. Тело запроса до 256 КБ, чтение ответа до 1 МБ, ожидание от 5 до 60 секунд. Скачивание файлов и ожидание обратного вызова не предусмотрены.

По умолчанию записи хранятся 30 дней, настройка от 7 до 90. Сохраняются тело запроса до 16 КБ и ответ до 64 КБ. Подставленные значения документа передаются сервису и попадают в журнал. Для коробки нужен публичный HTTPS-доступ к порталу.