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

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

GET/messages/{messageId}

Возвращает сообщение из канала или чата по его ID

Пример запроса:

BASH

Скопировать

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

Авторизация

access_token
apiKey

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

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

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

Параметры

messageId
string
[a-zA-Z0-9_\-]+

ID сообщения (mid), чтобы получить одно сообщение в чате или канале

Результат

sender
object User optional

Отправитель сообщения: пользователь или бот

Обратите внимание:
- Все параметры в объекте относятся к отправителю сообщения
- Объект отсутствует, если сообщение отправлено в канал

recipient
object Recipient

Получатель сообщения: пользователь или бот (для диалога), канал или чат

Обратите внимание: все параметры в объекте относятся к получателю сообщения

timestamp
integer <int64>

Время создания сообщения в формате Unix timestamp в миллисекундах

link
object LinkedMessage Nullable optional

Пересланное или ответное сообщение

body
object MessageBody

Содержимое сообщения. Текст + вложения. Может быть null, если сообщение содержит только пересланное сообщение

stat
object MessageStat Nullable optional

Статистика просмотров постов — возвращается только для каналов

url
string Nullable optional

Публичная ссылка на пост в канале. Отсутствует для диалогов и групповых чатов