Поиск компании

Робот «Поиск компании» для Битрикс24: получение полных данных об организации по её номеру в CRM

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

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

В отличие от поиска по параметрам или ИНН, здесь не нужно гадать, существует ли такая компания и сколько их найдётся. Если ID известен — результат гарантирован. Робот работает как паспортный стол CRM: по номеру вы получаете полное досье.

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

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

Дополнение сделки данными компании. Сделка создана, в ней указана компания. Но в карточке сделки не видны реквизиты, адрес и контакты компании. Робот получает ID компании из сделки, находит её и дополняет сделку недостающими данными: проставляет юридический адрес, телефон, email для связи. Менеджер видит всю информацию, не открывая карточку компании.

Формирование счёта с реквизитами. При создании счёта бухгалтеру нужны полные реквизиты плательщика. Робот получает ID компании из сделки или напрямую из поля «Компания» счёта, находит её и заполняет поля счёта: ИНН, КПП, ОГРН, банковские реквизиты. Счёт формируется полностью автоматически, без ручного копирования данных.

Проверка существования компании перед дальнейшими действиями. В цепочке автоматизации компания могла быть удалена или перемещена в корзину. Перед созданием задачи, отправкой письма или обновлением данных робот проверяет: существует ли компания с таким ID? Если нет — сценарий уходит на ветку обработки ошибки (уведомление администратору, создание задачи на восстановление).

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

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

Роботу нужен один параметр — ID компании. Источником может быть:

• Поле «Компания» из текущего элемента CRM (сделки, контакта, счёта);
• Переменная от предыдущего робота (например, «Поиск компании по ИНН» вернул ID, и теперь нужно получить полные данные);
• Фиксированный ID, если сценарий всегда работает с одной конкретной компанией (например, головная организация холдинга).

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

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

Робот возвращает полный набор данных компании: ID, название, телефон, email, адрес, реквизиты (ИНН, КПП, ОГРН), банковские данные, ответственного менеджера, отрасль, тип клиента и все заполненные пользовательские поля. Эти данные можно использовать в следующих шагах цепочки: подставить в документ, вставить в письмо, записать в сделку.

Если компания с таким ID не найдена (удалена или ID указан неверно), робот возвращает ошибку, которую можно перехватить и обработать.

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

Этот робот — центральный узел в большинстве цепочек, связанных с компаниями:

• После роботов поиска — любой робот-поисковик (по ИНН, по параметрам, по ID контакта) возвращает ID компании; этот робот дополняет результат всеми данными.
• Перед роботами создания документов — счета, договоры, коммерческие предложения формируются на основе данных, полученных этим роботом.
• С роботами отправки уведомлений — email и SMS отправляются на контакты, полученные из данных компании.
• С роботами обновления полей — полученные данные записываются в другие элементы CRM (сделки, контакты, задачи).

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

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

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

Путаница с ID контакта и ID компании. В некоторых сценариях можно перепутать, чей именно ID передаётся роботу. Если по ошибке передать ID контакта вместо ID компании, робот не найдёт компанию. Проверяйте источник данных в настройках — откуда именно берётся ID.