История сессии

Эндпоинт включается платформой Вайбкод постепенно. Пока он не включён на платформе, вызов возвращает 403 OPENLINES_HISTORY_DISABLED — это признак того, что возможность ещё не активирована, а не ошибка интеграции.

POST /v1/openlines/sessions/history

Возвращает транскрипт последней сессии чата Открытой линии по его идентификатору: сообщения, участников и метаданные файлов одним ответом. Метод отдаёт содержимое переписки с клиентом, поэтому требует ключа со скоупом imopenlines и применяет модель прав Битрикс24.

Поля запроса (body)

Вход только по идентификатору чата. По нему платформа берёт последнюю сессию этого чата — то есть транскрипт текущего диалога. Идентификатор конкретной исторической сессии на вход не принимается.

Пагинации у метода нет: транскрипт возвращается целиком одним ответом. Для постраничного чтения сообщений чата используйте GET /v1/chats/:dialogId/messages.

Поля ответа

Примеры

curl — личный ключ

curl -X POST "https://vibecode.bitrix24.tech/v1/openlines/sessions/history" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "chatId": 2043 }'

Ответ

{
  "success": true,
  "data": {
    "sessionId": 607,
    "chatId": 2043,
    "messages": [
      {
        "id": 88101,
        "senderId": 0,
        "recipientId": 13,
        "date": "2026-08-14T10:12:33+03:00",
        "text": "Здравствуйте, не приходит счёт",
        "textLegacy": "Здравствуйте, не приходит счёт",
        "params": {}
      }
    ],
    "users": [
      { "id": 13, "name": "Анна Соколова", "firstName": "Анна", "lastName": "Соколова", "workPosition": "Оператор", "connector": false }
    ],
    "files": [],
    "chats": [
      { "dialogId": "chat2043", "entityType": "LINES" }
    ],
    "usersMessage": { "chat2043": ["88101"] }
  }
}

Ошибки