Поиск встреч в сущности

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

Поиск всех встреч, связанных с конкретной сущностью CRM (контакт, компания, лид, сделка);
Фильтрация встреч по ответственному, теме, описанию и месту проведения;
Поиск встреч за определённый период времени;
Проверка наличия встречи с определёнными параметрами по ID встречи;
Поиск встреч в смарт-процессах;
Проверка статуса встречи (выполнена/не выполнена);
Поиск невыполненных встреч;
Аналитика и отчётность по встречам клиентов;
Автоматизация процессов на основе истории встреч;
Проверка условий выполнения встреч для условной логики в бизнес-процессах.

Как работает активити (робот):
- Активити (робот) поддерживает два режима работы: проверка условий по ID встречи и поиск встреч в сущности по фильтрам;
- Если указан ID встречи, активити (робот) проверяет соответствие встречи указанным условиям (статус встречи);
- Если ID встречи не указан, активити (робот) ищет встречи в указанной сущности по заданным фильтрам;
- Поддерживается поиск встреч в стандартных сущностях (лид, сделка, контакт, компания) и смарт-процессах;
- Результаты возвращаются в виде массива ID встреч и строки с ID через запятую;
- Поддерживается фильтрация по ответственному, теме, описанию, месту проведения и статусу встречи;
- Поддерживается фильтрация по дате создания встречи (от и до);
- Активити (робот) работает через REST API Битрикс24 (crm.activity.list и crm.activity.get);
- Поддерживается обработка больших объёмов данных (более 50 встреч) через batch-запросы.

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

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

Название поля	Описание и примеры использования
ID встречи	В данном поле указывается идентификатор встречи для проверки её параметров. Это необязательный параметр, но если он указан, то другие параметры поиска (тип сущности, ID сущности и фильтры) не учитываются. Активити (робот) проверит соответствие встречи указанным условиям (статус встречи). Важно: Если указан ID встречи, активити (робот) работает в режиме проверки условий. Параметры "Тип сущности", "ID сущности" и все фильтры игнорируются. Результат будет возвращён в параметре math_search_results (Y - соответствует условиям, N - не соответствует). Примеры: - {=Variable:MEETING_ID} - проверить встречу с ID из переменной предыдущего активити (робота); - 12345 - проверить встречу с ID 12345; - {=A1988_22222_92566_99999:search_results} - использовать ID встречи из результата предыдущего поиска. Режим проверки условий: При указании ID встречи активити (робот) проверяет соответствие встречи указанным условиям: - Статус встречи (если указан) - проверяется значение COMPLETED (N - не завершена, Y - завершена). Если все указанные условия выполнены, возвращается math_search_results = Y, иначе math_search_results = N.
Ответственный	В данном поле указывается сотрудник, ответственный за встречу. Это необязательный параметр, используется как дополнительный фильтр при поиске встреч по типу сущности и ID сущности. Примеры: - {=Document:ASSIGNED_BY_ID} - искать встречи ответственного из текущей сущности; - {=User:ID} - искать встречи текущего пользователя; - [U1] - искать встречи пользователя с ID 1; - user_25 - искать встречи пользователя с ID 25; - {=Variable:RESPONSIBLE_ID} - использовать ID из переменной предыдущего активити (робота). Когда использовать: - Для фильтрации встреч по ответственному при поиске по сущности; - Для поиска всех встреч конкретного сотрудника, связанных с определённой сущностью; - Для анализа работы конкретного сотрудника.
Тип сущности	В данном поле указывается тип сущности CRM, в которой будет осуществлён поиск встреч. Это необязательный параметр, используется только если не указан "ID встречи". Выбирается из выпадающего списка. Варианты выбора: - LEAD - Лид; - DEAL - Сделка; - CONTACT - Контакт; - COMPANY - Компания; - QUOTE - Предложение; - SMART_INVOICE - Счёт (новый); - ORDER - Заказ; - СМАРТ: [название смарт-процесса] - для поиска встреч в смарт-процессах (список формируется автоматически на основе настроек вашего портала). Примеры: - CONTACT - искать встречи в контактах; - DEAL - искать встречи в сделках; - LEAD - искать встречи в лидах. Когда использовать: - Для поиска всех встреч конкретной сущности; - Для фильтрации встреч по типу сущности перед применением других фильтров.
ID сущности	В данном поле указывается идентификатор сущности CRM, в которой будет осуществлён поиск встреч. Это необязательный параметр, используется только если указан "Тип сущности" и не указан "ID встречи". Примеры: - {=Document:ID} - искать встречи в текущей сущности из документа (контакт, компания, лид, сделка); - 123 - искать встречи в сущности с ID 123; - {=Variable:CONTACT_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Когда использовать: - Для поиска всех встреч конкретной сущности; - Для фильтрации встреч по сущности перед применением других фильтров.
Статус встречи	В данном поле указывается статус встречи (выполнена или не выполнена) для фильтрации. Это необязательный параметр, используется как дополнительный фильтр при поиске встреч или для проверки условий при указании ID встречи. Варианты выбора: - Не завершена (1) - встреча не завершена (COMPLETED = N); - Завершена (2) - встреча завершена (COMPLETED = Y). Примеры использования: - Не завершена (1) - найти только невыполненные встречи; - Завершена (2) - найти только выполненные встречи; - При указании ID встречи - проверить, соответствует ли статус встречи указанному значению. Когда использовать: - Для фильтрации невыполненных встреч; - Для поиска уже выполненных встреч; - Для проверки статуса конкретной встречи.
Тема встречи	В данном поле можно указать тему (заголовок) встречи для фильтрации. Это необязательный параметр, используется как дополнительный фильтр при поиске встреч по типу сущности и ID сущности. Примеры: - Презентация продукта - найти встречи с указанной темой; - {=Variable:MEETING_SUBJECT} - использовать тему из переменной предыдущего активити (робота); - Встреча с клиентом - найти встречи, содержащие указанный текст в теме. Когда использовать: - Для поиска встреч по конкретной теме; - Для фильтрации встреч по ключевым словам в теме.
Описание встречи	В данном поле можно указать описание встречи для фильтрации. Это необязательный параметр, используется как дополнительный фильтр при поиске встреч по типу сущности и ID сущности. Примеры: - Обсуждение условий договора - найти встречи с указанным описанием; - {=Variable:MEETING_DESCRIPTION} - использовать описание из переменной предыдущего активити (робота); - Консультация - найти встречи, содержащие указанный текст в описании. Когда использовать: - Для поиска встреч по содержанию описания; - Для фильтрации встреч по ключевым словам в описании.
Место проведения	В данном поле можно указать место проведения встречи для фильтрации. Это необязательный параметр, используется как дополнительный фильтр при поиске встреч по типу сущности и ID сущности. Примеры: - Офис компании - найти встречи, проводимые в указанном месте; - {=Variable:MEETING_LOCATION} - использовать место из переменной предыдущего активити (робота); - Онлайн - найти встречи, проводимые онлайн. Когда использовать: - Для поиска встреч по месту проведения; - Для фильтрации встреч по локации.
Дата создания от	В данном поле можно указать дату и время, начиная с которой будет осуществлён поиск встреч. Это необязательный параметр, используется как дополнительный фильтр при поиске встреч. Примеры: - {=System:NowLocal} - искать встречи с текущей даты и времени; - ={{=dateadd({=System:Now}, "-7d")}} - искать встречи за последние 7 дней; - ={{=dateadd({=System:Now}, "-1m")}} - искать встречи за последний месяц; - 01.01.2025 00:00:00 - искать встречи с указанной даты; - {=Variable:START_DATE} - использовать дату из переменной предыдущего активити (робота). Когда использовать: - Для поиска встреч за определённый период; - Для анализа встреч за последние дни/месяцы; - Для фильтрации встреч по дате начала.
Дата создания до	В данном поле можно указать дату и время, до которой будет осуществлён поиск встреч. Это необязательный параметр, используется как дополнительный фильтр при поиске встреч. Примеры: - {=System:NowLocal} - искать встречи до текущей даты и времени; - ={{=dateadd({=System:Now}, "1d")}} - искать встречи до завтрашнего дня; - 31.12.2025 23:59:59 - искать встречи до указанной даты; - {=Variable:END_DATE} - использовать дату из переменной предыдущего активити (робота). Когда использовать: - Для поиска встреч за определённый период (в паре с параметром "Дата создания от"); - Для анализа встреч до определённой даты; - Для фильтрации встреч по дате окончания периода поиска.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

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

Описание примера	Решение
Проверка соответствия встречи условиям по ID	Параметры: ID встречи - {=Variable:MEETING_ID}, Статус встречи - 2 (Завершена). Активити (робот) проверит, завершена ли встреча. Результат будет возвращён в параметре math_search_results (Y или N).
Поиск всех встреч контакта	Параметры: Тип сущности - CONTACT, ID сущности - {=Document:ID}, Ответственный - не указывается, Статус встречи - не указывается, Тема встречи - не указывается, Описание встречи - не указывается, Место проведения - не указывается, Дата создания от - не указывается, Дата создания до - не указывается. Активити (робот) найдёт все встречи контакта.
Поиск невыполненных встреч сделки	Параметры: Тип сущности - DEAL, ID сущности - {=Document:ID}, Ответственный - не указывается, Статус встречи - 1 (Не завершена), Тема встречи - не указывается, Описание встречи - не указывается, Место проведения - не указывается, Дата создания от - не указывается, Дата создания до - не указывается. Активити (робот) найдёт все невыполненные встречи сделки.
Поиск встреч ответственного за последний месяц	Параметры: Тип сущности - CONTACT, ID сущности - {=Document:ID}, Ответственный - {=User:ID}, Статус встречи - не указывается, Тема встречи - не указывается, Описание встречи - не указывается, Место проведения - не указывается, Дата создания от - ={{=dateadd({=System:Now}, "-1m")}}, Дата создания до - {=System:NowLocal}. Активити (робот) найдёт все встречи текущего пользователя с контактом за последний месяц.
Поиск встреч по теме	Параметры: Тип сущности - DEAL, ID сущности - {=Document:ID}, Ответственный - не указывается, Статус встречи - не указывается, Тема встречи - "Презентация", Описание встречи - не указывается, Место проведения - не указывается, Дата создания от - не указывается, Дата создания до - не указывается. Активити (робот) найдёт все встречи сделки с указанной темой.
Поиск встреч в смарт-процессе	Параметры: Тип сущности - СМАРТ: Заявки, ID сущности - {=Document:ID}, Ответственный - не указывается, Статус встречи - не указывается, Тема встречи - не указывается, Описание встречи - не указывается, Место проведения - не указывается, Дата создания от - не указывается, Дата создания до - не указывается. Активити (робот) найдёт все встречи элемента смарт-процесса.
Поиск встреч за рабочий день	Параметры: Тип сущности - CONTACT, ID сущности - {=Document:ID}, Ответственный - не указывается, Статус встречи - не указывается, Тема встречи - не указывается, Описание встречи - не указывается, Место проведения - не указывается, Дата создания от - ={{=date('d.m.Y 09:00:00', {=System:Now})}}, Дата создания до - ={{=date('d.m.Y 18:00:00', {=System:Now})}}. Активити (робот) найдёт все встречи контакта за текущий рабочий день.
Проверка статуса конкретной встречи	Параметры: ID встречи - {=Variable:MEETING_ID}, Статус встречи - 1 (Не завершена). Активити (робот) проверит, не завершена ли встреча. Результат будет возвращён в параметре math_search_results.
Поиск встреч через итератор	Параметры: Тип сущности - CONTACT, ID сущности - {=Iterator:Value}, Ответственный - не указывается, Статус встречи - не указывается, Тема встречи - не указывается, Описание встречи - не указывается, Место проведения - не указывается, Дата создания от - не указывается, Дата создания до - не указывается. Для каждого контакта из итератора активити (робот) найдёт все встречи.
Поиск встреч за определённый период с фильтрацией	Параметры: Тип сущности - DEAL, ID сущности - {=Document:ID}, Ответственный - {=Document:ASSIGNED_BY_ID}, Статус встречи - 1 (Не завершена), Тема встречи - не указывается, Описание встречи - не указывается, Место проведения - не указывается, Дата создания от - ={{=dateadd({=System:Now}, "-30d")}}, Дата создания до - {=System:NowLocal}. Активити (робот) найдёт все невыполненные встречи ответственного по сделке за последние 30 дней.

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

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

Особенности возвращаемых параметров:
- При указании ID встречи: возвращается только параметр math_search_results (Y или N), другие параметры не заполняются;
- При поиске встреч: возвращаются все параметры, включая массивы ID встреч;
- Если найдена одна встреча: search_results_array содержит одно значение;
- Если найдено несколько встреч: search_results_array содержит массив ID встреч.

Важно о возвращаемых параметрах: Если вы хотите использовать результат работы активити (робота) в другом активити (роботе), в котором параметр - простое число, то несколько чисел, разделённых запятыми, работать не будут, так как параметр ждёт только одно число. Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".

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

Два режима работы:
Активити (робот) поддерживает два режима работы:
- Режим 1: Проверка условий по ID встречи (если указан ID встречи) - проверяет соответствие встречи указанным условиям (статус встречи);
- Режим 2: Поиск встреч в сущности (если не указан ID встречи) - ищет встречи по заданным фильтрам в указанной сущности.

Обязательные параметры:
Для успешного поиска встреч обязательно должны быть указаны параметры "Тип сущности" и "ID сущности" (если не указан ID встречи). Если указан ID встречи, другие параметры не требуются.

Проверка условий при указании ID встречи:
При указании ID встречи активити (робот) проверяет соответствие встречи указанным условиям:
- Статус встречи (если указан) - проверяется значение COMPLETED (N - не завершена соответствует статусу 1, Y - завершена соответствует статусу 2).
Если все указанные условия выполнены, возвращается math_search_results = Y, иначе math_search_results = N.

Фильтрация при поиске встреч:
При поиске встреч (без указания ID встречи) все указанные фильтры работают как условия поиска:
- Ответственный фильтрует результаты по ответственному сотруднику;
- Тема, описание и место проведения фильтруют результаты по текстовому содержимому;
- Статус встречи фильтрует результаты по статусу выполнения;
- Даты работают как диапазон "от и до".

Работа со смарт-процессами:
Активити (робот) автоматически определяет смарт-процессы, доступные на вашем портале, и добавляет их в список типов сущностей. Список формируется автоматически на основе настроек портала. Для смарт-процессов используется формат TYPE_ID:OWNER_TYPE_ID (например, 1:135).

Работа с большими объёмами данных:
Активити (робот) автоматически обрабатывает случаи, когда результатов больше 50 встреч, используя специальную структуру данных (many50). Все встречи будут корректно обработаны и возвращены в результатах.

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

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

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

Поиск встреч в сущности