метод REST scope: imopenlines

imconnector.delete.messages

Удалить отправленные сообщения

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

Описание

Метод imconnector.delete.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"},
        "message": {"id": "ext-msg-1001"},
        "chat": {"id": "channel-123"}
      }
    ],
    "auth": "**put_access_token_here**"
  }' \
  https://**put_your_bitrix24_address**/rest/imconnector.delete.messages

Ответ

HTTP-статус: 200

{
    "result": {
        "SUCCESS": true,
        "DATA": {
            "RESULT": [
                {
                    "user": "585",
                    "message": {
                        "id": "ext-msg-1001"
                    },
                    "chat": {
                        "id": "channel-123"
                    },
                    "SUCCESS": true
                }
            ]
        }
    },
    "time": {
        "start": 1773267564,
        "finish": 1773267565.070724,
        "duration": 1.0707240104675293,
        "processing": 1,
        "date_start": "2026-03-11T14:19:24+03:00",
        "date_finish": "2026-03-11T14:19:25+03:00",
        "operating_reset_at": 1773268164,
        "operating": 0.113616943359375
    }
}

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

SUCCESS boolean

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

DATA object

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

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

time time

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

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

HTTP-статус: 400

{
    "error": "ERROR_ARGUMENT",
    "error_description": "Argument 'CONNECTOR' 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 Не удалось найти подходящий провайдер для коннектора

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

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