Получить комментарии задачи за период
Робот «Получить комментарии задачи за период». Возвращает комментарии старого формата за период с отбором по авторам.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Для координатора поддержки и руководителя, собирающего отчёт по обсуждению задачи. Позволяет ограничить подборку нужным периодом и авторами, вместо переноса всего обсуждения вручную.
Что подготовить
Установите действие в каталоге приложения «CRM роботы 2.0 + AI», затем добавьте его в нужную точку автоматизации. Для чтения или изменения объектов нужен соответствующий доступ пользователя подключения. Идентификаторы берите из полей карточки или результатов предыдущих шагов: название объекта не заменяет его числовой ID.
Параметры и значения
| Поле в настройке | Тип | Обязательность и исходное значение |
|---|---|---|
| ID задачи | Целое число | Обязательное; значение по умолчанию не задано |
| Начало периода с часовым поясом | Строка | Обязательное; значение по умолчанию не задано |
| Конец периода с часовым поясом | Строка | Обязательное; значение по умолчанию не задано |
| Авторы: JSON-список ID | Текст | Необязательное; по умолчанию [] |
| Лимит комментариев | Целое число | Обязательное; по умолчанию 100 |
Поля, обозначенные JSON, заполняйте корректными массивами или объектами с двойными кавычками в строках. Подставляйте одно значение через штатный выбор данных редактора; не копируйте служебный идентификатор шага из другого шаблона.
Как использовать пошагово
- Укажите ID задачи и начало/конец периода в формате даты и времени с часовым поясом.
- При необходимости задайте массив авторов, например
[21,22]; пустой массив оставляет всех авторов. - Выберите лимит от 1 до 500. Для небольшого отчёта можно оставить 100.
- Передайте JSON комментариев в следующий шаг обработки текста либо отчёта; проверьте возвращённое количество.
- Если выборка усечена, сузьте период либо увеличьте лимит в допустимых пределах. Не подписывайте усечённую подборку как полную историю.
Учебный пример и ожидаемый результат
Для задачи 410 задан период с 2026-10-01T00:00:00+03:00 по 2026-10-02T00:00:00+03:00 и автор [21]. В результат должны войти доступные комментарии этого автора на обеих границах и внутри периода в пределах лимита. Все номера объектов в примере условные; замените их данными своего портала. Пример объясняет настройку, а не подтверждает выполненный запуск.
Какие результаты передать дальше
- ID задачи: целое число.
- Комментарии: JSON: текст.
- Возвращено комментариев: целое число.
- Результат усечён лимитом: да/нет (Y/N).
В следующем действии откройте выбор данных и выберите результат этого робота по названию. Сначала проверьте статус выполнения; при ошибке передайте её пояснение на разбор и не используйте пустые значения как подтверждённый результат. Успех шага и положительный ответ на бизнес-проверку: разные условия.
Ограничения и исправление ошибок
Читаются комментарии старого формата, а не сообщения нового чата задач. Проверяется до 10 000 доступных комментариев. Возвращаются ID, дата, автор, текст и сведения о вложениях; доступность старого обсуждения зависит от состояния задачи.
Если доступ изменился, сначала проверьте объект под пользователем подключения и актуальность ID. Повторяйте действие после устранения причины. Для действий с записью предварительно сверяйте фактическое состояние: сообщение об ошибке само по себе не доказывает, что ни одна правка не сохранилась.
Как заполнять JSON-поля
Каждый блок ниже вставляется целиком в своё поле. Не добавляйте внешние кавычки вокруг всего массива или объекта. Учебные ID и названия замените фактическими данными.
Авторы: JSON-список ID
[
21,
22
]
Значения массива обозначают ID сотрудников вашего портала. Берите их из результата поиска сотрудников или выбранного сотрудника, не из ID сделки. В массиве нужны положительные целые числа без объектов и фамилий. Пустой массив [] отключает ограничение по авторам; массив [21,22] оставляет только их. Объект {} не подходит.