Кейсы Digital for Sales: использование приложений для Битрикс24

Как получить незавершённые задачи сотрудника по ID в Битрикс24 через REST-робота

2026-01-21 21:44
В автоматизациях часто нужно быстро оценить нагрузку сотрудников: сколько задач у конкретного исполнителя «в работе», и какие именно задачи ещё не закрыты. Это особенно важно, если вы строите сценарий перераспределения задач по загрузке — например, в роботе или бизнес-процессе, который выбирает менее загруженного исполнителя.

Проблема пользователя

На практике упираются в ограничения стандартных условий фильтрации: в интерфейсе встречается выбор статуса только через «Равно» и без удобного варианта «НЕ равно». Из-за этого кажется, что нужно собирать выборку обходными путями — делать несколько действий под разные статусы и затем «склеивать» результаты, что усложняет схему и повышает риск ошибок.

Почему штатными инструментами неудобно

Статусы задач в Битрикс24 могут включать несколько «не финальных» состояний, и если вы хотите получить «всё, кроме завершённых», то логика через перечисление статусов превращается в громоздкую конструкцию. При этом базовая потребность обычно проще: исключить завершённые и отфильтровать по исполнителю.

Решение: REST-робот с фильтром «не завершена» и ID сотрудника

Самый прямой путь — использовать REST-метод списка задач и применить оператор исключения в фильтре. В этом сценарии задача решается проще, чем через отдельное приложение «Поиск Контактов, Компаний, Сделок, Лидов, Задач и Сотрудников»: вместо расширения логики поиска вы сразу задаёте нужные условия на уровне REST.
Для этого удобно подходит REST API - методы РЕСТ Битрикс24 и JSON в роботах и БП: в роботе вы задаёте метод, параметры запроса в JSON и вытаскиваете результат через JSONPath — без дополнительных «склеек» и лишних активити.

Пример логики и настроек (как текст)

REST-метод:
tasks.task.list
Параметры REST-запроса (JSON):
{
"filter": {
"!REAL_STATUS": 5,
"RESPONSIBLE_ID": "{{ID сотрудника}}"
}
}
JSONPath (чтобы получить ID задач списком):
$.tasks[*].id
Смысл такой: RESPONSIBLE_ID ограничивает выборку задачами конкретного сотрудника, а !REAL_STATUS: 5 исключает завершённые задачи (то есть вы получаете все «незакрытые», независимо от промежуточных статусов).

Результат

Вместо четырёх действий под разные статусы вы получаете один аккуратный REST-вызов: он возвращает список незавершённых задач сотрудника, а дальше этот массив можно использовать для подсчёта количества, условий маршрутизации или дальнейшей автоматизации перераспределения нагрузки.

Вывод

Если цель — «всё, кроме завершённых», не стоит усложнять робота перечислением статусов. Проще исключить финальный статус оператором ! и работать с чистой выдачей REST. В подобных задачах REST API - методы РЕСТ Битрикс24 и JSON в роботах и БП фактически становится универсальным конструктором: вы быстро собираете нужный фильтр, проверяете результат и масштабируете логику под любые дополнительные условия (сроки, группы, теги, проекты).