Закрепление сообщения

PUT/chats/{chatId}/pin

Закрепляет сообщение в чате

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

BASH

Скопировать

curl -X PUT "https://platform-api.max.ru/chats/{chatId}/pin" \
  -H "Authorization: {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
  "message_id": "{message_id}",
  "notify": true
}'

Авторизация

access_token
apiKey

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

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

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

Параметры

chatId
integer <int64>
\-?\d+

ID чата, где должно быть закреплено сообщение

Тело запроса

message_id
string

ID сообщения, которое нужно закрепить. Соответствует полю Message.body.mid

notify
boolean Nullable optional

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

Если true, участники получат уведомление с системным сообщением о закреплении

Результат

success
boolean

true, если запрос был успешным, false в противном случае

message
string optional

Объяснительное сообщение, если результат не был успешным