Найти элемент смарт-процесса
Робот «Найти элемент смарт-процесса» ищет элементы смарт-процесса Битрикс24 по фильтру: стадия, ответственный или произвольный JSON-фильтр. Возвращает ID и название первого найденного элемента, список всех ID, количество найденных элементов и признак «найдено» (Y/N) для дальнейшего ветвления бизнес-процесса.
Робот выполняет поиск элементов смарт-процесса в CRM Битрикс24 через метод crm.item.list и используется в бизнес-процессах и роботах. Указывается ID типа смарт-процесса (обязательно), а также любые из условий: стадия (stageId), ID ответственного и произвольный JSON-фильтр для нестандартных полей. Сортировка задаётся по полю id, createdTime или updatedTime (по умолчанию updatedTime по убыванию), число результатов ограничивается параметром «лимит» (по умолчанию 5, максимум 50). Применяйте робота, когда нужно найти связанный элемент смарт-процесса по сделке или контакту, проверить наличие открытого элемента на нужной стадии или собрать список ID для пакетной обработки. Возвращает ID и название первого элемента, массив всех найденных ID, их количество и признак «найдено» (Y/N) — используйте его в условии следующего шага.
Какие параметры принимает робот?
| Параметр | Тип | Обязательный? | По умолчанию |
|---|---|---|---|
| ID типа смарт-процесса (узнать: CRM → Смарт-процессы → настройки) | int | да | |
| Стадия (например DT{entityTypeId}:{stageCode}) | string | — | |
| ID ответственного | int | — | |
| Произвольный фильтр (JSON, например {"contactId":"123"}) | string | — | |
| Сортировка: id / createdTime / updatedTime (по умолчанию updatedTime DESC) | string | — | |
| Максимум результатов (по умолчанию 5) | int | — |
Что возвращает робот?
| Параметр | Тип |
|---|---|
| ID первого найденного элемента | int |
| Название первого элемента | string |
| Все найденные ID | int |
| Количество найденных элементов | int |
| Найдено (Y/N) | string |
Сценарий: поиск активной заявки по контакту
- Сделка переходит на стадию «В работе»
- Робот ищет элементы смарт-процесса по ID типа и фильтру с ID контакта
- При found = Y процесс берёт ID найденного элемента и обновляет его, при N создаёт новый