Эффективная интеграция и кастомизация функционала в Битрикс24 часто требует работы на уровне API. Сегодня мы подробно рассмотрим «Обновить комментарий task.commentitem.update». Вы узнаете экспертные методики работы с task.commentitem.update и научитесь избегать типичных ошибок начинающих разработчиков.

Обновить комментарий task.commentitem.update

> Scope: task
>
> Кто может выполнять метод: администратор

Метод task.commentitem.update обновляет комментарий.

Метод task.commentitem.update не работает в новой карточке задач, используйте метод im.message.update для работы с чатом задач.

Параметры метода

Передавайте параметры в запросе в соответствии с порядком в таблице. Если нарушить порядок, запрос вернет ошибку.

Параметр FIELDS {#fields}

Примеры кода

• cURL (Webhook)

    curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{"TASKID":8017,"ITEMID":3167,"FIELDS":{"POST_MESSAGE":"Комментарий обновлен","UF_FORUM_MESSAGE_DOC":["n4755"]}}' \
    https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/task.comm

- cURL (OAuth)

bash
curl -X POST \
-H «Content-Type: application/json» \
-H «Accept: application/json» \
-d ‘{«TASKID»:8017,»ITEMID»:3167,»FIELDS»:{«POST_MESSAGE»:»Комментарий обновлен»,»UF_FORUM_MESSAGE_DOC»:[«n4755″]},»auth»:»put_access_token_here«}’ \
https://put_your_bitrix24_address/rest/task.commentitem.update

- JS

js
try
{
const response = await $b24.callMethod(
‘task.commentitem.update’,
{
«TASKID»: 8017,
«ITEMID»: 3167,
«FIELDS»: {
«POST_MESSAGE»: «Комментарий обновлен»,
«UF_FORUM_MESSAGE_DOC»: [«n4755»]
}
}
);

const result = response.getData().result;
console.info(result);
console.log(result);
}
catch( error )
{
console.error(‘Error:’, error);
}

- PHP

php
try {
$response = $b24Service
->core
->call(
‘task.commentitem.update’,
[
‘TASKID’ => 8017,
‘ITEMID’ => 3167,
‘FIELDS’ => [
‘POST_MESSAGE’ => ‘Комментарий обновлен’,
‘UF_FORUM_MESSAGE_DOC’ => [‘n4755’],
],
]
);

$result = $response
->getResponseData()
->getResult();

echo ‘Success: ‘ . print_r($result, true);
// Нужная вам логика обработки данных
processData($result);

} catch (Throwable $e) {
error_log($e->getMessage());
echo ‘Error updating task comment: ‘ . $e->getMessage();
}

- BX24.js

js
BX24.callMethod(
‘task.commentitem.update’,
{
«TASKID»: 8017,
«ITEMID»: 3167,
«FIELDS»: {
«POST_MESSAGE»: «Комментарий обновлен»,
«UF_FORUM_MESSAGE_DOC»: [«n4755»]
}
},
function(result){
console.info(result.data());
console.log(result);
}
);

- PHP CRest

php
require_once(‘crest.php’);

$result = CRest::call(
‘task.commentitem.update’,
[
‘TASKID’ => 8017,
‘ITEMID’ => 3167,
‘FIELDS’ => [
‘POST_MESSAGE’ => ‘Комментарий обновлен’,
‘UF_FORUM_MESSAGE_DOC’ => [‘n4755’]
]
]
);

echo ‘

‘;

    print_r($result);

    echo ‘

## Обработка ответа

HTTP-статус: **200**

json
{
«result»: true,
«time»: {
«start»: 1753338761.030934,
«finish»: 1753338761.389114,
«duration»: 0.35817980766296387,
«processing»: 0.16595101356506348,
«date_start»: «2025-07-24T09:32:41+03:00»,
«date_finish»: «2025-07-24T09:32:41+03:00»,
«operating_reset_at»: 1753339361,
«operating»: 0.16593098640441895
}
}

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

#|
|| **Название**
`тип` | **Описание** ||
|| **result**
[`boolean`](../../data-types) | Возвращает `true` если комментарий обновлен успешно ||
|| **time**
[`time`](../../data-types.md#time) | Информация о времени выполнения запроса ||
|#

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

HTTP-статус: **400**

json
{
«error»:»ERROR_CODE»,
«error_description»:»Не указан текст комментария.
»
}

Возможные коды ошибок

• [](./index)
• [](./task-comment-item-add)
• [](./task-comment-item-get)
• [](./task-comment-item-get-list)
• [](./task-comment-item-delete)