Блог Горошко Андрея Bitrix24,PHP Событие при добавлении комментария OnTaskCommentAdd

Событие при добавлении комментария OnTaskCommentAdd

Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «Событие при добавлении комментария OnTaskCommentAdd». Мы подготовили подробный разбор принципов работы и развернутые примеры интеграции.

Событие при добавлении комментария OnTaskCommentAdd

> Scope: task
>
> Кто может подписаться: любой пользователь

Событие срабатывает после добавления нового комментария к задаче.

События не будут отправляться в приложение, пока установка не завершена. Проверьте установку приложения

Что получает обработчик

Данные передаются в виде POST-запроса {.b24-info}

При работе со старой карточкой задачи до версии модуля tasks 25.700.0:

array(
    'event' => 'ONTASKCOMMENTADD',
    'data' => array(
        'FIELDS_BEFORE' => 'undefined',
        'FIELDS_AFTER' => array('ID' => 123, 'TASK_ID' => 555),
        '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.bitrix24.tech/rest/',
        'status' => 'F',
        'client_endpoint' => 'https://some-domain.bitrix24.com/rest/',
        'member_id' => 'a223c6b3710f85df22e9377d6c4f7553',
        'refresh_token' => '4s386p3q0tr8dy89xvmt96234v3dljg8',
        'application_token' => '51856fefc120afa4b628cc82d3935cce',
        ),
)

При работе с новой карточкой задачи с чатом с версии модуля tasks 25.700.0:

array(
    'event' => 'ONTASKCOMMENTADD',
    'data' => array(
        'FIELDS_BEFORE' => 'undefined',
        'FIELDS_AFTER' => array('ID' => 0, 'TASK_ID' => 555, 'MESSAGE_ID' => 1458),
        '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.bitrix24.tech/rest/',
        'status' => 'F',
        'client_endpoint' => 'https://some-domain.bitrix24.com/rest/',
        'member_id' => 'a223c6b3710f85df22e9377d6c4f7553',
        'refresh_token' => '4s386p3q0tr8dy89xvmt96234v3dljg8',
        'application_token' => '51856fefc120afa4b628cc82d3935cce',
        ),
)
Параметр
тип
Описание
event
string
Символьный код события, в данном случае OnTaskAdd
data
array
Массив с данными нового комментария задачи
ts
timestamp
Дата и время отправки события из очереди событий
auth
array
Параметры авторизации и данные о портале, на котором произошло событие

Параметр data[]

Название
тип
Описание
FIELDS_BEFORE
undefined\
objectПоля комментария и задачи до события (подробное описание приведено ниже). В случае отсутствия доступных полей задачи данное поле будет содержать значение undefined
FIELDS_AFTER
undefined\
objectПоля комментария и задачи после события (подробное описание приведено ниже). В случае отсутствия доступных полей задачи данное поле будет содержать значение undefined
IS_ACCESSIBLE_BEFORE
string
Была ли доступна задача на чтение до события (подробное описание приведено ниже)
IS_ACCESSIBLE_AFTER
string
Стала ли доступна задача на чтение после события (подробное описание приведено ниже)

Поле FIELDS_BEFORE {#fields_before}

Название
тип
Описание
ID
integer
Идентификатор созданного комментария. 'ID' => 0 возвращается при активной новой карточке задач с версии модуля tasks 25.700.0
TASK_ID
integer
Идентификатор задачи, к которой был добавлен комментарий
MESSAGE_ID
integer
Идентификатор отправленного сообщения в чат задачи, возвращается при активной новой карточке задач с версии модуля tasks 25.700.0

Поле FIELDS_AFTER {#fields_after}

Название
тип
Описание
ID
integer
Идентификатор созданного комментария. 'ID' => 0 возвращается при активной новой карточке задач с версии модуля tasks 25.700.0
TASK_ID
integer
Идентификатор задачи, к которой был добавлен комментарий
MESSAGE_ID
integer
Идентификатор отправленного сообщения в чат задачи, возвращается при активной новой карточке задач с версии модуля tasks 25.700.0

Поле IS_ACCESSIBLE_BEFORE {#is_accessible_before}

Название
тип
Описание
IS_ACCESSIBLE_BEFORE
string
Возможные значения:
— Y (Yes) — да
— N (No) — нет
— undefined — не определено или проверка не производилась

Поле IS_ACCESSIBLE_AFTER {#is_accessible_after}

Название
тип
Описание
IS_ACCESSIBLE_AFTER
string
Возможные значения:
— Y (Yes) — да
— N (No) — нет
— undefined — не определено или проверка не производилась

Примеры кода

  • JS
    try
    {
    	const response = await $b24.callMethod(
    		'event.bind',
    		{
    			"event": "OnTaskCommentAdd",
    			"handler": "https://example.com/handler.php"
    		}
    	);
    	
    	const result = response.getData().result;
    	console.info(result);
    }
    catch( error )
    {
    	console.error(error);
    }
  • PHP
    try {
        $response = $b24Service
            ->core
            ->call(
                'event.bind',
                [
                    'event'   => 'OnTaskCommentAdd',
                    'handler' => 'https://example.com/handler.php',
                ]
            );
    
        $result = $response
            ->getResponseData()
            ->getResult();
    
        echo 'Success: ' . print_r($result, true);
        // Нужная вам логика обработки данных
        processData($result);
    
    } catch (Throwable $e) {
        error_log($e->getMessage());
        echo 'Error binding event: ' . $e->getMessage();
    }
  • BX24.js
    BX24.callMethod(
        'event.bind',
        {
            "event": "OnTaskCommentAdd",
            "handler": "https://example.com/handler.php"
        },
        function(result) {
            if (result.error()) {
                console.error(result.error());
            } else {
                console.info(result.data());
            }
        }
    );
  • PHP CRest
    require_once('crest.php');

    $result = CRest::call(
        'event.bind',
        [
            'event' => 'OnTaskCommentAdd',
            'handler' => 'https://example.com/handler.php'
        ]
    );

    echo '<PRE>';
    print_r($result);
    echo '</PRE>';
  • [](./index)
  • [](./on-task-comment-update)
  • [](./on-task-comment-delete)

💡 Экспертное мнение и рекомендации

Советы эксперта по интеграции:

  • Всегда используйте кэширование при частых запросах к событие добавлении, чтобы разгрузить базу данных.
  • Соблюдайте стандарты PSR при написании обработчиков для «Событие при добавлении комментария OnTaskCommentAdd».
  • Регулярно проводите аудит производительности системы с помощью встроенного монитора 1С-Битрикс.

Похожая задача в бизнесе?

Помогу автоматизировать процессы и внедрить ИИ

Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.

Related Post

Получить поля типа плательщика sale.persontype.getFieldsПолучить поля типа плательщика sale.persontype.getFields

Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «Получить поля типа плательщика sale.persontype.getFields». Мы подготовили подробный разбор принципов работы и развернутые примеры интеграции.

Внедрение Битрикс24 для логистической и экспедиторской компанииВнедрение Битрикс24 для логистической и экспедиторской компании

Профессиональная настройка и внедрение Битрикс24 CRM позволяет систематизировать работу отдела продаж, исключить потерю лидов и автоматизировать ключевые бизнес-процессы компании. Услуга «Внедрение Битрикс24 для логистической и экспедиторской компании» обеспечивает учет маршрутов,

Внедрение Битрикс24 для юридической компании и адвокатского бюроВнедрение Битрикс24 для юридической компании и адвокатского бюро

Профессиональная настройка и комплексная автоматизация Битрикс24 CRM позволяет выстроить прозрачный отдел продаж, исключить потерю обращений и автоматизировать рутинный документооборот компании. Услуга «Внедрение Битрикс24 для юридической компании и адвокатского бюро» обеспечивает