Получение сообщений

GET/messages

Метод возвращает информацию о сообщении или массив сообщений из чата. Для выполнения запроса нужно указать один из параметров — chat_id или message_ids:

chat_id — метод возвращает массив сообщений из указанного чата. Сообщения возвращаются в обратном порядке: последние сообщения будут первыми в массиве
message_ids — метод возвращает информацию о запрошенных сообщениях. Можно указать один идентификатор или несколько

Пример запроса с использованием chat_id:

BASH

Скопировать

curl -X GET "https://platform-api.max.ru/messages?chat_id={chat_id}" \
  -H "Authorization: {access_token}"

Пример запроса с использованием message_ids:

BASH

Скопировать

curl -X GET "https://platform-api.max.ru/messages?message_ids={message_id1},{message_id2}" \
  -H "Authorization: {access_token}"

Авторизация

access_token
apiKey

Передача токена через query-параметры больше не поддерживается — используйте заголовок Authorization: <token>

Токен для вызова HTTP-запросов присваивается при создании бота — его можно найти в разделе платформы MAX для партнёров Чат-бот и мини-приложение → Настроить

Рекомендуем не разглашать токен посторонним, чтобы они не получили доступ к управлению ботом. Токен может быть отозван за нарушение Правил платформы

Параметры

chat_id
integer bigint <int64> optional

ID чата, чтобы получить сообщения из определённого чата. Обязательный параметр, если не указан message_ids

message_ids
object Nullable optional

Список ID сообщений, которые нужно получить (через запятую). Обязательный параметр, если не указан chat_id

from
integer bigint <int64> optional

Время начала для запрашиваемых сообщений (в формате Unix timestamp)

to
integer bigint <int64> optional

Время окончания для запрашиваемых сообщений (в формате Unix timestamp)

count
integer [1-100] optional

По умолчанию: 50

Максимальное количество сообщений в ответе

Результат

messages
Message[]

Массив сообщений