Поиск контакта по телефону
Ищет контакты по одному или нескольким номерам телефона.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Робот полезен для менеджера входящих обращений, который знает только телефон клиента. Контакт уже есть в CRM, но обращение пришло из другого источника. Робот ищет совпадения по одному или нескольким телефонам и помогает связать процесс с существующим человеком вместо создания дубля.
Что делает и когда применять
Робот полезен, когда нужно быстро найти контакт по телефону из заявки, письма или другого источника.
Что подготовить
Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.
Передайте телефон из обращения. Лишние символы оформления очищаются, но результат всё равно нужно проверить при нескольких совпадениях. Найденный первый ID не обязательно означает единственного подходящего человека.
Как настроить и использовать
- Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Поиск контакта по телефону». В шаблоне бизнес-процесса добавьте одноимённое действие.
- Передайте телефон из обращения. Лишние символы оформления очищаются, но результат всё равно нужно проверить при нескольких совпадениях. Найденный первый ID не обязательно означает единственного подходящего человека.
- Заполните Телефон. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
- Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
- Выполните пробный запуск на отдельном учебном элементе. Сначала проверьте статус и пояснение ошибки, затем содержательный результат и ветку, выбранную следующим действием.
Параметры робота
В полях формы, которые допускают несколько значений, добавляйте каждое значение отдельным элементом через редактор. Обычные текстовые, числовые и списковые поля заполняйте в указанном для них формате.
Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.
| Поле в настройках | Что передать | Обязательность и исходное значение |
|---|---|---|
Телефон (phone) |
Телефон для поиска. Лишние символы будут удалены. Формат: строка. Можно передать несколько значений. | Необязательно. Значение по умолчанию в настройках не задано |
Учебный пример
Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.
- Телефон (
phone):+7 (900) 000-00-00.
Если номер учебного обращения сохранён у двух контактов, результат содержит оба ID и count=2. Ветку однозначной привязки выбирайте только после проверки количества, а не по наличию первого результата.
Какие данные возвращает и что делать дальше
| Результат | Какое значение получает следующий шаг |
|---|---|
Статус выполнения (Y/N) (status) |
строка |
Контакты найдены (found) |
да/нет |
ID найденных контактов (contactIds) |
целое число, несколько значений |
Первый найденный ID контакта (firstContactId) |
целое число |
Количество найденных элементов (count) |
целое число |
Текст ошибки (error) |
строка |
ID найденных контактов (contactId) |
целое число, несколько значений |
При count=1 передайте «Первый найденный ID контакта» дальше. Для нескольких результатов создайте задачу выбора, а при отсутствии контакта отделите поиск нового лица от ошибки выполнения.
Ошибки и ограничения
Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.