Поиск чатов

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

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

Как работает активити (робот):
- Активити получает список последних диалогов пользователя;
- Фильтры задаются параметрами активити: тип чата, непрочитанные, открытые линии и др.;
- Дополнительно можно отфильтровать результат по названию, типу чата, закреплению и непрочитанным сообщениям;
- Активити автоматически загружает все страницы списка чатов;
- В ответ возвращаются ID чатов в виде массива, строки, первого и последнего ID;
- Если список не успел полностью загрузиться по времени, в параметре "Есть следующая страница" (has_more) будет Y.

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

Название поля	Описание и примеры использования
Тип чата	Чат один на один, групповой чат, чат открытой линии, Чат с BitrixGPT или все типы. При выборе «Чат открытой линии» или «Чат с BitrixGPT» параметр «Только каналы» игнорируется.
Только с непрочитанными	Возвращает только диалоги с непрочитанными сообщениями. Пример: Да.
Только каналы	Оставляет в выборке только каналы. Пример: Да.
Пропускать нераспределенные открытые линии	Исключает нераспределенные чаты открытых линий.
Только с правом управления сообщениями	Оставляет чаты, где пользователь может управлять сообщениями.
Искать в последнем сообщении	Фильтр по тексту последнего сообщения в диалоге. Поддерживаются операторы поиска. Примеры: - `={%счет%}` — содержит «счет»; - `={!%спам%}` — не содержит «спам»; - `={@срочно,важно}` — точное совпадение с одним из значений.
Дата последнего сообщения	Ограничивает выборку чатов по дате последнего сообщения (LAST_MESSAGE_DATE). Пример: {=System:Now}, {=Variable:LAST_CHAT_DATE}.
Поиск по названию	Фильтр по названию чата или диалога. Поддерживаются те же операторы поиска. Пример: `={%Маркетинг%}`.
Закрепленные диалоги / Наличие непрочитанных	Дополнительная фильтрация после получения списка: Да — только с признаком, Нет — только без признака.
Ограничение количества результатов	Ограничивает итоговый список ID чатов после всех фильтров. Пример: 10.

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

Описание примера	Решение
Получить все непрочитанные чаты пользователя, исключая открытые линии	Только с непрочитанными = Да. Используйте параметр "Массив ID чатов" (search_results_array) для дальнейших шагов БП.
Найти непрочитанные чаты открытых линий	Тип чата = Чат открытой линии, Только с непрочитанными = Да.
Найти чаты с активностью после указанной даты	Дата последнего сообщения = {=dateadd({=System:Now}, "-7d")}, Тип чата = Групповой чат.
Найти групповой чат по части названия "Маркетинг"	Поиск по названию = ={%Маркетинг%}, Тип чата = Групповой чат.
Найти чаты, где в последнем сообщении упоминается «договор»	Искать в последнем сообщении = ={%договор%}.
Исключить чаты с последним сообщением «спам»	Искать в последнем сообщении = ={!%спам%}.
Получить только личные диалоги с непрочитанными сообщениями	Только с непрочитанными = Да, Тип чата = Чат один на один.
Выбрать первые 5 чатов из последних активных	Ограничение количества результатов = 5. Первый ID — в параметре "Строка ID через запятую" (search_result_first_string).
Отобрать только закрепленные групповые чаты	Тип чата = Групповой чат, Закрепленные диалоги = Да.
Найти чаты с BitrixGPT для автоматизации	Тип чата = Чат с BitrixGPT.
Контроль чатов без непрочитанных сообщений	Наличие непрочитанных = Нет. Если значение параметра "Количество найденных чатов" (count_search) = 0 — ветка «чаты не найдены».
Массовая отправка уведомления в найденные чаты	Только с непрочитанными = Да. Передайте значение параметра "Массив ID чатов" (search_results_array) в цикл и используйте идентификатор чата в роботе отправки сообщения.
Выборка чатов с правом управления сообщениями для модерации	Только с правом управления сообщениями = Да, Тип чата = Групповой чат.

Возвращаемые параметры данного активити:
- Условие выполнено (math_search_results) — Y или N;
- Количество найденных чатов (count_search);
- Массив ID чатов (search_results_array);
- Строка ID через запятую (search_results_string);
- Первый ID чата (search_result_first_string);
- Последний ID чата (search_result_last_string);
- Есть следующая страница (has_more) — Y или N;
- Журнал (s_error_logs).

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

Поиск чатов