Ищет контакты по телефону, email, имени, фамилии или другим полям CRM.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Робот полезен для менеджера, ищущего существующего человека по нескольким контактным признакам. Имя совпадает у разных клиентов, а телефон или email помогает уточнить выбор. Робот ищет по заданной логике, сохраняя список всех результатов вместо предположения о единственном человеке.
Что делает и когда применять
Робот помогает найти уже существующие контакты и использовать найденные ID в дальнейших условиях или действиях бизнес-процесса.
Что подготовить
Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.
Выберите И/ИЛИ и заполните нужные телефон, email, имя, фамилию или дополнительные поля. Маска % в имени и фамилии расширяет поиск; используйте её осознанно и проверяйте количество совпадений.
Как настроить и использовать
- Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Поиск контакта по параметрам». В шаблоне бизнес-процесса добавьте одноимённое действие.
- Выберите И/ИЛИ и заполните нужные телефон, email, имя, фамилию или дополнительные поля. Маска % в имени и фамилии расширяет поиск; используйте её осознанно и проверяйте количество совпадений.
- Заполните Логика поиска, Email, Имя. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
- Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
- Выполните пробный запуск на отдельном учебном элементе. Сначала проверьте статус и пояснение ошибки, затем содержательный результат и ветку, выбранную следующим действием.
Параметры робота
В полях формы, которые допускают несколько значений, добавляйте каждое значение отдельным элементом через редактор. Обычные текстовые, числовые и списковые поля заполняйте в указанном для них формате.
Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.
| Поле в настройках | Что передать | Обязательность и исходное значение |
|---|---|---|
Логика поиска (logic) |
Формат: выбор из списка. Варианты: and: И (AND); or: ИЛИ (OR). | Обязательно. По умолчанию: and |
Телефон (phone) |
Телефон для поиска. Лишние символы будут удалены. Формат: строка. Можно передать несколько значений. | Необязательно. Значение по умолчанию в настройках не задано |
Email (email) |
Email для поиска. Формат: строка. Можно передать несколько значений. | Необязательно. Значение по умолчанию в настройках не задано |
Имя (name) |
Можно использовать % в начале или конце для поиска по маске. Формат: строка. | Необязательно. Значение по умолчанию в настройках не задано |
Фамилия (last_name) |
Можно использовать % в начале или конце для поиска по маске. Формат: строка. | Необязательно. Значение по умолчанию в настройках не задано |
Другие поля для поиска (other) |
Формат: ПОЛЕ=ЗНАЧЕНИЕ или =ПОЛЕ=ЗНАЧЕНИЕ, например: =UF_CRM_123=value1 Формат: строка. Можно передать несколько значений. | Необязательно. Значение по умолчанию в настройках не задано |
Учебный пример
Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.
- Логика поиска (
logic):and. - Email (
email):["client@example.com"]. - Имя (
name):Анна.
При совместном поиске имя и email должны соответствовать условиям. Если несколько контактов всё равно совпали, возвращается список и количество; первый ID сам по себе не подтверждает правильность выбора.
Какие данные возвращает и что делать дальше
| Результат | Какое значение получает следующий шаг |
|---|---|
Статус выполнения (Y/N) (status) |
строка |
Контакты найдены (found) |
да/нет |
ID найденных контактов (contactIds) |
целое число, несколько значений |
Первый найденный ID контакта (firstContactId) |
целое число |
Количество найденных элементов (count) |
целое число |
Текст ошибки (error) |
строка |
ID найденных контактов (contactId) |
целое число, несколько значений |
Передайте один подтверждённый контакт в связь с лидом или сделкой. Для неоднозначного списка создайте ветку уточнения, не объединяйте людей автоматически по одному совпавшему признаку.
Ошибки и ограничения
Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.