метод REST scope: imopenlines

imopenlines.message.session.start

Начать новый диалог на основании сообщения

Кто может выполнять: любой пользователь с правами на диалог

Описание

Метод imopenlines.message.session.start запускает новую сессию и переносит в нее указанное сообщение.

Параметры

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

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

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

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

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

Идентификатор можно получить методом imopenlines.session.history.get в ключах объекта message

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

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"CHAT_ID":2043,"MESSAGE_ID":18971}' \
  https://your-domain.bitrix24.ru/rest/1/webhook_key/imopenlines.message.session.start.json

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1773682918,
        "finish": 1773682919.022549,
        "duration": 1.0225489139556885,
        "processing": 1,
        "date_start": "2026-03-16T20:41:58+03:00",
        "date_finish": "2026-03-16T20:41:59+03:00",
        "operating_reset_at": 1773683518,
        "operating": 0.14626193046569824
    }
}

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

result boolean

Возвращает true, если новая сессия запущена на основании сообщения

time time

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

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

HTTP-статус: 400

{
    "error": "CHAT_ID",
    "error_description": "Указан не корректный идентификатор чата"
}
Код Описание Значение
400 CHAT_ID Указан не корректный идентификатор чата
400 CHAT_TYPE Указанный чат не является открытой линией
400 ACCESS_DENIED Вы не можете открыть этот разговор, т.к. у вас недостаточно прав
400 USER_ID Указан не корректный идентификатор пользователя

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

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