Создать комментарии в задаче

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

Автоматическое добавление комментариев к задачам при наступлении определённых событий;
Информирование участников задачи о статусе выполнения работ;
Логирование действий бизнес-процесса в комментариях задачи;
Автоматическое уведомление о важных изменениях в связанных сущностях CRM;
Добавление итогов или результатов работы других активити в комментарии;
Формирование истории обработки задачи для последующего анализа;
Автоматические напоминания ответственным сотрудникам.

Как работает активити (робот):
- Активити (робот) создаёт новый комментарий в указанной задаче;
- Комментарий создаётся от имени указанного пользователя;
- Поддерживается форматирование текста комментария;
- После успешного создания возвращается ID нового комментария;
- Активити (робот) работает через REST API Битрикс24 (task.commentitem.add);
- Пользователь, от имени которого создаётся комментарий, получит уведомление.

Сценарий работы робота

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

Название поля	Описание и примеры использования
ID задачи	Обязательное поле. В данном поле указывается идентификатор задачи, в которой будет создан комментарий. Примеры: - `123456` - создать комментарий в задаче с ID 123456; - `{=Variable:TASK_ID}` - использовать ID задачи из переменной; - `{=A1988_22222_92566_99999:task_id}` - использовать ID из результата предыдущего активити (робота); - `{=Document:ID}` - использовать ID текущего документа (если БП запущен из задачи).
ID пользователя	В данном поле указывается идентификатор пользователя, от имени которого будет создан комментарий. Примеры: - `1` - создать комментарий от пользователя с ID 1; - `user_25` - создать комментарий от пользователя с ID 25; - `{=Document:ASSIGNED_BY_ID}` - от имени ответственного текущей сущности; - `{=User:ID}` - от имени текущего пользователя.
Текст сообщения	В данном поле указывается текст комментария. Поддерживается BB-код для форматирования. Примеры: - `Задача выполнена успешно` - простой текстовый комментарий; - `Статус сделки изменён на: {=Variable:STAGE_NAME}` - с подстановкой переменной; - `[B]Важно![/B] Требуется проверка данных` - с форматированием BB-кодом; - `Результат обработки: {=A1988_22222_92566_99999:result}` - с результатом другого активити.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания	Время ожидания ответа от приложения. Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении указанного времени, то активити завершается.

Примеры использования:

№	Сценарий	ID задачи	ID пользователя	Текст сообщения
1	Уведомление о создании сделки	`{=Variable:TASK_ID}`	`1`	`Создана новая сделка №{=Document:ID}`
2	Логирование статуса	`123456`	`{=Document:ASSIGNED_BY_ID}`	`Статус изменён на: {=Variable:STATUS}`
3	Напоминание ответственному	`{=Variable:TASK_ID}`	`user_1`	`[B]Напоминание![/B] Срок задачи истекает завтра`
4	Отчёт о выполнении	`{=A1988_22222_92566_99999:task_id}`	`{=User:ID}`	`Обработано записей: {=Variable:COUNT}`
5	Информация о клиенте	`{=Variable:TASK_ID}`	`1`	`Клиент: {=Variable:CLIENT_NAME}, тел: {=Variable:PHONE}`
6	Результат проверки	`{=Variable:TASK_ID}`	`{=Document:CREATED_BY}`	`Проверка завершена. Результат: {=Variable:CHECK_RESULT}`
7	Уведомление об ошибке	`{=Variable:TASK_ID}`	`1`	`[COLOR=red]Ошибка![/COLOR] {=Variable:ERROR_MESSAGE}`
8	Информация о платеже	`{=Variable:TASK_ID}`	`{=Document:ASSIGNED_BY_ID}`	`Получен платёж на сумму: {=Variable:AMOUNT} руб.`
9	Результат интеграции	`{=Variable:TASK_ID}`	`user_1`	`Данные синхронизированы с внешней системой. ID: {=Variable:EXT_ID}`
10	Итоги дня	`{=Variable:TASK_ID}`	`1`	`Итоги за {=System:Date}: обработано {=Variable:COUNT} заявок`

Возвращаемые параметры для данного активити:

ID нового комментария (comment_id) - числовой идентификатор созданного комментария;
Успех операции (success) - результат выполнения операции (Y/N);
Сообщение об ошибке (error_message) - текст ошибки при неуспешном выполнении.

Важно:
- Пользователь, от имени которого создаётся комментарий, должен иметь права на добавление комментариев к указанной задаче;
- Все участники задачи получат уведомление о новом комментарии;
- Поддерживается форматирование текста с помощью BB-кодов ([B], [I], [U], [COLOR], [URL] и др.);
- Для добавления переноса строки используйте \n или создавайте текст через конструктор формул.

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

Создать комментарии в задаче