Event on Comment Update OnTaskCommentUpdate
If you are developing integrations for Bitrix24 using AI tools (Codex, Claude Code, Cursor), connect to the MCP server so that the assistant can utilize the official REST documentation.
Scope:
taskWho can subscribe: any user
The event triggers after a comment is updated in a task.
Events will not be sent to the application until the installation is complete. Check the application installation
What the Handler Receives
Data is transmitted as a POST request
When working with the old task detail form prior to module version tasks 25.700.0:
array(
'event' => 'ONTASKCOMMENTUPDATE',
'data' => array(
'FIELDS_BEFORE' => array('ID' => 123, 'TASK_ID' => 555),
'FIELDS_AFTER' => array('ID' => 123, 'TASK_ID' => 555, 'ACTION' => 'EDIT'),
'IS_ACCESSIBLE_BEFORE' => 'undefined',
'IS_ACCESSIBLE_AFTER' => 'undefined',
),
'ts' => '1466439714',
'auth' => array(
'access_token' => 's6p6eclrvim6da22ft9ch94ekreb52lv',
'expires_in' => '3600',
'scope' => 'crm',
'domain' => 'some-domain.bitrix24.com',
'server_endpoint' => 'https://oauth.bitrix.info/rest/',
'status' => 'F',
'client_endpoint' => 'https://some-domain.bitrix24.com/rest/',
'member_id' => 'a223c6b3710f85df22e9377d6c4f7553',
'refresh_token' => '4s386p3q0tr8dy89xvmt96234v3dljg8',
'application_token' => '51856fefc120afa4b628cc82d3935cce',
),
)
When working with the new task detail form with chat from module version tasks 25.700.0, the event does not work.
Required parameters are marked with *
|
Parameter |
Description |
|
event* |
Symbolic code of the event, in this case |
|
data* |
Array with task comment data |
|
ts* |
Date and time of the event sent from the event queue |
|
auth* |
Authorization parameters and information about the account where the event occurred |
Parameter data[]
Required parameters are marked with *
|
Name |
Description |
|
FIELDS_BEFORE* |
Fields of the comment and task before the event (detailed description provided below). If there are no available task fields, this field will contain the value |
|
FIELDS_AFTER* |
Fields of the comment and task after the event (detailed description provided below). If there are no available task fields, this field will contain the value |
|
IS_ACCESSIBLE_BEFORE* |
Whether the task was readable before the event (detailed description provided below) |
|
IS_ACCESSIBLE_AFTER* |
Whether the task became readable after the event (detailed description provided below) |
Field FIELDS_BEFORE
Required parameters are marked with *
|
Name |
Description |
|
ID* |
Identifier of the updated comment |
|
TASK_ID* |
Identifier of the task to which the comment belongs |
Field FIELDS_AFTER
Required parameters are marked with *
|
Name |
Description |
|
ID* |
Identifier of the updated comment |
|
TASK_ID* |
Identifier of the task to which the comment belongs |
|
ACTION* |
Action, which will always be |
Field IS_ACCESSIBLE_BEFORE
Required parameters are marked with *
|
Name |
Description |
|
IS_ACCESSIBLE_BEFORE* |
Possible values:
|
Field IS_ACCESSIBLE_AFTER
Required parameters are marked with *
|
Name |
Description |
|
IS_ACCESSIBLE_AFTER* |
Possible values:
|
Code Examples
How to Use Examples in Documentation
// This snippet is an ES module: top-level await requires type="module" or a bundler.
// $b24 is an already-initialized SDK instance (see the SDK "Get started" guide).
import { Text } from '@bitrix24/b24jssdk'
import type { B24Frame } from '@bitrix24/b24jssdk'
declare const $b24: B24Frame
// Shape of the payload returned in result (event.bind returns true on success)
type BindEventResult = boolean
try {
const response = await $b24.actions.v2.call.make<BindEventResult>({
method: 'event.bind',
params: {
event: 'OnTaskCommentUpdate',
handler: 'https://example.com/handler.php',
},
requestId: Text.getUuidRfc4122()
})
// The payload is available only on a successful response
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
} else {
const result = response.getData()!.result
console.info('Event bound successfully:', result)
}
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
<!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
<script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
<script>
async function bindOnTaskCommentUpdate() {
try {
// Initialize the SDK inside a Bitrix24 frame
const $b24 = await B24Js.initializeB24Frame()
const response = await $b24.actions.v2.call.make({
method: 'event.bind',
params: {
event: 'OnTaskCommentUpdate',
handler: 'https://example.com/handler.php',
},
requestId: B24Js.Text.getUuidRfc4122()
})
// The payload is available only on a successful response
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
return
}
const result = response.getData().result
console.info('Event bound successfully:', result)
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
}
document.addEventListener('DOMContentLoaded', bindOnTaskCommentUpdate)
</script>
try {
$response = $b24Service
->core
->call(
'event.bind',
[
'event' => 'OnTaskCommentUpdate',
'handler' => 'https://example.com/handler.php',
]
);
$result = $response
->getResponseData()
->getResult();
echo 'Success: ' . print_r($result, true);
// Your logic for processing data
processData($result);
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error binding event: ' . $e->getMessage();
}
BX24.callMethod(
'event.bind',
{
"event": "OnTaskCommentUpdate",
"handler": "https://example.com/handler.php"
},
function(result) {
if (result.error()) {
console.error(result.error());
} else {
console.info(result.data());
}
}
);
require_once('crest.php');
$result = CRest::call(
'event.bind',
[
'event' => 'OnTaskCommentUpdate',
'handler' => 'https://example.com/handler.php'
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';