-
Оценка
-
Установок143
-
Разработчик
-
Опубликовано04.08.2025
Назначение:
Приложение "Поиск Контактов Pro" предназначено для автоматического поиска контактов в CRM Битрикс24 по номеру телефона или E-mail адресу.
Описание приложения
Для кого. Отделы продаж и поддержки, которые получают обращения с номерами телефонов и адресами e-mail (заявки с сайта, звонки, письма) и хотят прямо в автоматизации CRM узнать, есть ли уже в базе Контакт с такими данными, — без ручного поиска по CRM.
Какую задачу решает. Робот «Поиск по Телефону или E-mail (Контакты)» получает список телефонов и (или) адреса e-mail, ищет контакты CRM, у которых в карточке указаны эти телефоны или адреса, и возвращает следующим роботам автоматизации: найдены ли Контакты, список их ID, количество, а также первый (самый ранний) и последний (самый поздний) ID среди найденных. Если поиск не удался, робот возвращает признак ошибки и её текст.
Ищутся только Контакты. Компании, Сделки и Лиды этот робот не ищет.
Номера телефонов записывают по-разному. Для каждого номера робот ищет несколько вариантов записи: номер как он указан, номер без пробелов, скобок и дефисов, а для российского 11-значного номера, начинающегося с 7 или 8, — также варианты с +7 и с 8. Например, для +7 (900) 000-00-00 будут найдены Контакты, у которых номер сохранён как +79000000000 или 89000000000.
| Важно: Робот ничего не изменяет в CRM: не создаёт и не правит Контакты, не заполняет поля. Он возвращает результат следующим роботам. Чтобы сохранить результат или действовать по нему, добавьте после него штатные роботы — например, «Изменить элемент» (в дизайнере бизнес-процессов — «Изменить документ») или условие по результату нашего робота. |
Типичные сценарии
- Новая заявка с сайта: робот проверяет телефон и e-mail из заявки и сообщает, есть ли уже такой клиент среди Контактов, — менеджер сразу видит, новый это клиент или постоянный.
- Ветвление бизнес-процесса: если Контакт найден, процесс идёт по одной ветке (например, записать ID найденного Контакта в поле сделки штатным роботом «Изменить элемент»), если не найден — по другой (например, поставить менеджеру задачу завести нового клиента).
- Проверка повторяющихся карточек: если по телефону или e-mail находится больше одного Контакта, следующий шаг ставит ответственному задачу проверить найденные карточки и объединить их.
- Передача ID найденного Контакта в следующие шаги автоматизации: уведомления сотрудникам, задачи, подстановка в шаблоны.
- Поиск по нескольким телефонам и нескольким адресам e-mail за один запуск робота: можно указать только телефоны, только e-mail или и то и другое — результаты поиска объединяются, каждый Контакт входит в список один раз.
- Номер телефона ищется в нескольких вариантах записи — Контакт найдётся, даже если номер в его карточке сохранён в другом формате.
- Значения можно ввести вручную или подставить из полей текущего элемента кнопкой выбора значения в настройках робота.
- Робот можно добавить в автоматизацию любой сущности CRM, где доступны роботы (например, Лида, Сделки, Контакта или Компании), а также в дизайнере бизнес-процессов; искать он будет всегда среди Контактов.
- Если поиск не удался (например, Битрикс24 вернул ошибку), робот завершается, а не зависает: «Есть ошибка» = Да, текст ошибки — в значении «Текст ошибки» и в журнале бизнес-процесса. По этому признаку можно построить отдельную ветку процесса.
У робота два поля, оба необязательные:
- «Телефон(ы)» (inputPhones) — номера телефонов для поиска;
- «Email(ы)» (inputEmails) — адреса e-mail для поиска.
Несколько значений разделяются запятой или точкой с запятой — в одной строке используйте один разделитель: если в строке есть запятая, значения делятся только по запятым. Пустые значения пропускаются, как и значения с некорректно подставленной (сломанной) вставкой вида {{…}}. Если обе настройки пусты, робот завершается без ошибки: «Контакт(ы) существуют» = Нет.
Отдельных страниц и разделов у приложения нет: всё настраивается в карточке робота и в дизайнере бизнес-процессов.
Возвращаемые значения- «Контакт(ы) существуют» (hasContacts) — Да, если найден хотя бы один контакт;
- «ID Контактов» (idsContacts) — множественное значение: ID найденных контактов по возрастанию;
- «Количество Контактов» (quantityContacts) — число найденных контактов;
- «Самый ранний (первый) ID Контакта» (earliestIdContact) — наименьший из найденных ID;
- «Самый поздний (последний) ID Контакта» (latestIdContact) — наибольший из найденных 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 — отдельные запросы; их результаты объединяются в один список без повторов. Если совпадений больше, список найденных Контактов может быть неполным.
- Разделитель значений в поле — запятая или точка с запятой, один на всё поле: если в строке есть хотя бы одна запятая, значения делятся только по запятым. Пустые значения пропускаются; значение с фигурной скобкой (например, нераскрытая подстановка поля) в поиск не попадает.
- Варианты номера с +7 и с 8 строятся только для 11-значных номеров, начинающихся с 7 или 8 (российский формат). Номер без кода страны, например (900) 000-00-00, и номера других стран ищутся как указаны и без пробелов, скобок и дефисов — варианты с +7 и 8 для них не добавляются.
- Совпадение определяет сам Битрикс24 — по телефонам и адресам e-mail, сохранённым в карточках Контактов.
- Адрес e-mail ищется в том виде, в каком указан (без пробелов по краям); проверка формата адреса не выполняется.
- Если поля робота пусты или после разбора в них не осталось значений, это не ошибка: робот вернёт «Контакт(ы) существуют» = Нет, «Количество Контактов» = 0 и «Есть ошибка» = Нет.
- Если поиск не удался (например, Битрикс24 вернул ошибку из-за нехватки прав на чтение Контактов), робот возвращает «Есть ошибка» = Да и текст ошибки — как правило, код и описание ошибки Битрикс24; «Контакт(ы) существуют» = Нет, «Количество Контактов» = 0, остальные значения пустые.
- Если робот запущен в автоматизации Контактов и ищет по его же телефонам или 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 (Контакты)»; Коды значений не изменились.