Поиск совпадений в контактах и компаниях по данным лида

Находит лиды, контакты и компании с совпадающим телефоном или email.

Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.

Для кого и какую проблему решает

Робот полезен для менеджера, который проверяет повторное обращение лида перед привязкой контакта. Контакт или компания уже есть в CRM, но новая заявка пришла как лид. Робот ищет совпадения по телефону или email исходного лида и возвращает разные типы найденных карточек отдельно.

Что делает и когда применять

Находит лиды, контакты и компании с совпадающим телефоном или email.

Используйте для проверки повторных обращений. Укажите исходный лид и при необходимости дополнительные телефоны и email. Поиск по обоим каналам объединяет совпадения. Можно оставить только незакрытые лиды; исходный лид также может входить в результат.

Что подготовить

Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.

Выберите исходный лид и тип поиска phone, email или phone_email. Дополнительные значения дополняют каналы поиска. При выборе обоих каналов совпадения объединяются; совпадение не требует одновременного равенства телефона и email.

Как настроить и использовать

1. Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Поиск совпадений в контактах и компаниях по данным лида». В шаблоне бизнес-процесса добавьте одноимённое действие.
2. Выберите исходный лид и тип поиска phone, email или phone_email. Дополнительные значения дополняют каналы поиска. При выборе обоих каналов совпадения объединяются; совпадение не требует одновременного равенства телефона и email.
3. Заполните ID исходного лида, Тип поиска, Дополнительные телефоны, Дополнительные email, Отсечь закрытые лиды. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
4. Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
5. Выполните пробный запуск на отдельном учебном элементе. Сначала проверьте статус и пояснение ошибки, затем содержательный результат и ветку, выбранную следующим действием.

Параметры робота

В полях формы, которые допускают несколько значений, добавляйте каждое значение отдельным элементом через редактор. Обычные текстовые, числовые и списковые поля заполняйте в указанном для них формате.

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

Поле в настройках	Что передать	Обязательность и исходное значение
ID исходного лида (leadId)	Формат: строка.	Необязательно. Значение по умолчанию в настройках не задано
Тип поиска (logic)	Формат: выбор из списка. Варианты: phone: Телефон; email: Email; phone_email: Телефон или email.	Обязательно. Значение по умолчанию в настройках не задано
Дополнительные телефоны (phones)	Формат: строка. Можно передать несколько значений.	Необязательно. Значение по умолчанию в настройках не задано
Дополнительные email (emails)	Формат: строка. Можно передать несколько значений.	Необязательно. Значение по умолчанию в настройках не задано
Отсечь закрытые лиды (stage)	Формат: да/нет.	Необязательно. Значение по умолчанию в настройках не задано

Учебный пример

Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.

• ID исходного лида (leadId): 501.
• Тип поиска (logic): phone_email.
• Дополнительные телефоны (phones): ["+7 900 000-00-00"].
• Дополнительные email (emails): ["client@example.com"].
• Отсечь закрытые лиды (stage): Y.

Если телефон совпал с контактом, а email с компанией, результат может содержать оба типа карточек. Исходный лид тоже может входить в найденные ID. Наличие совпадения не доказывает, что карточки нужно объединять.

Какие данные возвращает и что делать дальше

Результат	Какое значение получает следующий шаг
ID лидов (leadIds)	строка, несколько значений
ID контактов (contactIds)	строка, несколько значений
ID компаний (companyIds)	строка, несколько значений
Статус выполнения (status)	да/нет
Пояснение ошибки (error)	строка

Разберите «ID контактов» и «ID компаний» в отдельных ветках, затем выберите проверенную связь. При нескольких совпадениях назначьте ручной выбор и не объединяйте записи автоматически лишь по первому ID.

Ошибки и ограничения

Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.