Робот «Получить компании по контакту» помогает получить все компании, связанные с контактом, чтобы не терять контекст работы с клиентом.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую задачу решает
Менеджеру клиента и администратору процесса, который продолжает работу от контакта к связанным компаниям.
Один контакт может представлять несколько организаций. Робот возвращает весь доступный список ID компаний и первый ID отдельно. Это позволяет не терять дополнительные связи, когда следующему шагу нужен перебор всех компаний.
Параметры и подготовка
| Поле | Как заполнить |
|---|---|
ID контакта (contactId) |
Обязательное поле |
Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.
Как использовать
- Передайте положительный contactId из карточки контакта или предыдущего поиска. Не подставляйте ID сделки вместо контакта.
- Убедитесь, что пользователь интеграции может читать связи контакта. Отсутствие доступа не следует смешивать с пустым списком.
- После выполнения проверьте статус и список companyId. Для нескольких компаний используйте итератор или явное правило выбора.
- firstCompanyId используйте только если бизнес-правило разрешает первую доступную компанию. При пустом списке он равен 0.
Учебный пример и ожидаемый результат
У учебного контакта 72 связаны компании 51 и 52. Ожидается список companyId с обоими ID и firstCompanyId, равный первому в полученном списке. Этот первый ID не обозначен роботом как основная компания. У контакта без связей список пустой и первый ID равен 0.
Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.
Что возвращает и как продолжить процесс
- «Список ID компаний» (
companyId), список значений. - «Первый ID компании» (
firstCompanyId).
companyId является множественным результатом, а firstCompanyId одиночным. Сохраните список, если последующий процесс должен проверить каждую компанию. Автоматическое использование только первого результата способно пропустить остальные организации контакта.
Сначала проверьте «Статус выполнения». При ошибке список пустой и firstCompanyId равен 0, как и у контакта без компаний. Отдельного выходного поля ошибки в объявленной схеме нет; не настраивайте условие на несуществующее пояснение.
Ограничения и разбор ошибок
Единственный вход contactId обязателен и должен быть положительным. Выход companyId содержит список ID связанных компаний, firstCompanyId первый ID либо 0. Отдельного объявленного результата пояснения ошибки нет. Результат не подтверждает основную компанию контакта; порядок берётся из полученных связей.
Робот не назначает компанию основной, не создаёт связь и не меняет контакт. Для проверки конкретной пары с двух сторон используйте отдельное действие. Ошибка чтения также возвращает пустой список и 0, поэтому обязательно проверяйте статус.