Получить сообщения рабочего чата за период
Робот «Получить сообщения рабочего чата за период». Отбирает сообщения из ограниченной доступной истории группового чата.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Для координатора проекта, который готовит ограниченную подборку обсуждения. Позволяет отобрать текст за нужный период без ручного копирования и явно увидеть, когда просмотренная история неполна.
Что подготовить
Установите действие в каталоге приложения «CRM роботы 2.0 + AI», затем добавьте его в нужную точку автоматизации. Для чтения или изменения объектов нужен соответствующий доступ пользователя подключения. Идентификаторы берите из полей карточки или результатов предыдущих шагов: название объекта не заменяет его числовой ID.
Параметры и значения
| Поле в настройке | Тип | Обязательность и исходное значение |
|---|---|---|
| ID группового чата | Целое число | Обязательное; значение по умолчанию не задано |
| Начало периода | Дата и время | Обязательное; значение по умолчанию не задано |
| Конец периода | Дата и время | Обязательное; значение по умолчанию не задано |
| Глубина просмотра: 1–1000 | Целое число | Обязательное; значение по умолчанию не задано |
| Лимит результата: 1–100 | Целое число | Обязательное; значение по умолчанию не задано |
Поля, обозначенные JSON, заполняйте корректными массивами или объектами с двойными кавычками в строках. Подставляйте одно значение через штатный выбор данных редактора; не копируйте служебный идентификатор шага из другого шаблона.
Как использовать пошагово
- Укажите ID группового рабочего чата; пользователь подключения должен быть его участником.
- Задайте начало и конец периода с часовым поясом. Обе границы включены.
- Выберите глубину просмотра последних сообщений от 1 до 1000 и лимит результата от 1 до 100.
- Передайте JSON сообщений следующему шагу анализа или отчёта.
- Проверьте признак неполной выборки. Если он положительный, не называйте результат полной историей периода; увеличьте доступную глубину или разделите задачу.
Учебный пример и ожидаемый результат
Для чата 500 выбран один рабочий день, просмотр последних 200 сообщений и результат до 50. Если найдено 12 подходящих сообщений и достигнут конец видимой истории без других ограничений, ожидается 12 сообщений. При остановке по лимиту полнота не подтверждается. Все номера объектов в примере условные; замените их данными своего портала. Пример объясняет настройку, а не подтверждает выполненный запуск.
Какие результаты передать дальше
- Сообщения (JSON): текст.
- ID сообщений: целое число, список.
- Возвращено сообщений: целое число.
- Выборка неполная: да/нет (Y/N).
В следующем действии откройте выбор данных и выберите результат этого робота по названию. Сначала проверьте статус выполнения; при ошибке передайте её пояснение на разбор и не используйте пустые значения как подтверждённый результат. Успех шага и положительный ответ на бизнес-проверку: разные условия.
Ограничения и исправление ошибок
Возвращаются ID, авторы, текст и даты без файлов и ссылок скачивания. Системный автор может иметь ID 0. Скрытая или удалённая история не восстанавливается. Чтение не меняет состояние прочтения; доступ к CRM-сделке сам по себе не даёт доступ к её рабочему чату.
Если доступ изменился, сначала проверьте объект под пользователем подключения и актуальность ID. Повторяйте действие после устранения причины. Для действий с записью предварительно сверяйте фактическое состояние: сообщение об ошибке само по себе не доказывает, что ни одна правка не сохранилась.