метод REST scope: imopenlines

imconnector.update.messages

Изменить отправленные сообщения

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

Описание

Метод imconnector.update.messages обновляет данные ранее переданных сообщений внешней системы в открытой линии.

Метод работает только в контексте приложения.

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

Для обновления передавайте те же message.id и chat.id, которые использовали при отправке сообщений методом imconnector.send.messages.

Параметры

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

Строковый код коннектора, который задали в параметре ID при вызове imconnector.register

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

Идентификатор открытой линии.

Идентификатор можно получить методами imopenlines.config.get и imopenlines.config.list.get

MESSAGES array обязательный

Массив сообщений для обновления. Каждый элемент массива — одно сообщение в формате объекта с тремя обязательными блоками: user, message, chat.

Структура объекта подробно описана ниже

Параметр MESSAGES

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

Данные пользователя внешней системы.

Структура объекта подробно описана ниже

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

Данные сообщения внешней системы.

Структура объекта подробно описана ниже

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

Данные чата внешней системы.

Структура объекта подробно описана ниже

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

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "CONNECTOR": "myconnector",
    "LINE": 107,
    "MESSAGES": [
      {
        "user": {
          "id": "ext-user-42",
          "last_name": "Иванов",
          "name": "Иван",
          "picture": {"url": "https://example.ru/u42.png"},
          "url": "https://example.ru/users/42",
          "gender": "male",
          "email": "ivan@example.ru",
          "phone": "+79990000000"
        },
        "message": {
          "id": "ext-msg-1001",
          "date": 1773266050,
          "text": "Добрый день, уточнили детали"
        },
        "chat": {
          "id": "channel-123",
          "name": "Канал поддержки",
          "url": "https://example.ru/chats/123"
        }
      }
    ],
    "auth": "**put_access_token_here**"
  }' \
  https://**put_your_bitrix24_address**/rest/imconnector.update.messages

Ответ

HTTP-статус: 200

{
    "result": {
        "SUCCESS": true,
        "DATA": {
            "RESULT": [
                {
                    "user": "585",
                    "message": {
                        "id": "ext-msg-1001",
                        "date": {},
                        "text": "Добрый день, уточнили детали"
                    },
                    "chat": {
                        "id": "channel-123",
                        "name": "Канал поддержки",
                        "description": "Ссылка на исходный пост: https://example.ru/chats/123"
                    },
                    "SUCCESS": true
                }
            ]
        }
    },
    "time": {
        "start": 1773322669,
        "finish": 1773322669.300999,
        "duration": 0.3009989261627197,
        "processing": 0,
        "date_start": "2026-03-12T16:37:49+03:00",
        "date_finish": "2026-03-12T16:37:49+03:00",
        "operating_reset_at": 1773323269,
        "operating": 0
    }
}

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

SUCCESS boolean

Возвращает true в случае успешного изменения сообщения

DATA object

Данные обработки сообщений.

Структура объекта подробно описана ниже

time time

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

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

HTTP-статус: 400

{
    "error": "ERROR_ARGUMENT",
    "error_description": "Argument 'LINE' is null or empty"
}
Код Описание Значение
403 WRONG_AUTH_TYPE Current authorization type is denied for this method Application context required
400 ERROR_ARGUMENT Argument 'CONNECTOR' is null or empty
400 ERROR_ARGUMENT Argument 'LINE' is null or empty
400 ERROR_ARGUMENT Argument 'MESSAGES' is null or empty
400 NOT_ACTIVE_LINE Линия c таким ID неактивна или не существует
400 IMCONNECTOR_NO_CORRECT_PROVIDER Не удалось найти подходящий провайдер для коннектора

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

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