ID всех контактов в сделке

Что делает робот «ID всех контактов в сделке»

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

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

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

1. Массовая постановка задач участникам сделки. После перехода сделки на стадию «Подготовка КП» робот собирает ID всех контактов, и для каждого автоматически создаётся задача: «Согласовать коммерческое предложение». Руководитель видит, кому и когда поставлена задача, без ручного перебора карточек.

2. Проверка полноты данных перед выставлением счёта. Перед тем как отправить счёт клиенту, робот проверяет, что к сделке привязан хотя бы один контакт с заполненным email. Если контактов нет или email отсутствует — процесс уходит на ветку уведомления менеджера. Счёт не уходит «в пустоту».

3. Автоматическая рассылка уведомлений о статусе сделки. Когда сделка переходит на стадию «Закрыта», робот собирает ID всех контактов и отправляет каждому персонализированное письмо с благодарностью и ссылкой на документы. Клиенты и их сотрудники получают уведомление одновременно.

4. Формирование отчёта по участникам сделок. Робот используется внутри сквозного процесса: собирает ID контактов по всем активным сделкам за период и передаёт их в отчёт. Руководитель видит, какие контакты участвуют в наибольшем количестве сделок и кто из клиентов наиболее активен.

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

Для запуска достаточно указать сделку, из которой нужно получить контакты. Источником может быть текущая сделка бизнес-процесса или сделка, найденная предыдущим роботом (например, «Поиск сделки»). Дополнительных параметров робот не требует — он автоматически извлекает все связанные контакты.

Опционально можно настроить фильтрацию по роли контакта в сделке, если в Битрикс24 настроены соответствующие пользовательские поля. Это позволяет получать только нужную категорию участников, например только «лиц, принимающих решения».

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

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

• ID контактов — перечень всех привязанных контактов для использования в циклах и итерациях;
• Количество контактов — общее число участников сделки, полезно для проверки полноты данных и отчётности.

Если к сделке не привязан ни один контакт, робот сообщает об этом, и бизнес-процесс может уйти на ветку «создать контакт» или «уведомить менеджера».

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

Робот «ID всех контактов в сделке» работает в связке с другими инструментами автоматизации:

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

Типовая цепочка: «Поиск сделки» → «ID всех контактов в сделке» → «Отправить письмо» (в цикле по каждому контакту).

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

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

Ожидание имён и телефонов вместо ID. Робот возвращает именно числовые идентификаторы, а не готовые карточки с именами и телефонами. Для получения полной информации о контакте используйте робот «Информация о контакте» отдельно для каждого ID.

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