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

Робот «ID всех контактов в сделке» для Битрикс24: автоматический сбор всех связанных контактов за одно действие

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

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

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

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

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

Массовая коммуникация. Вы хотите отправить письмо всем контактам сделки, когда статус меняется на «Выставлен счёт». Запускаете робот «ID всех контактов в сделке», затем робот отправки письма — и каждый контакт получает уведомление автоматически.

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

Объединение дублей. Собрали контакты сделки, проверили на дубли по номеру телефона через робот поиска дублей — если нашли повторы, запускается робот объединения. Всё происходит автоматически, без участия человека.

Передача контактов в Смарт-Процесс. Сделка завершена, и нужно перенести всех контактов в элемент Смарт-Процесса «Гарантийное обслуживание». Робот собирает ID контактов сделки и передаёт их роботу привязки контактов к элементу Смарт-Процесса.

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

Настройка минимальна — роботу достаточно указать, из какой сделки брать контакты. Источником может быть текущая сделка (та, в которой запущен сценарий) или конкретная сделка по её ID.

Дополнительных фильтров робот не требует: он возвращает все контакты без исключения. Если нужна фильтрация — например, только контакты с заполненным email — добавьте следующего робота для проверки условий.

Робот работает в пределах одной сделки за один запуск. Для массовой обработки используйте триггер на изменение стадии сделки.

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

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

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

Робот «ID всех контактов в сделке» — это робот-поставщик данных. Он редко используется сам по себе, зато отлично работает в паре с роботами отправки сообщений, обновления полей контакта, проверки дублей, создания задач. Типичная связка: этот робот → робот «Поиск контакта по параметрам» → робот «Отправка сообщения через WhatsApp» — и каждый контакт сделки получает персональное сообщение.

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

Робот не находит контакты. Убедитесь, что к сделке действительно привязаны контакты. В Битрикс24 контакты привязываются в карточке сделки на вкладке «Контакты». Если вкладка пуста — робот вернёт пустой массив.

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

Передача пустого результата дальше. Если робот не нашёл контактов, а следующий робот ожидает непустой список — сценарий упадёт с ошибкой. Добавьте проверку на пустой результат или условие ветвления.