Редактирование сообщений
Для корректной работы ваших чат-ботов и мини-приложений направляйте запросы на доменplatform-api2.max.ruвместоplatform-api.max.ru. Также убедитесь, что добавили сертификат Минцифры в список доверенных
PUT/messages
Редактирует сообщения и посты, отправленные ботом
Ограничения
-
Есть особенности редактирования сообщений в диалогах с ботом, связанные со сроком давности:
-
сообщения с кнопками
inline_keyboardредактируются независимо от срока давности -
остальные сообщения редактируются, если они отправлены менее 7 суток назад
-
-
В групповых чатах и каналах любые сообщения редактируются независимо от срока давности
-
Можно редактировать не более двух сообщений в секунду в одном диалоге, групповом чате или канале. При превышении этого лимита сообщения следует ставить в очередь или делать задержку перед редактированием
Пример запроса:
curl -X PUT "https://platform-api2.max.ru/messages?message_id=message_id" \
-H "Authorization: {access_token}" \
-H "Content-Type: application/json" \
-d '{
"text": "**Новый текст**",
"attachments": [
{
"type": "inline_keyboard",
"payload": {
"buttons": [
[
{
"type": "link",
"text": "Откройте сайт",
"url": "https://example.com"
}
]
]
}
}
],
"link": {
"type": "reply",
"mid": "mid.message_id"
},
"notify": false,
"format": "markdown"
}
}'Авторизация
Передача токена через query-параметры больше не поддерживается — используйте заголовок
Authorization: <token>
Токен для вызова HTTP-запросов присваивается при создании бота — его можно найти на платформе в разделе Чат-боты. Выберите необходимого бота и нажмите ⋮ → Настройки → значок копирования справа от поля с токеном
Если вы верифицировали профиль и создали бота в мини-приложении «MAX для бизнеса», получить токен можно там же или в боте «MAX для бизнеса» с помощью команды Получить токен
Рекомендуем не разглашать токен посторонним, чтобы они не получили доступ к управлению ботом. Токен может быть отозван за нарушение Правил платформы
Параметры
от 1 символа
ID редактируемого сообщения
Тело запроса
4000 символов
null, изменений не произойдёт. Если массив пуст, все вложения будут удалены
type: video) и одно вложение с кнопками (type: inline_keyboard). Общее количество вложений не должно превышать общее ограничение — 12. Подробнее — в примерах
от 1 символа
Любой внешний URL изображения, которое вы хотите прикрепить
retval. Подробнее — в описании POST /uploads
retval. Подробнее — в описании POST /uploads
type: inline_keyboard). Передача других типов вложений совместно с контактом не поддерживается
Данные для прикрепления кнопок к сообщению Ограничения:
- Максимальное количество кнопок в ряду — 7
- Максимальное количество строк с кнопками — 30
- Если в ряду кнопки с типами:
link,open_app,request_geo_location,request_contact, то максимальное количество кнопок в ряду — три
от 1 символа
Двумерный массив кнопок. Подробнее о типах кнопок и клавиатуре в ботах — в разделе «Клавиатура для чат-бота»
от 1 до 128 символов
Видимый текст кнопки. Чтобы он отображался полностью, рекомендуем не превышать заданное количество символов в зависимости от размещения текста: 20 символов — при одной кнопке в ряду, 10 — при двух, 5 — при трёх, 3 — при четырёх
до 1024 символов
Токен кнопки
2048 символов
true, отправляет местоположение без запроса подтверждения пользователя
Если false, возвращает модальное окно с дополнительным уточнением об отправке местоположения
до 1024 символов
Текст, который будет скопирован
от 1 символа
URL, прикреплённый к сообщению для предпросмотра медиавложения
Возможные значения в enum: "forward" "reply"
Тип связанного сообщения:
"reply"— ответ на сообщение или комментарий в чате или канале"forward"— пересланное сообщение в чате или канале
Для комментариев поддерживается только тип reply
По умолчанию: true
Для каналов всегда отправляйте запрос с notify = true или без этого поля. Отключить push-уведомления в каналах нельзя
В групповых чатах и диалогах, если notify = true или поле отсутствует, уведомление отобразится пользователю
При notify = false отображение push-уведомлений зависит от платформы:
- Десктоп-клиент и веб-приложение на iOS. В диалогах и групповых чатах при
notify = falseуведомления не отображаются - Приложение на Android. В диалогах при
notify = falseуведомления не отображаются. В групповых чатах приnotify = falseуведомление не отображаются, только если приложение МАХ свёрнуто или закрыто. Если приложение открыто, пользователь увидит уведомление - Веб-приложение. Управление отображением уведомлений с помощью параметра
notifyне поддержано
Возможные значения в enum: "markdown" "html"
Разметка текста сообщения. Подробнее — в разделе Форматирование
HTTP-коды ответов
| Код | Описание |
|---|---|
200 | Успешный или неуспешный результат |
401 | Ошибка авторизации. Токен access_token указан некорректно или недействителен |
500 | Внутренняя ошибка сервера |
Подробнее о форматах ответа и кодах ошибок — на странице «Общее описание»
Результат
true, если запрос был успешным, false — в противном случае