---
title: "Получить окно сообщений"
method: GET
path: "/api/v1/chat/conversations/{id}/messages"
tags: ["Chat"]
---

# Получить окно сообщений

`GET /api/v1/chat/conversations/{id}/messages`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/chat/conversations/{id}/messages`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Разрешён не более чем один cursor before_seq, after_seq или around_seq; items всегда по seq ASC. q ищет по тексту видимой истории и именам готовых проверенных вложений без изменения прочитанности; удалённые сообщения исключены. Все слова учитываются независимо от регистра, е/ё равнозначны. q нельзя совмещать с around_seq; поиск листается через before_seq или after_seq.

## Query parameters

- `q` string
- `before_seq` integer
- `after_seq` integer
- `around_seq` integer
- `limit` integer

## Response `200`

Окно сообщений

- ChatMessagePage
  - `items` ChatMessage[], required
    - `id` string, uuid, required
    - `conversation_id` string, uuid, required
    - `seq` integer, required
    - `sender_user_id` integer, nullable, required
    - `kind` 'text' | 'system' | 'application' | 'file', required
    - `body` string, required
    - `mentions` ChatMessageMention[], required
      - `user_id` integer, required
      - `display_name` string, required
    - `client_message_id` string, uuid, required
    - `created_at` string, date-time, required
    - `attachments` ChatAttachment[], required
      - `id` string, uuid, required
      - `original_name` string, required
      - `content_type` 'audio/mp4' | 'audio/webm' | 'audio/ogg' | 'video/mp4' | 'video/quicktime', required
      - `size_bytes` integer, required
      - `sha256_hex` string, required
      - `media_kind` 'voice' | 'video_circle', required
      - `duration_ms` integer, required
      - `content_url` string, required
    - `reply_to_message_id` string, uuid, nullable
    - `forwarded_from_message_id` string, uuid, nullable: Пересланное: исходное сообщение. Нет у обычных сообщений
    - `forwarded_from_user_id` integer: Пересланное: автор оригинала — участник кабинета (ERP-1964, «Переслано от …»). При пересылке пересланного — тот, кто написал первым. Нет у обычных и у старых пересланных сообщений
    - `forwarded_from_name` string: Пересланное: подпись автора оригинала, когда участника нет в справочнике людей, — имя под ответом поддержки или название исходной беседы. Нет у обычных и у старых пересланных сообщений
    - `reply_quote` string: Цитата части исходного сообщения; поля нет, когда ответ на сообщение целиком, исходное удалено или недоступно
    - `deleted_at` string, date-time, nullable: Надгробие: сообщение удалено у всех. Тела, вложений, упоминаний и реакций у него нет; показывать его в ленте не нужно
  - `first_seq` integer
  - `last_seq` integer

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/a99574d597cc?raw)