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

Возвращает список ID всех контактов, привязанных к сделке.

Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.

Для кого и какую проблему решает

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

Что делает и когда применять

Робот пригодится, когда нужно перебрать всех контактных лиц сделки в бизнес-процессе.

Что подготовить

Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.

Передайте ID сделки и проверьте её контакты в CRM. Для обработки нескольких результатов нужен цикл или отдельное правило выбора; найденная связь не означает актуальность всех контактных данных.

Как настроить и использовать

1. Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «ID всех контактов сделки». В шаблоне бизнес-процесса добавьте одноимённое действие.
2. Передайте ID сделки и проверьте её контакты в CRM. Для обработки нескольких результатов нужен цикл или отдельное правило выбора; найденная связь не означает актуальность всех контактных данных.
3. Заполните ID сделки. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
4. Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
5. Выполните пробный запуск на отдельном учебном элементе. Сначала проверьте статус и пояснение ошибки, затем содержательный результат и ветку, выбранную следующим действием.

Параметры робота

Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.

Поле в настройках	Что передать	Обязательность и исходное значение
ID сделки (dealId)	Формат: целое число.	Обязательно. Значение по умолчанию в настройках не задано

Учебный пример

Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.

• ID сделки (dealId): 501.

Если со сделкой связаны контакты 601 и 602, оба ID попадут в список. Для получения имён, телефонов и ролей каждого человека потребуется отдельное чтение контакта.

Какие данные возвращает и что делать дальше

Результат	Какое значение получает следующий шаг
ID контактов (contactsId)	целое число, несколько значений
Статус (status)	строка
Ошибка (error)	строка

Передайте «ID контактов» в цикл дальнейшей проверки. Для одного адресата задайте явный критерий, не выбирайте первого автоматически только из-за порядка списка.

Ошибки и ограничения

Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.