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 не как отдельную техническую историю, а как понятный рабочий инструмент внутри роботов Битрикс24 и бизнес-процессов Битрикс24.

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

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

Обновления за июль 2025 г.
Перенесли приложение на более мощный (X5) сервер.

Инструкция по установке
1. Установите приложение (устанавливается автоматически).
2. После установки вам будет доступен соответствующий робот (для всех платных тарифов) и активити (для тарифов не ниже Профессионального).
3. Вставьте “REST API - методы РЕСТ Битрикс24 и JSON в роботах и БП” в Роботах или Дизайнере бизнес-процессов.
4. Настройте “REST API - методы РЕСТ Битрикс24 и JSON в роботах и БП” (укажите метод, фильтры, JSONPath и другие параметры).
5. Сохраните изменения.

Что делает приложение 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. Всё остальное приложение делает автоматически.

Приложение находят по запросам:
REST API методы для CRM, расширение бизнес-процессов через REST, работа с API и вебхуками, REST активити для CRM, безлимитные API запросы, фильтрация данных через JSONPath, выполнение запросов через REST API, расширение функционала CRM, интеграция с REST API, автоматизация бизнес-процессов через REST, REST действия для роботов, API интеграция для CRM, работа с JSON в бизнес-процессах, REST запросы для CRM, REST API для автоматизации, расширение возможностей CRM через API, REST API для бизнес-процессов, автоматизация CRM через REST, REST API для роботов, работа с данными через JSONPath, REST активити для автоматизации, API запросы для CRM, расширение CRM через REST, взаимодействие с API в бизнес-процессах.