Найти задачу по условию
Робот «Найти задачу по условию» ищет задачи Битрикс24 по фильтру: ответственный, название, группа/проект, дедлайн, привязка к CRM, статус или произвольный JSON-фильтр. Возвращает ID и название первой найденной задачи, список всех ID, количество найденных задач и признак «найдено» (Y/N) для ветвления бизнес-процесса.
Робот ищет задачи в Битрикс24 через метод tasks.task.list и применяется в бизнес-процессах и роботах. Доступны фильтры: ID ответственного, название (поиск по вхождению), ID группы или проекта, дедлайн «от» и «до» (форматы ДД.ММ.ГГГГ или ГГГГ-ММ-ДД), привязка к CRM (например L_4, D_10, C_7, CO_5), статус (1 новая, 2 ждёт контроля, 3 выполняется, 5 завершена, 6 отложена) и произвольный JSON-фильтр. Сортировка задаётся по полям DEADLINE, ID или CREATED_DATE (по умолчанию ID по убыванию), число результатов ограничивается параметром «лимит» (по умолчанию 5, максимум 50). Должен быть задан хотя бы один параметр фильтра. Применяйте робота, чтобы найти просроченные задачи ответственного, проверить наличие открытой задачи по сделке или собрать список ID для массовой обработки. Возвращает ID и название первой задачи, массив всех ID, их количество и признак «найдено» (Y/N) — используйте его в условии следующего шага.
Какие параметры принимает робот?
| Параметр | Тип | Обязательный? | По умолчанию |
|---|---|---|---|
| ID ответственного | int | — | |
| Название задачи (поиск по вхождению) | string | — | |
| ID группы / проекта | int | — | |
| Дедлайн от (ДД.ММ.ГГГГ или ГГГГ-ММ-ДД) | string | — | |
| Дедлайн до (ДД.ММ.ГГГГ или ГГГГ-ММ-ДД) | string | — | |
| Привязка к CRM (например L_4, D_10, C_7, CO_5) | string | — | |
| Статус: 1 новая · 2 ждёт контроля · 3 выполняется · 5 завершена · 6 отложена | string | — | |
| Произвольный фильтр (JSON, например {"!STATUS":6}) | string | — | |
| Сортировка: DEADLINE / ID / CREATED_DATE (по умолчанию ID DESC) | string | — | |
| Максимум результатов (по умолчанию 5) | int | — |
Что возвращает робот?
| Параметр | Тип |
|---|---|
| ID первой найденной задачи | int |
| Название первой задачи | string |
| Все найденные ID | int |
| Количество найденных задач | int |
| Найдено (Y/N) | string |
Какие ошибки может вернуть робот?
Эти сообщения робот пишет в журнал бизнес-процесса, когда не может выполнить шаг. По тексту видно, что исправить в настройках или данных.
- Ошибка: не задан ни один параметр фильтра
- Ошибка API
- Задачи не найдены
Сценарий: проверка открытых задач по сделке
- Сделка переходит на стадию «Закрытие»
- Робот ищет задачи с привязкой к CRM по этой сделке и статусом, не равным завершённому
- При found = Y процесс уведомляет ответственного, при N двигает сделку дальше
Похожие роботы
Статьи по теме
- ID в Битрикс24: как узнать ID сделки, контакта, задачи и сотрудника
- Шаблоны задач и регулярные задачи в Битрикс24: настройка повторения и обход ограничений
- Как найти сделку, контакт или лид из бизнес-процесса Битрикс24
- Поля в задачах Битрикс24: системные, пользовательские и автоматизация
- Роботы в задачах Битрикс24: как включить, что умеют и как связать задачу со сделкой