Редактирование сообщений

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

PUT/messages

Редактирует сообщения и посты, отправленные ботом

Ограничения

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

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

BASH

Скопировать

curl -X PUT "https://platform-api2.max.ru/messages?message_id=message_id" \
  -H "Authorization: {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
  "text": "Изменённый текст"
}'

Авторизация

access_token
apiKey

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

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

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

Параметры

message_id
string

от 1 символа

ID редактируемого сообщения

Тело запроса

text
string Nullable

до 4000 символов

attachments
AttachmentRequest[] Nullable

Вложения сообщения. Если поле равно null, изменений не произойдет. Если массив пуст, все вложения будут удалены

link
object NewMessageLink Nullable

Ссылка на сообщение

notify
boolean optional

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

Если false, участники чата не получат push-уведомления. Для каналов необходимо отправлять запрос с notify = true или без этого поля, т.к. каналы не подразумевают отправку постов без push-уведомлений

format
enum TextFormat Nullable optional

Возможные значения в enum: "markdown" "html"

Если установлен, текст сообщения будет форматирован данным способом. Для подробной информации загляните в раздел Форматирование

Результат

success
boolean

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

message
string optional

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

Коды ответов

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