метод REST scope: task Устаревший

task.commentitem.add

Добавить комментарий

Устаревший метод. Развитие метода остановлено с версии модуля tasks 25.700.0. Используйте tasks.task.chat.message.send.

Кто может выполнять: любой пользователь с правом доступа на чтение задачи или выше

Описание

Метод task.commentitem.add добавляет новый комментарий к задаче.

Параметры

TASKID integer обязательный

Идентификатор задачи.

Идентификатор задачи можно получить при создании новой задачи или методом получения списка задач

FIELDS object обязательный

Параметр FIELDS

POST_MESSAGE string обязательный

Текст сообщения

AUTHOR_ID integer необязательный

Идентификатор пользователя, от имени которого нужно создать комментарий.

Получить идентификатор пользователя можно методом user.get.

Метод task.commentitem.add позволяет любому пользователю добавить комментарий от чужого имени

POST_DATE string необязательный

Дата сообщения

UF_FORUM_MESSAGE_DOC array необязательный

Массив с идентификаторами файлов с Диска. Перед каждым идентификатором укажите префикс n, например ['n123', 'n456', ... ].

У автора комментария должен быть доступ к прикрепляемым файлам, иначе метод вернет ошибку

Примеры запроса

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"TASKID":8017,"FIELDS":{"POST_MESSAGE":"Текст нового комментария к задаче","AUTHOR_ID":503,"POST_DATE":"2025-07-15T14:30:00+03:00","UF_FORUM_MESSAGE_DOC":["n4755","n4753"]}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/task.commentitem.add

Ответ

HTTP-статус: 200

{
    "result": 3141,
    "time": {
        "start": 1753262861.683775,
        "finish": 1753262862.001611,
        "duration": 0.31783604621887207,
        "processing": 0.27428317070007324,
        "date_start": "2025-07-23T12:27:41+03:00",
        "date_finish": "2025-07-23T12:27:42+03:00",
        "operating_reset_at": 1753263461,
        "operating": 0.2742629051208496
    }
}

Возвращаемые данные

result integer

Идентификатор нового комментария

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error":"ERROR_CODE",
    "error_description":"Недостаточно прав для добавления комментария.<br>"
}
Код Описание Значение
ERROR_CORE Не указан текст комментария Обязательный параметр POST_MESSAGE не передан или пустой
ERROR_CORE Недостаточно прав для добавления комментария Нет прав доступа к задаче
ERROR_CORE Не удалось найти файл Файл из параметра UF_FORUM_MESSAGE_DOC не найден или у автора нет к нему доступа
ERROR_CORE TASKS_ERROR_EXCEPTION_#256; Param #1 (arFields) for method ctaskcommentitem::add() must not contain key <FIELD_NAME>.; 256/TE/WRONG_ARGUMENTS Поле <FIELD_NAME> нельзя использовать в методе
ERROR_CORE TASKS_ERROR_EXCEPTION_#256; Param #0 (taskId) for method ctaskcommentitem::add() expected to be of type "integer", but given something else.; 256/TE/WRONG_ARGUMENTS Указан неверный тип значения для параметра, например, для TASKID

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.