ID всех контактов компании

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• ID компании (companyId): 701.

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

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

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

Передайте «ID контактов» в цикл получения данных. Для единственного адресата добавьте правило выбора; не считайте первый элемент автоматически главным контактным лицом.

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

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