-
Оценка
-
Установок46
-
Разработчик
-
Опубликовано11.08.2025
Назначение:
Приложение "Поиск Компаний Pro" предназначено для автоматического поиска компаний в CRM Битрикс24 по номеру телефона или адресу почты (E-mail).
Описание приложения
Для кого. Отделы продаж и сервиса, которые работают с компаниями-клиентами в CRM Битрикс24 и хотят автоматически узнавать, есть ли уже в базе Компания с телефоном или e-mail из нового обращения, Лида или Сделки, — без ручного поиска по CRM.
Какую задачу решает. Робот «Поиск по Телефону или E-mail (Компании)» получает номера телефонов и (или) адреса e-mail, ищет компании CRM, у которых в карточке указаны эти телефоны или адреса, и возвращает следующим роботам автоматизации: найдена ли хотя бы одна Компания, список ID найденных Компаний, их количество, а также первый (самый ранний) и последний (самый поздний) ID среди найденных. Если поиск не удался, робот возвращает признак ошибки и её текст.
Ищутся только Компании. Контакты, Сделки и Лиды этот робот не ищет.
| Важно: Робот ничего не изменяет в CRM: не создаёт и не объединяет компании, не заполняет поля. Он только возвращает результат поиска следующим роботам. Чтобы использовать результат, добавьте после него штатного робота — например, «Изменить элемент» (в дизайнере бизнес-процессов — «Изменить документ»), условие или постановку задачи — и подставьте в него значение, которое вернул наш робот. |
- Проверка новой Сделки или Лида: робот ищет Компанию по телефону и e-mail клиента, а условие по полю «Компании найдены (одна или несколько)» определяет что делать дальше — для уже известной компании одна ветка автоматизации, для новой другая.
- Подсказка менеджеру: ID найденной Компании подставляется в комментарий, уведомление или задачу, чтобы менеджер сразу открыл нужную карточку.
- Контроль повторов: в автоматизации самой Компании робот ищет Компании с её телефонами и e-mail; «Количество Компаний» больше 1 означает, что в CRM есть и другие компании с теми же контактными данными, — можно поставить ответственному задачу проверить их.
- Обработка сбоев: по значению «Есть ошибка» можно отдельно уведомить ответственного, если поиск не выполнился, вместо того чтобы считать, что «Компания не найдена».
- Поиск по телефонам, по адресам e-mail или по тем и другим сразу: можно заполнить одно поле робота или оба, результаты объединяются в один список без повторов.
- Номер телефона ищется в нескольких вариантах записи. Например, для номера +7 (900) 000-00-00 робот ищет +7 (900) 000-00-00, +79000000000 и 89000000000 — это повышает шанс найти Компанию, даже если номер в её карточке записан в другом формате.
- Несколько значений указываются через запятую или через точку с запятой — вручную или подстановкой полей документа через кнопку выбора значения.
- Список ID найденных Компаний упорядочен по возрастанию; отдельно возвращаются наименьший и наибольший ID — как правило, это первая и последняя созданные компании.
- Если поиск не удался (например, Битрикс24 вернул ошибку), робот не выдаёт это за «ничего не найдено»: «Есть ошибка» = Да, а текст ошибки попадает в значение «Текст ошибки» и в журнал бизнес-процесса.
- Доступен в автоматизации любых сущностей CRM, в которых можно добавлять роботов (например, Лида, Сделки, Контакта, Компании) и в дизайнере бизнес-процессов.
У робота два поля, оба необязательные:
- «Телефон(ы)» — номера телефонов для поиска;
- «Email(ы)» — адреса e-mail для поиска.
Отдельных страниц и разделов у приложения нет: всё настраивается в карточке робота и в дизайнере бизнес-процессов.
Возвращаемые значения- «Компании найдены (одна или несколько)» (hasCompanies) — Да, если найдена хотя бы одна компания;
- «ID Компаний» (idsCompanies) — множественное значение: ID всех найденных компаний по возрастанию;
- «Количество Компаний» (quantityCompanies) — число найденных компаний (0, если не найдено);
- «Самый ранний (первый) ID Компании» (earliestIdCompany) — наименьший ID среди найденных;
- «Самый поздний (последний) ID Компании» (latestIdCompany) — наибольший ID среди найденных;
- «Есть ошибка» (hasError) — Да, если поиск не удался;
- «Текст ошибки» (errorText) — при наличии.
| Меры предосторожности: Очень желательно устанавливать «Период ожидания: Время ожидания ответа от приложения» - больше 0. Это поможет избежать его зависания в случае сбоев или технических проблем не по вине самого приложения. |
Дополнительные условия
- Тариф. Коммерческий тариф Битрикс24: REST API на бесплатном тарифе недоступен.
- Редакция Битрикс24. Работа приложения проверена в облачном и коробочном Битрикс24.
- Права доступа приложения (scope). CRM (crm) — поиск компаний; Бизнес-процессы (bizproc) — регистрация робота и передача его результата; Пользователи (user_brief) — используется только один раз при установке, чтобы сохранить служебные сведения о портале (число пользователей) для технической поддержки и диагностики. Из сведений о сотрудниках приложение сохраняет только ID и признак администратора пользователя, установившего приложение, и ID служебного пользователя приложения.
- Права на установку. Устанавливать приложение должен пользователь с правами администратора портала: при установке приложение регистрирует робота автоматизации, а эта операция требует администраторских прав.
- Права пользователя. По умолчанию робот обращается к CRM от имени служебного пользователя приложения с правами администратора портала. Если в настройке робота выбран другой пользователь, у него должны быть права на чтение компаний CRM; если прав не хватает, робот вернёт «Есть ошибка» = Да и текст ошибки.
- Квалификация. Дополнительных навыков не требуется: настройка выполняется штатными средствами автоматизации CRM. Знание автоматизации CRM или дизайнера бизнес-процессов будет полезно.
- Дополнительное ПО и внешние сервисы. Не требуются. Оплата внешних систем не нужна.
- Дополнительные покупки. Приложение не содержит платных дополнений и не предлагает докупить функционал: вся заявленная функциональность доступна сразу после установки.
- Поиск выполняется только среди Компаний CRM. Контакты, Сделки и Лиды не ищутся.
- До 5 телефонных номеров в одном поиске*. Каждый номер ищется в нескольких вариантах записи (до 4 вариантов), а метод Битрикс24 принимает не больше 20 значений за один запрос: 5 номеров × 4 варианта = 20. Если номеров больше, разделите их между несколькими запусками робота.
- До 20 адресов e-mail в одном поиске: используются первые 20 адресов.
- Предел выдачи — ограничение самого метода Битрикс24: не более 20 найденных записей за один поиск. Поиск по телефонам и поиск по e-mail — отдельные запросы; их результаты объединяются в один список без повторов. Если совпадений больше, список найденных компаний может быть неполным.
- Разделитель значений в поле — запятая или точка с запятой, один на всё поле: если в строке есть хотя бы одна запятая, значения делятся только по запятым. Пустые значения пропускаются; значение с фигурной скобкой (например, нераскрытая подстановка поля) в поиск не попадает.
- Варианты номера рассчитаны на российские номера. Для номера из 11 цифр, начинающегося с 7 или 8, робот ищет номер в исходном виде, очищенный от пробелов, скобок и дефисов, а также в форматах +7… и 8…. Номер другой длины (например, без кода страны), а также 11-значный номер, начинающийся не с 7 или 8, ищется только в исходном и очищенном виде.
- Адрес e-mail ищется в том виде, в каком указан (без пробелов по краям); проверка формата адреса не выполняется.
- Если поля робота пусты или после разбора в них не осталось значений, это не ошибка: робот вернёт «Компании найдены (одна или несколько)» = Нет, «Количество Компаний» = 0 и «Есть ошибка» = Нет.
- Если поиск не удался (например, Битрикс24 вернул ошибку), робот завершается со значениями «Есть ошибка» = Да и «Текст ошибки», «Компании найдены (одна или несколько)» = Нет, «Количество Компаний» = 0, остальные значения пустые, и бизнес-процесс продолжается. В тексте ошибки, как правило, код и описание ошибки Битрикс24.
- Если робот запущен в автоматизации Компании и ищет по её же телефонам или e-mail, в результат попадёт и сама эта Компания.
- Запись в журнале бизнес-процесса — на русском языке: «Поиск компаний выполнен» или «Ошибка: …» с текстом ошибки.
- ВАЖНО: Приложение работает по подписке на результат (USE_SUBSCRIPTION): робот ждёт ответа приложения. Если ответ не придёт (например, из-за технического сбоя), робот без ограничения времени ожидания будет ждать его бесконечно, поэтому рекомендуем задать в настройках робота «Период ожидания: Время ожидания ответа от приложения» — больше 0.
- Робот регистрируется на портале в фоне сразу после установки и появляется в списке роботов обычно в течение нескольких секунд; если портал временно недоступен, приложение повторяет регистрацию в течение нескольких минут.
| * Поиск по телефонам учитывает разные форматы номеров. Например, для номера +7(123)456-78-90 будет выполнен поиск также по +71234567890 и 81234567890, а для номера (123)456-78-90, т.е. без когда страны, будет выполнен поиск по всем возможным вариантам (с +7 и 8 без скобок, пробелов, тире) - таким образом расширяется зона поиска, т.к. клиенты зачастую указывают номера в разных форматах. |
Данные и приватность
Приложение хранит на своём сервере только авторизационные ключи доступа к порталу, необходимые для работы с REST API Битрикс24, служебную запись об установке (адрес и идентификатор портала, язык портала, код, версия и права приложения, тариф и число пользователей, ID пользователя, установившего приложение, и служебного пользователя приложения — для технической поддержки и диагностики), а также технические журналы работы приложения в течение ограниченного срока хранения. Ключи доступа хранятся в зашифрованном виде.
В технический журнал каждого срабатывания робота записываются идентификатор запроса, ID элемента CRM и бизнес-процесса, для которых сработал робот, число указанных номеров и адресов, ID найденных компаний, а также код и текст ошибки, если она была. Сами номера телефонов и адреса e-mail в журнал не записываются. Задание на обработку срабатывания робота передаётся и хранится в зашифрованном виде; если обработка не удалась, зашифрованное задание временно сохраняется для разбора сбоя. Содержимое карточек компаний приложение не запрашивает и не сохраняет: найденные ID возвращаются на ваш портал.
При удалении приложения ключи доступа к порталу отзываются и стираются; служебная запись об установке сохраняется в статусе «удалено» — уже без доступа к порталу. Данные третьим лицам не передаются. Подробнее — в Условиях о конфиденциальности персональной информации.
История версий
Версия 2
- Новая платформа. Обработка запросов робота перенесена на новую серверную платформу приложений для обеспечения стабильной и быстрой работы.
- Ошибки поиска лучше видны. Раньше, если Битрикс24 отвечал на поиск ошибкой, робот возвращал обобщенную информацию об ошибке. Теперь, помимо «Есть ошибка» = Да, в значении «Текст ошибки» — как правило, код и описание ошибки Битрикс24. Если в ваших бизнес-процессах ветка «компании не найдены» не проверяет значение «Есть ошибка», рекомендуем добавить такую проверку.
- Запись в журнале бизнес-процесса. После каждого срабатывания робот оставляет в журнале бизнес-процесса строку «Поиск компаний выполнен» или «Ошибка: …» с текстом ошибки.
- Надёжная передача результата. Отправка результата робота теперь повторяется при любом временном отказе Битрикс24, а не только при превышении лимита запросов (с увеличивающимися паузами, вплоть до 10 минут), найденные ID компаний при этом не теряются.
- Уточнено название робота: робот — «Поиск по Телефону или E-mail (Компании)»; Коды значений не изменились.