Редактирование комментария

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

PUT/messages/{messageId}/comments

Редактирует комментарий бота к посту в канале

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

Отредактировать комментарий можно только в течение 26 ч с момента публикации. Если отправить запрос позже, вернётся HTTP-ответ 422 с кодом "code": "comments.timeout_exceeded" и описанием ошибки

Какие комментарии можно отредактировать, зависит от прав бота:

Если канал архивирован или в нём отключены комментарии, бот может редактировать старые комментарии, но не позднее 26 ч с момента публикации

Чтобы получить информацию о правах бота, используйте GET /chats/-chatId-/members/admins. Подробнее о правах — в описании POST /chats/{chatId}/members/admins

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

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

Авторизация

access_token
apiKey

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

Токен для вызова HTTP-запросов присваивается при создании бота — его можно найти на платформе в разделе Чат-боты. Выберите необходимого бота и нажмите ⋮ → Настройки → значок копирования справа от поля с токеном

Если вы верифицировали профиль и создали бота в мини-приложении «MAX для бизнеса», получить токен можно там же или в боте «MAX для бизнеса» с помощью команды Получить токен

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

Параметры

messageId
string(mid.)?[a-zA-Z0-9_\-]+
Идентификатор поста (mid), комментарий к которому вы хотите отредактировать

comment_id
string

от 1 символа

Идентификатор редактируемого комментария

Тело запроса

text
string Nullable

до 4000 символов

Текст комментария

link
object NewMessageLink Nullable
Ссылка на комментарий

type
enum MessageLinkType

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

Тип связанного сообщения:

  • "reply" — ответ на сообщение или комментарий в чате или канале
  • "forward" — пересланное сообщение в чате или канале

Для комментариев поддерживается только тип reply

mid
string
ID исходного сообщения

format
enum TextFormat Nullableoptional

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

Разметка текста комментария. Для комментариев не поддерживается упоминание других пользователей и гиперссылки. Подробнее — в разделе Форматирование

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

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

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

Результат

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

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

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