метод REST scope: crm

crm.timeline.comment.update

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

Кто может выполнять: любой пользователь

Описание

Метод обновляет дело типа «Комментарий» в таймлайне.

Параметры

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

Целочисленный идентификатор дела типа «Комментарий» (например, 1). Получить идентификаторы можно методом crm.timeline.comment.list

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

Значения полей (подробное описание приведено ниже) для обновления дела типа «Комментарий» в виде структуры:

fields:
{
    "COMMENT": "значение",
    "FILES": [
        [
            "название файла", 
            "файл"
        ],
        [
            "название файла",
            "фафйл"
        ],
    ]
}

С версии crm 23.100.0 принимаются только параметры с ключом fields в нижнем регистре. Другие недокументированные варианты (Fields, FIELDS, arFields) не принимаются.

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

Целочисленный идентификатор типа объекта CRM, к которому привязан комментарий (например, 2 для сделки)

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

Целочисленный идентификатор элемента CRM, к которому привязан комментарий (например, 1). Получить список идентификаторов можно методом crm.timeline.bindings.list (поле ENTITY_ID)

Параметр fields

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

Текст комментария

FILES attached_diskfile необязательный

Список файлов. Массив значений, описанный по правилам

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":999,"fields":{"COMMENT":"Comment was changed","FILES":[["1.gif","R0lGODlhAQABAIAAAP///wAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw=="],["2.gif","R0lGODlhAQABAIAAAP///wAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw=="]]}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.timeline.comment.update

Ответ

HTTP-статус: 200

{
    "result": 999,
    "time": {
        "start": 1715091541.642592,
        "finish": 1715091541.730599,
        "duration": 0.08800697326660156,
        "date_start": "2024-05-03T17:19:01+03:00",
        "date_finish": "2024-05-03T17:19:01+03:00",
        "operating": 0
    }
}

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

result integer

Возвращает целочисленный идентификатор обновлённого комментария

time time

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

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

HTTP-статус: 400

{
    "error": "NOT_FOUND",
    "error_description": "Not found."
}
Код Описание Значение
OWNER_NOT_FOUND Владелец элемента не найден
ACCESS_DENIED Недостаточно прав
NOT_FOUND Элемент не найден
INVALID_ARG_VALUE Пустой коментарий
100 Не переданы обязательные поля

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

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