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