CRM роботы

Получить ID сделок у смарта

Робот «Получить ID сделок у смарта» для Битрикс24: автоматическая выгрузка всех сделок из смарт-процесса

Что делает робот

Робот «Получить ID сделок у смарта» собирает идентификаторы всех сделок, привязанных к конкретному элементу смарт-процесса. Смарт-процессы в Битрикс24 — это гибкий инструмент для нетиповых бизнес-задач: управление проектами, обработка заявок, ведение реестра договоров. В отличие от стандартных лидов и сделок, смарт-процесс может содержать десятки и сотни элементов, каждый из которых связан с одной или несколькими сделками.

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

Результат — это массив ID сделок, который можно использовать в цикле. Например, для каждого ID сделки обновить стадию, отправить письмо клиенту или проверить наличие документов. Это превращает смарт-процесс из изолированного справочника в центр управления связанными продажами.

Сценарии использования

1. Массовое обновление стадий по проекту. Компания ведёт строительный проект как элемент смарт-процесса «Объекты». К проекту привязано 15 сделок: поставка материалов, аренда техники, subcontracting. Проект перешёл на стадию «Заморожен». Робот собирает ID всех 15 сделок, и следующий робот переводит каждую из них в статус «Приостановлена». Одно действие вместо 15 ручных операций.

2. Проверка комплектности документов. Смарт-процесс «Договоры» содержит элементы-договоры, к каждому привязаны сделки. Перед подачей договора на подпись юристу нужно убедиться, что по всем связанным сделкам загружены спецификации. Робот получает ID сделок, проверяет наличие файлов в каждой сделке и формирует отчёт: «Договор №12: по сделкам №45 и №46 спецификаций нет».

3. Формирование пакетного коммерческого предложения. Клиент ведёт несколько параллельных сделок в рамках одного смарт-процесса «Тендеры». Менеджер хочет отправить клиенту единое КП с учётом всех тендеров. Робот собирает все сделки тендера, из каждой берёт номенклатуру и суммы, а следующий робот генерирует сводный документ. Клиент получает один документ вместо трёх разрозненных писем.

4. Контроль дедлайнов по этапам. Смарт-процесс «Запуск продукта» содержит контрольные точки, к каждой привязаны сделки с подрядчиками. Робот получает все сделки контрольной точки, проверяет их стадии, и если хотя бы одна не закрыта — отправляет уведомление руководителю: «Точка „Дизайн“ не пройдена — сделка №67 всё ещё в работе».

Настройка робота

Для настройки нужно указать два параметра:

ID элемента смарт-процесса — конкретный элемент (например, «Проект „Офис на Тверской“»), из которого нужно извлечь связанные сделки. Если робот запускается внутри процесса, привязанного к смарт-процессу, ID подставится автоматически.
Направление связи — сделки могут быть «дочерними» (созданы из смарт-процесса) или «родительскими» (смарт-процесс привязан к существующей сделке). Робот позволяет выбрать, какие именно связи учитывать.

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

Результат работы

Робот возвращает:

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

Полученный список можно обработать в цикле: для каждого ID выполнить обновление полей, проверку стадии, отправку документа. Это превращает одну настройку робота в операцию над десятками сделок одновременно.

Интеграция с другими роботами

Робот «Получить ID сделок у смарта» — это стартовый робот для массовых операций:

Перед роботом «Обновление сделки» — собрали все сделки смарт-процесса, теперь для каждой меняем стадию, ответственного или сумму;
Перед роботами отправки писем — получили список сделок, из каждой взяли контакт клиента, отправили персонализированное письмо;
Перед роботом «Получить дату закрытия лида» — по каждой сделке находим исходный лид и извлекаем дату его закрытия для отчёта по скорости прохождения воронки.

Типовая цепочка: «Получить ID сделок у смарта → Для каждой сделки → Обновить стадию → Отправить уведомление» — полностью закрывает сценарий массового изменения сделок по проекту.

Типичные ошибки при настройке

Процесс не рассчитан на несколько сделок. Робот возвращает массив, а следующий шаг ожидает одно значение ID. Процесс падает с ошибкой. Решение: всегда используйте цикл, если допускаете, что к элементу смарт-процесса может быть привязано больше одной сделки.

Не указано направление связи. По умолчанию робот может искать только дочерние сделки, а родительские пропустить. Если вы не уверены, как именно привязаны сделки к смарт-процессу — укажите оба направления, чтобы не потерять данные.

Элемент смарт-процесса не содержит сделок. Это нормальная ситуация для новых элементов. Но если процесс не учитывает пустой список, он попытается выполнить действия над нулевым количеством сделок и либо упадёт, либо молча ничего не сделает. Добавляйте проверку: «если количество сделок = 0 — завершить процесс с уведомлением».