Поиск контакта по параметрам

Поиск контакта по параметрам

Робот находит контакты в CRM по телефону, email, имени, фамилии и другим полям. Логика поиска настраивается: «И» для строгого совпадения всех условий, «ИЛИ» — для поиска по любому из них.

Что делает

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

Ключевые возможности:

• Поиск по телефону, email, имени, фамилии и другим полям контакта
• Автоматическая очистка номера телефона от форматирования
• Гибкая логика: «И» — все условия должны совпасть, «ИЛИ» — достаточно любого
• Частичное совпадение по текстовым полям (имя, фамилия, email)

Сценарии

Сценарий 1: Звонок клиента — быстро найти карточку контакта Клиент звонит менеджеру. Телефонная система передаёт номер в робота → робот находит контакт по номеру телефона → найденный ID используется дальше: открыть карточку, создать задачу, обновить поле «Дата последнего звонка».

Сценарий 2: Письмо от известного адресата — определить контакт Приходит входящее письмо в сделку. Робот извлекает email отправителя → ищет контакт по email → если контакт найден — привязывает его к сделке, если нет — создаёт новый контакт через робота «Создать контакт на основе данных».

Сценарий 3: Проверка дублей перед добавлением нового контакта Форма на сайте создаёт новый контакт. Перед созданием робот проверяет: есть ли уже контакт с таким телефоном или email → если найден — обновляет существующий вместо создания дубля → если не найден — создаёт новый.

Сценарий 4: Автоматическое обогащение лида Новый лид создан с телефоном. Робот ищет контакт по этому телефону → если контакт найден — копирует данные компании, должность и другие поля из контакта в лид → менеджер сразу видит полную картину по клиенту.

Настройка

1. Добавьте робота в бизнес-процесс или умный сценарий
2. Выберите логику поиска: «И» (все условия) или «ИЛИ» (любое условие)
3. Заполните параметры поиска:
   • Телефон — номер будет автоматически очищен от форматирования
   • Email — ищет по частичному совпадению
   • Имя — ищет по частичному совпадению
   • Фамилия — ищет по частичному совпадению
   • Дополнительные поля — выберите из списка доступных полей контакта
4. Оставьте пустыми поля, по которым поиск не требуется

Важно: при логике «И» робот ищет контакты, у которых совпадают ВСЕ заполненные поля. При логике «ИЛИ» — достаточно совпадения хотя бы по одному полю. Пустые поля игнорируются в обоих режимах.

Результат

Робот возвращает:

• Список ID контактов — массив найденных контактов, готовый к использованию в следующих шагах бизнес-процесса
• Первый найденный ID — ID первого совпавшего контакта для простых сценариев
• Статус — Y (найдено) или N (не найдено)

Если контактов несколько, все они попадают в выходной список. Для одиночного результата используйте поле «Первый найденный ID».

Интеграция

Робот работает с любыми данными, которые можно передать в параметры поиска:

• Телефония: передайте номер входящего звонка → найдите контакт → откройте карточку менеджеру
• Веб-формы: данные из формы → проверка на дубли → создание или обновление контакта
• Email-роботы: адрес отправителя → найдите контакт → привяжите к сделке или создайте новый
• Смарт-процессы: поиск связанного контакта по любым данным из элемента смарт-процесса
• Импорт данных: проверка каждого контакта из CSV/Excel перед массовой загрузкой

В связке с роботами «Создать контакт на основе данных» и «Обновить контакт» получается полный цикл: поиск → проверка дублей → создание или обновление.

Ошибки

Ситуация	Поведение	Решение
Ни один контакт не найден	Статус N, списки пусты	Проверьте корректность введённых данных; при частичном поиске попробуйте логику «ИЛИ» с меньшим числом полей
Переданы только пустые поля	Статус N	Заполните хотя бы одно поле для поиска
Телефон в нестандартном формате	Автоматическая очистка может не сработать	Приведите номер к формату без лишних символов перед передачей
Слишком много результатов	Возвращаются все найденные	Используйте логику «И» с дополнительными полями для сужения поиска