Список сообщений чата

Метод для получения списка сообщений бесед, каналов, тредов и личных сообщений.

Для получения сообщений вам необходимо знать chat_id требуемой беседы, канала, треда или диалога, и указать его в URL запроса. Сообщения будут возвращены в порядке убывания даты отправки (то есть, сначала будут идти последние сообщения чата). Для получения более ранних сообщений чата доступны параметры per и page.

get /messages получение списка сообщений чата
Запрос
chat_id integer* Идентификатор чата (беседа, канал, диалог или чат треда)
per integer Количество возвращаемых сущностей за один запрос (по умолчанию 25, максимум 50)
page integer Страница выборки (по умолчанию 1)
Ответ
data array of objects Массив списка сообщений
id integer Идентификатор сообщения
entity_type string Тип сущности, к которой относится сообщение: беседа/канал (discussion), тред (thread) или пользователь (user)
entity_id integer Идентификатор сущности, к которой относится сообщение (беседы/канала, треда или пользователя)
chat_id integer Идентификатор чата, в котором находится сообщение
content string Текст сообщения
user_id integer Идентификатор пользователя, создавшего сообщение
created_at string Дата и время создания сообщения (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ
files array of objects Прикреплённые файлы
id integer Идентификатор файла
key string Путь к файлу
name string Название файла
file_type string Тип файла: файл (file), изображение (image)
url string Прямая временная ссылка на скачивание файла
thread object или null Тред сообщения. Возвращается как null, если у сообщения нет комментариев.
id integer Идентификатор треда
chat_id integer Идентификатор чата треда (используется для отправки новых комментариев в тред и получения списка комментариев)
parent_message_id integer или null Идентификатор сообщения, к которому написан ответ. Возвращается как null, если сообщение не является ответом.
Возможные ошибки запроса (errors code)
blank Поле не может быть пустым
exclusion Поле имеет недопустимое значение
not_found Не удалось найти
Тело запроса отсутствует, параметры передаются в URL (например, /messages?chat_id=198&per=3)
{
  "data": [
    {
      "id": 1194277,
      "entity_type": "discussion",
      "entity_id": 198,
      "chat_id": 198,
      "content": "Это сообщение тоже попадёт в экспорт",
      "user_id": 12,
      "created_at": "2023-09-18T13:43:32.000Z",
      "files": [],
      "thread": {
        "id": 2633,
        "chat_id": 44997
      },
      "parent_message_id": null
    },
    {
      "id": 1194276,
      "entity_type": "discussion",
      "entity_id": 198,
      "chat_id": 198,
      "content": "**Andrew** добавил **Export bot** в беседу",
      "user_id": 12,
      "created_at": "2023-09-18T13:43:27.000Z",
      "files": [],
      "thread": null,
      "parent_message_id": null
    },
    {
      "id": 1194275,
      "entity_type": "discussion",
      "entity_id": 198,
      "chat_id": 198,
      "content": "**Andrew** создал беседу",
      "user_id": 12,
      "created_at": "2023-09-18T13:43:19.000Z",
      "files": [],
      "thread": null,
      "parent_message_id": null
    }
  ]
}