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

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

PUT/chats/{chatId}/pin

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

Бот, чей токен access_token используется для авторизации, должен быть администратором этого чата или канала

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

BASH
curl -X PUT "https://platform-api2.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 для бизнеса», получить токен можно там же или в боте «MAX для бизнеса» с помощью команды Получить токен

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

Параметры

chatId
integer <int64>\-?\d+
ID группового чата или канала, где нужно закрепить сообщение. Как получить ID — на странице «Получение ID чата или канала»

Тело запроса

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

notify
boolean Nullableoptional

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

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

HTTP-коды ответов

КодОписание
200Успешный или неуспешный результат
401Ошибка авторизации. Токен access_token указан некорректно или недействителен
403Ошибка доступа. У вас нет доступа к этому ресурсу
404Запрашиваемый ресурс не найден
500Внутренняя ошибка сервера

Подробнее о форматах ответа и кодах ошибок — на странице «Общее описание»

Результат

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

code
stringoptional
Код ошибки. Подробнее об ошибках API MAX — на странице «Общее описание»

message
stringoptional
Сообщение об ошибке