Поиск Лида (v.2)

Активити (робот) "Поиск лида v2" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

Поиск лидов по ФИО, названию компании, должности и другим полям;
Поиск лидов по телефону или email с использованием механизма поиска дубликатов;
Фильтрация лидов для создания отчётов и аналитики;
Поиск дубликатов лидов для очистки базы данных;
Поиск лидов по источникам для анализа эффективности каналов привлечения;
Поиск лидов по статусам для автоматизации воронки продаж;
Массовые операции над группой лидов (изменение статуса, назначение ответственного);
Поиск лидов по дате создания для контроля актуальности;
Поиск лидов по пользовательским полям для сложной фильтрации;
Интеграция с внешними системами через поиск по внешним идентификаторам.

Как работает активити (робот):
- Активити (робот) автоматически получает список всех доступных полей лида из CRM вашего портала через REST API (crm.lead.fields);
- Для каждого поля создаётся параметр поиска, который можно заполнить для фильтрации;
- Для полей PHONE и EMAIL используется специальный механизм поиска дубликатов (crm.duplicate.findbycomm);
- Можно комбинировать несколько полей для более точного поиска;
- Поиск выполняется по принципу "И" (AND) - все указанные условия должны выполняться одновременно;
- Поддерживается обработка больших объёмов данных (более 50 лидов);
- Результаты возвращаются в виде массива ID лидов, строки с ID через запятую, первого и последнего ID, количества найденных лидов.

Сценарий работы активити (робота) бизнес-процесса

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID	В данном поле указывается числовой идентификатор искомого лида. Примеры: - ={123} - найти лид с ID равным 123; - {=Document:ID} - использовать ID из текущего документа; - ={!123} - найти все лиды, кроме лида с ID 123.
Название лида	В данном поле указывается название искомого лида. Поддерживает поиск по частичному совпадению. Примеры: - ={%заявка} - найти лиды, название которых содержит "заявка"; - ={Заявка с сайта} - найти лид с точным названием; - ={!%тест} - найти лиды, название которых не содержит "тест".
Обращение	В данном поле указывается обращение, которое содержится в искомом лиде. Примеры: - ={Господин} - найти лиды с обращением "Господин".
Имя	В данном поле указывается имя, указанное в искомом лиде. Поддерживает поиск по частичному совпадению. Примеры: - ={%Иван} - найти лиды с именем, содержащим "Иван"; - ={Иван} - найти лиды с точным именем "Иван".
Отчество	В данном поле указывается отчество, указанное в искомом лиде. Примеры: - ={%Иванович} - найти лиды с отчеством, содержащим "Иванович".
Фамилия	В данном поле указывается фамилия, указанная в искомом лиде. Примеры: - ={%Петров} - найти лиды с фамилией, содержащей "Петров"; - {=Document:LAST_NAME} - использовать фамилию из текущего документа.
Название компании	В данном поле указывается название компании, которое указано в поле лида "Название компании". Примеры: - ={%ООО} - найти лиды с названием компании, содержащим "ООО"; - ={ООО Рога и копыта} - найти лид с точным названием компании.
Источник	В данном поле можно выбрать источники искомого лида. Выбрать можно несколько штук, зажав Ctrl и кликая по нужным источникам. Примеры: - WEB - найти лиды из источника "Веб-сайт"; - CALL - найти лиды из источника "Звонок".
Дополнительно об источнике	В данном поле указываются дополнительные сведения об источнике лида. Примеры: - ={%реклама} - найти лиды с дополнительной информацией об источнике, содержащей "реклама".
Статус	В данном поле можно выбрать несколько статусов для искомого лида. Выбрать можно несколько штук, зажав Ctrl и кликая по нужным статусам. Примеры: - Новый - найти новые лиды; - В работе - найти лиды в работе.
Дополнительно о статусе	В данном поле указываются дополнительные сведения о статусе лида.
Состояние статуса	В данном поле указывается состояние статуса искомого лида. Примеры: - ={P} - найти лиды в работе (Process); - ={S} - найти успешно конвертированные лиды (Success); - ={F} - найти проваленные лиды (Failed).
Должность	В данном поле указывается должность, которая указана в поле лида "Должность". Примеры: - ={%директор} - найти лиды с должностью, содержащей "директор".
Адрес	В данном поле указывается значение "фактического адреса", заполненное в искомом лиде. Примеры: - ={%Москва} - найти лиды с адресом, содержащим "Москва".
Адрес (стр. 2)	В данном поле указывается значение "квартира/офис фактического адреса", заполненное в искомом лиде.
Город	В данном поле указывается город, который указан в поле лида "Город". Примеры: - ={Санкт-Петербург} - найти лиды из Санкт-Петербурга.
Телефон	В данном поле указывается телефон, который был указан в лиде в соответствующем поле. Поиск осуществляется через механизм поиска дубликатов. Примеры: - +79001234567 - найти лид с указанным телефоном; - {=Document:PHONE} - использовать телефон из текущего документа.
E-mail	В данном поле указывается email, который был указан в лиде в соответствующем поле. Поиск осуществляется через механизм поиска дубликатов. Примеры: - test@example.com - найти лид с указанным email; - {=Document:EMAIL} - использовать email из текущего документа.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания (Время ожидания ответа от приложения)	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Операторы сравнения для поиска

Данные символы ставятся перед содержимым ячейки:
- ={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".
- ={!%ваше значение} - не содержит.
Пример заполнения: ={!%123}, это значит, что значение в выбранном поле не содержит 123.
- ={ваше значение} - равно.
Пример заполнения: ={123}, это значит, что значение в выбранном поле равно 123. Если в поле используется текст, то этот текст должен совпадать символ в символ.
- ={!ваше значение} - не равно.
Пример заполнения: ={!123}, это значит, что значение в выбранном поле не равно 123.
- ={>ваше значение} - больше.
- ={<ваше значение} - меньше.
- ={=>} - больше или равно.
- ={=<} - меньше или равно.

Для полей типа "дата" и "дата/время":
- Содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}
- В случае с переменной: ={=>{=Variable:search_date}}
- При необходимости поиска диапазона "от и до": ={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Примеры использования активити (робота)

Описание примера	Решение
Поиск лида по телефону +79001234567	Параметры: Телефон - +79001234567. Активити (робот) найдёт лид с указанным номером телефона через механизм поиска дубликатов.
Поиск лида по email из текущей сделки	Параметры: E-mail - {=Document:EMAIL}. Активити (робот) найдёт лид с email из текущего документа.
Поиск лидов с фамилией, содержащей "Иванов"	Параметры: Фамилия - ={%Иванов}. Активити (робот) найдёт все лиды, фамилия которых содержит "Иванов".
Поиск лидов из источника "Веб-сайт"	Параметры: Источник - WEB. Активити (робот) найдёт все лиды, пришедшие через веб-сайт.
Поиск новых лидов	Параметры: Статус - Новый. Активити (робот) найдёт все лиды в статусе "Новый".
Поиск лидов в работе	Параметры: Состояние статуса - ={P}. Активити (робот) найдёт все лиды со статусом "В работе" (Process).
Поиск лидов из компании, содержащей "ООО"	Параметры: Название компании - ={%ООО}. Активити (робот) найдёт все лиды, у которых название компании содержит "ООО".
Поиск лидов с должностью "директор"	Параметры: Должность - ={%директор}. Активити (робот) найдёт все лиды, должность которых содержит "директор".
Поиск лидов из Москвы	Параметры: Город - ={Москва}. Активити (робот) найдёт все лиды из Москвы.
Поиск проваленных лидов	Параметры: Состояние статуса - ={F}. Активити (робот) найдёт все проваленные лиды (Failed).

Сценарий работы робота

Возвращаемые параметры данного активити (робота):
- Результат поиска (массив для итератора) (search_results_array) - массив чисел с ID найденных лидов. Используется для итерации по результатам в бизнес-процессе.
- Результат поиска (строка) (search_results_string) - строка со всеми результатами поиска, разделёнными запятыми. Удобно для передачи в другие активити (роботы).
- Первый результат поиска (search_result_first_string) - строка с первым результатом поиска. Полезно, когда нужно получить только первый найденный лид.
- Последний результат поиска (search_result_last_string) - строка с последним результатом поиска.
- Количество найденных элементов (count_search) - числовое значение, указывающее количество найденных лидов.
- Соответствует условиям (math_search_results) - строка, указывающая результат поиска. Возможные значения: Y (найдены лиды) или N (лиды не найдены).
- Логи ошибок (s_error_logs) - строка с описанием ошибки или сообщением об успешном выполнении.

Важно о возвращаемых параметрах: Если лиды не найдены, параметр math_search_results будет равен N, а count_search будет равен 0. Всегда проверяйте значение параметра math_search_results перед использованием результатов в дальнейших шагах бизнес-процесса.

Важно! Ограничения и рекомендации:

Поиск по телефону и email:
При поиске по полям PHONE или EMAIL используется специальный механизм поиска дубликатов (crm.duplicate.findbycomm), который работает более эффективно для этих типов полей. Телефоны и email ищутся отдельно от других полей.

Динамическая поддержка полей:
Активити (робот) автоматически получает список всех доступных полей лида из вашего портала, включая пользовательские поля. Это означает, что вы можете искать по любым полям, доступным в вашей CRM.

Множественный выбор статусов и источников:
Параметры "Статус" и "Источник" поддерживают множественный выбор. Зажмите Ctrl и кликайте по нужным значениям для выбора нескольких вариантов.

Комбинирование условий:
При указании нескольких полей для поиска, все условия объединяются по принципу "И" (AND). Будут найдены только те лиды, которые соответствуют всем указанным условиям.

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на просмотр лидов в CRM. Рекомендуется использовать пользователя с правами администратора системы.

Использование в итераторе:
Для обработки большого количества лидов рекомендуется использовать итератор с параметром search_results_array. Это позволит обработать все лиды последовательно.

Ваша корзина пуста

Поиск Лида (v.2)