Поиск Контактов Pro
Доступно в подписке

Поиск Контактов Pro

Автоматически находите Контакт по телефону или E-mail

Описание

Назначение:

Приложение "Поиск Контактов 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) — при наличии.
ID контактов в Битрикс24 растут по мере создания, поэтому наименьший ID обычно принадлежит самому раннему из найденных контактов, а наибольший — самому позднему.

Меры предосторожности:
Очень желательно устанавливать «Период ожидания: Время ожидания ответа от приложения» - больше 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 возвращаются на ваш портал.
При удалении приложения ключи доступа к порталу отзываются и стираются; служебная запись об установке сохраняется в статусе «удалено» — уже без доступа к порталу. Данные третьим лицам не передаются. Подробнее — в Условиях о конфиденциальности персональной информации.
Читать полностью →
Дополнительные условия
Требования к тарифу, правам и окружению
  • Тариф. Коммерческий тариф Битрикс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 · 05.11.2026
  • Новая платформа. Обработка запросов робота перенесена на новую серверную платформу приложений для обеспечения стабильной и быстрой работы.
  • Ошибки поиска лучше видны. Раньше, если Битрикс24 отвечал на поиск ошибкой, робот возвращал обобщенную информацию об ошибке. Теперь, помимо «Есть ошибка» = Да, в значении «Текст ошибки» — как правило, код и описание ошибки Битрикс24. Если в ваших бизнес-процессах ветка «контакты не найдены» не проверяет значение «Есть ошибка», рекомендуем добавить такую проверку.
  • Запись в журнале бизнес-процесса. После каждого срабатывания робот оставляет в журнале бизнес-процесса строку «Поиск контактов выполнен» или «Ошибка: …» с текстом ошибки.
  • Надёжная передача результата. Отправка результата робота теперь повторяется при любом временном отказе Битрикс24, а не только при превышении лимита запросов (с увеличивающимися паузами, вплоть до 10 минут), найденные ID компаний при этом не теряются.
  • Уточнено название робота: робот — «Поиск по Телефону или E-mail (Контакты)»; Коды значений не изменились.
Рейтинг
5 /5
5 звезд
2
4 звезды
0
3 звезды
0
2 звезды
0
1 звезда
0
Отзывы
Всего отзывов: 2

История версий

Версия 2

  • Новая платформа. Обработка запросов робота перенесена на новую серверную платформу приложений для обеспечения стабильной и быстрой работы.
  • Ошибки поиска лучше видны. Раньше, если Битрикс24 отвечал на поиск ошибкой, робот возвращал обобщенную информацию об ошибке. Теперь, помимо «Есть ошибка» = Да, в значении «Текст ошибки» — как правило, код и описание ошибки Битрикс24. Если в ваших бизнес-процессах ветка «контакты не найдены» не проверяет значение «Есть ошибка», рекомендуем добавить такую проверку.
  • Запись в журнале бизнес-процесса. После каждого срабатывания робот оставляет в журнале бизнес-процесса строку «Поиск контактов выполнен» или «Ошибка: …» с текстом ошибки.
  • Надёжная передача результата. Отправка результата робота теперь повторяется при любом временном отказе Битрикс24, а не только при превышении лимита запросов (с увеличивающимися паузами, вплоть до 10 минут), найденные ID компаний при этом не теряются.
  • Уточнено название робота: робот — «Поиск по Телефону или E-mail (Контакты)»; Коды значений не изменились.
05.11.2026

Другие приложения разработчика

Поиск Дубликатов Pro Подписка

Автоматически находите и объединяйте дубликаты контактов!

(1)
(224)
Поиск Компаний Pro Подписка

Автоматически находите Компанию по телефону или E-mail

(1)
(46)
Сообщения Открытой Линии Подписка

Первое и последнее сообщение клиента — сразу в карточке CRM

(0)
(18)