Удалить сообщение

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

DELETE/messages

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

Ограничения

Бот должен быть администратором и иметь право на удаление сообщений
Бот может удалять сообщения:
- в диалоге — только сообщения, отправленные самим ботом
- в групповом чате — любые сообщения
- в канале — любые сообщения
Можно удалять не более двух сообщений в секунду в одном диалоге, групповом чате или канале. При превышении этого лимита сообщения следует ставить в очередь или делать задержку перед удалением

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

BASH

Скопировать

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

Авторизация

access_token
apiKey

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

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

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

Параметры

message_id
string

от 1 символа

ID удаляемого сообщения

Результат

success
boolean

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

message
string optional

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