REST API - методы РЕСТ Битрикс24 и JSON в роботах и БП

Приложение для Битрикс24, которое добавляет нового Робота и новое Активити в Дизайнер бизнес-процессов.
Позволяет запускать REST API методы Битрикс24 прямо внутри автоматизации, передавать параметры в формате JSON и забирать из ответа только нужные данные через JSONPath.

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

Интеграторам, разработчикам, администраторам портала и всем, кто настраивает автоматизацию Битрикс24 глубже стандартных сценариев.

Особенно полезно, если вам нужно:

• получать данные через REST API Битрикс24 прямо в роботах;

• искать сотрудников, сделки, лиды, компании, задачи и элементы смарт-процессов по фильтрам;

• использовать результат REST-запроса дальше в логике робота или БП;

• работать не только с одним значением, но и со списками, массивами и вложенными структурами;

• строить более сложные бизнес-процессы Битрикс24 без написания отдельного кода.

Примеры настроек

• Робот Битрикс24 для автоматизации на стадиях и в воронках

• Активити Битрикс24 для Дизайнера бизнес-процессов

• запуск любых штатных REST-методов Битрикс24

• параметры запроса в формате JSON

• обработка результата через JSONPath

• возможность вернуть до 10 отдельных значений из ответа

• сохранение результата для дальнейшего использования в роботах и БП

• работа с фильтрами, массивами, вложенными объектами и сложными структурами ответа

Приложение помогает не просто выполнить REST-запрос, а встроить его результат в реальную автоматизацию CRM Битрикс24: в комментарии, уведомления, итераторы, условия, изменения полей и следующие шаги процесса.

Лендинг приложения:https://restapi.digitalforsales.ruТекстовая версия видео:https://digitalforsales.com/case/rest-api-metody-rest-bitriks24-i-json-v-robotah-i-bp

Приложение добавляет новое Активити в Дизайнер бизнес-процессов, а также нового Робота.

Функционал позволяет работать с данными вашего Битрикс24 через штатные методы REST API, передавать параметры с помощью JSON и обрабатывать результат через JSONPath.

По сути, настройка строится вокруг трёх шагов:

1. Указать REST-метод

2. Передать параметры запроса в JSON

3. Забрать из ответа только нужные значения через JSONPath

Как и многие подобные приложения, решение требует от пользователя, который выполняет настройку, базовых навыков работы с REST API, JSON и методами REST API Битрикс24.

Будет полезно понимать:

• какой REST-метод нужно вызвать;

• какие параметры ему нужно передать;

• какие данные нужно вернуть из ответа;

• как устроена вложенность JSON-структуры.

При этом приложение заметно упрощает работу: вы указываете метод, параметры и JSONPath, а дальше используете результат в своей автоматизации.

С помощью Робота или Активити можно обрабатывать новые лиды, сделки, контакты, компании, задачи, пользователей и элементы смарт-процессов в полностью автоматическом режиме.

А с помощью умных сценариев можно вручную переработать всю имеющуюся базу либо сущности, массово добавленные в систему посредством импорта.

• найти сотрудника по email или другому полю через user.get;

• получить список открытых элементов смарт-процесса по ответственному через crm.item.list;

• отобрать сделки, лиды или компании по заданным фильтрам;

• вернуть ID, имена, статусы, пользовательские поля и другие нужные значения;

• использовать полученные данные в комментариях, уведомлениях, следующих роботах и активити;

• передавать массив ID в итераторы и запускать дальнейшую обработку;

• собирать выборки для сложной CRM-логики, которую трудно или невозможно реализовать штатными средствами.

Приложение особенно востребовано там, где нужно не просто “дернуть метод”, а встроить результат в реальную бизнес-логику портала.

Штатных инструментов часто не хватает, когда в автоматизации нужны нестандартные данные, сложные выборки и работа со списками объектов.

Приложение помогает:

• получать именно те данные, которых не хватает в обычных роботах;

• не разбирать вручную большой JSON-ответ;

• возвращать только нужные поля, ID, статусы и массивы;

• быстро тестировать разные REST-сценарии;

• строить продвинутую автоматизацию Битрикс24 без отдельной внешней разработки.

Это хороший инструмент для порталов, где CRM-процессы уже вышли за рамки базовых настроек.

Варианты решения будут работать на тарифах, где доступен соответствующий функционал.

Робот — на всех платных тарифах.
Активити — на тарифах не ниже Профессионального.

Всегда устанавливайте таймаут ожидания отклика приложения минимум 10 минут, чтобы предотвратить зависания из-за сбоев на сервере авторизации и других технических неполадок.

В поле «Запускать от имени» укажите действующего пользователя с достаточными правами доступа.

Это особенно важно, если:

• робот или бизнес-процесс запускается от имени администратора или технического пользователя;

• выполняются выборки по большим объёмам данных;

• обрабатываются импортированные сущности или массивы записей;

• используются методы, которые требуют расширенных прав доступа.

Если запускать от уволенного или ограниченного пользователя, можно получить ошибки доступа даже при корректном JSON и правильном REST-методе.

Чтобы быстрее разобраться со структурой ответа:

• сначала можно вывести весь JSON-результат целиком;

• посмотреть реальные названия полей и вложенность;

• после этого настроить точный JSONPath для нужных значений.

Такой подход особенно полезен при работе со сложными методами, массивами и нестандартными структурами данных.

ТОП-10 вопросов и ответов о приложении

Что делает приложение REST API в роботах и бизнес-процессах?

Оно позволяет запускать любые REST-методы Битрикс24 прямо из роботов и БП. Результат можно обработать через JSON и JSONPath.

Какие сущности можно обрабатывать через REST?

Любые: лиды, сделки, контакты, компании, задачи, пользователи и смарт-процессы. Всё зависит от выбранного REST-метода.

Можно ли массово обработать всю базу?

Да. Приложение позволяет запускать REST-методы в умных сценариях и проходить по большим массивам данных, включая импортированные сущности.

Для чего нужен JSONPath?

JSONPath позволяет вытащить из REST-ответа только те поля, которые нужны в автоматизации. Можно вернуть до 10 отдельных значений.

Что делать, если не понимаю структуру REST-ответа?

Можно вывести весь JSON в комментарий и изучить вложенность. Это помогает увидеть реальные названия полей и правильно составить JSONPath.

От чьего имени должен запускаться робот?

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

Почему нужно ставить большой период ожидания?

REST-запросы могут обрабатывать тысячи элементов, поэтому рекомендуется ставить таймаут минимум 10 минут, чтобы избежать обрывов.

Можно ли использовать результаты REST-запроса в других роботах?

Да. Полученные значения передаются в переменные и могут использоваться в уведомлениях, итераторах, изменении полей и последующих действиях.

Подходит ли приложение для поиска данных?

Да. Через методы вроде user.get или crm.item.list можно находить элементы по фильтрам и возвращать ID, поля и массивы данных.

Сложно ли настраивать приложение?

Нет: нужно выбрать REST-метод, указать фильтры и прописать JSONPath. Всё остальное приложение делает автоматически.