Выбрать курс
- Приложение для Битрикс24 "Лаборатория роботов"
- Приложение для Битрикс24 "Сквозная аналитика 2.0"
- Приложение для Битрикс24 "Уничтожитель дубликатов"
- Приложение для Битрикс24 "Межпортальные задачи"
- Приложение для Битрикс24 "Немой чат-бот"
- Приложение для Битрикс24 "Доходы и расходы CRM"
- Приложение для Битрикс24 "Продуктивный Jivosite"
328
/
345
Поиск сообщений в чате
Данное активити (робот) позволяет выполнить поиск сообщений в чате Битрикс24.
Результатом работы является список найденных сообщений, их тексты и служебные данные (пользователи, файлы, реакции).
Результатом работы является список найденных сообщений, их тексты и служебные данные (пользователи, файлы, реакции).
Как работает активити (робот):
- Вы указываете ID чата;
- При необходимости задаете строку поиска, период, сортировку, лимит и LAST_ID для пагинации;
- Активити выполняет запрос im.dialog.messages.search;
- В ответ возвращаются найденные сообщения и стандартные поля списка для дальнейшей обработки в БП.
- Вы указываете ID чата;
- При необходимости задаете строку поиска, период, сортировку, лимит и LAST_ID для пагинации;
- Активити выполняет запрос im.dialog.messages.search;
- В ответ возвращаются найденные сообщения и стандартные поля списка для дальнейшей обработки в БП.
Описание параметров активити (робота)
| Название поля | Описание и примеры использования |
|---|---|
| ID чата |
Обязательный параметр. Числовой идентификатор чата, где выполняется поиск сообщений. Пример: 2421. |
| Строка поиска |
Необязательный параметр. Поиск по тексту сообщений. Рекомендуется использовать строку длиной от 3 символов. Пример: "договор", "счет", "оплата". |
| Дата начала периода / Дата конца периода |
Необязательные параметры. Ограничивают поиск указанным диапазоном дат. Формат: ISO 8601 (RFC3339). |
| Точная дата |
Необязательный параметр. Поиск выполняется в пределах суток указанной даты. |
| Сортировка по ID |
ASC или DESC. По умолчанию DESC. |
| Лимит сообщений |
Необязательный параметр. По умолчанию 50, максимум 200. |
| LAST_ID для пагинации |
Необязательный параметр. Используется для постраничной выборки: укажите ID последнего сообщения из предыдущего результата. |
Примеры использования активити (робота)
| Описание примера | Решение |
|---|---|
| Найти все сообщения с ключевым словом за день |
Укажите ID чата, строку поиска и точную дату. Получите выборку сообщений и обработайте тексты в следующих шагах БП. |
| Контроль упоминаний важного слова | Запускайте робот по расписанию с SEARCH_MESSAGE (например, "срочно"), далее проверяйте count_search и отправляйте уведомление при найденных совпадениях. |
| Постраничный просмотр найденных сообщений | Сохраняйте последний ID из search_result_last_string и передавайте его в LAST_ID для следующего вызова. |
| Анализ авторов найденных сообщений | Используйте users_json вместе с messages_json, чтобы сопоставить author_id и данные пользователя. |
| Отдельная обработка сообщений с файлами |
Проверяйте count_files и files_json. Если есть вложения, запускайте отдельную ветку БП. |
Возвращаемые параметры данного активити:
- Количество найденных сообщений (count_messages);
- Количество пользователей(count_users);
- Количество файлов (count_files);
- Количество реакций (count_reactions);
- JSON с сообщениями, пользователями, файлами и реакциями;
- Тексты сообщений массивом (message_texts_array);
- Стандартные поля поиска : search_results_array, search_results_string, search_result_first_string, search_result_last_string, count_search, math_search_results.
- Количество найденных сообщений (count_messages);
- Количество пользователей(count_users);
- Количество файлов (count_files);
- Количество реакций (count_reactions);
- JSON с сообщениями, пользователями, файлами и реакциями;
- Тексты сообщений массивом (message_texts_array);
- Стандартные поля поиска : search_results_array, search_results_string, search_result_first_string, search_result_last_string, count_search, math_search_results.