Получить комментарии элемента
Робот «Получить комментарии элемента» читает комментарии таймлайна лида, сделки, контакта, компании, предложения, счёта или элемента смарт-процесса Битрикс24 и возвращает их в бизнес-процесс: одной строкой с подписью автора и датой, списком для перебора, массивом JSON и отдельными полями последнего комментария. Поддерживает отбор по автору, периоду создания и количеству последних записей.
Робот читает комментарии таймлайна и передаёт их дальше по процессу. Источник задаётся типом и ID, пустой ID означает текущий элемент, поэтому можно собирать комментарии как своей карточки, так и связанной. Выдача идёт сразу в четырёх формах, потому что дальше с комментариями делают разное: строка с подписью автора и датой годится в поле или в письмо, множественное значение перебирается циклом процесса, JSON уходит во внешнюю систему HTTP-запросом, а поля последнего комментария закрывают самый частый случай «что там написали в прошлый раз». Отбор возможен по автору, по периоду создания и по количеству последних записей; ограничение по количеству применяется последним, то есть к уже отфильтрованному. За один запуск просматривается до 1000 комментариев и отдаётся до 200. Типовые сценарии: положить переписку в поле для отчёта, отправить историю обсуждения руководителю, передать комментарии во внешнюю систему.
Какие параметры принимает робот?
| Параметр | Тип | Обязательный? | По умолчанию |
|---|---|---|---|
| Источник: тип | select | да | current |
| Источник: ID (пусто = текущий) | int | — | |
| Источник: ID типа смарт-процесса | int | — | |
| Фильтр: автор (пусто = все) | user | — | |
| Фильтр: с даты | date | — | |
| Фильтр: по дату | date | — | |
| Фильтр: только последние N комментариев | int | — |
Что возвращает робот?
| Параметр | Тип |
|---|---|
| Успех (Y/N) | string |
| Найдено комментариев | int |
| Комментарии одной строкой | string |
| Комментарии списком | string |
| Комментарии в JSON | string |
| Последний комментарий: текст | string |
| Последний комментарий: автор | string |
| Последний комментарий: дата | string |
| Ошибка | string |
Сценарий: отправить руководителю последние комментарии сделки
- Добавьте робота «Получить комментарии элемента» в роботы сделки
- Источник: «Текущий элемент», «только последние N записей» — 5
- Следующим шагом отправьте уведомление, подставив результат «Комментарии одной строкой»
- В уведомление попадут пять последних комментариев с авторами и датами