метод REST scope: im

im.message.update

Изменить сообщение

Кто может выполнять: автор сообщения

Описание

Метод im.message.update изменяет текст и параметры уже отправленного сообщения.

Параметры

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

Идентификатор сообщения.

Идентификатор возвращает метод im.message.add

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

Новый текст сообщения. Если передать пустое значение, сообщение будет удалено.

Если параметр не передан, текст сообщения не изменится

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

Вложение с блоками контента: изображения, ссылки, файлы. Чтобы удалить вложение, передайте N или пустое значение.

Подробнее читайте в разделе Вложения

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

Кнопки под сообщением, с которыми может взаимодействовать пользователь. Чтобы отключить вывод кнопок, передайте N или пустое значение.

Подробнее читайте в статье Работа с клавиатурами

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

Дополнительные пункты в контекстном меню чата. Чтобы отключить показ дополнительных пунктов меню, передайте N или пустое значение.

Подробнее читайте в статье Контекстное меню

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

Преобразование ссылок в rich-ссылки.

Допустимые значения:
- Y — включено
- N — выключено

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

Флаг отметки «изменено»:
- Y — отметить
- N — не отмечать

По умолчанию — Y

Параметр применяется при обновлении ATTACH. При изменении MESSAGE метка «изменено» может появиться даже если передан IS_EDITED = 'N'

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"MESSAGE_ID":34239,"MESSAGE":"Обновленный текст","KEYBOARD":"N"}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/im.message.update

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1772623160,
        "finish": 1772623160.616113,
        "duration": 0.6161129474639893,
        "processing": 0,
        "date_start": "2026-03-04T14:19:20+03:00",
        "date_finish": "2026-03-04T14:19:20+03:00",
        "operating_reset_at": 1772623760,
        "operating": 0
    }
}

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

result boolean

true, если сообщение обновлено

time time

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

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

HTTP-статус: 400

{
    "error": "MESSAGE_ID_ERROR",
    "error_description": "Message ID can't be empty"
}
Код Описание Значение
MESSAGE_ID_ERROR Message ID can't be empty Не передан или некорректен MESSAGE_ID
CANT_EDIT_MESSAGE Time has expired for modification or you don't have access Нет прав на редактирование сообщения или истек срок изменения
ATTACH_ERROR Incorrect attach params Невалидный объект ATTACH
ATTACH_OVERSIZE You have exceeded the maximum allowable size of attach Размер ATTACH превышает допустимый
KEYBOARD_ERROR Incorrect keyboard params Невалидный объект KEYBOARD
KEYBOARD_OVERSIZE You have exceeded the maximum allowable size of keyboard Размер KEYBOARD превышает допустимый
menu_ERROR Incorrect menu params Невалидный объект MENU
MENU_OVERSIZE You have exceeded the maximum allowable size of menu Размер MENU превышает допустимый

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

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