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

Для корректной работы ваших чат-ботов и мини-приложений направляйте запросы на домен platform-api2.max.ru вместо platform-api.max.ru. Также убедитесь, что добавили сертификат Минцифры в список доверенных

GET/messages

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

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

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

BASH

Скопировать

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

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

BASH

Скопировать

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

Авторизация

access_token
apiKey

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

Токен для вызова HTTP-запросов присваивается при создании бота — его можно найти на платформе в разделе Чат-боты → Перейти → Расширенные настройки → Настроить
Eсли вы верифицировали профиль и создали бота в мини-приложении «MAX для бизнеса», получить токен можно там же или в боте «MAX для бизнеса» с помощью команды Получить токен

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

Параметры

chat_id
integer bigint <int64> optional

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

message_ids
object 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[]

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