Редактирование комментария
Для корректной работы ваших чат-ботов и мини-приложений направляйте запросы на доменplatform-api2.max.ruвместоplatform-api.max.ru. Также убедитесь, что добавили сертификат Минцифры в список доверенных
PUT/messages/{messageId}/comments
Редактирует комментарий бота к посту в канале
Для этого бот, чей токен access_token используется для авторизации, должен быть участником этого канала
Отредактировать комментарий можно только в течение 26 ч с момента публикации. Если отправить запрос позже, вернётся HTTP-ответ 422 с кодом "code": "comments.timeout_exceeded" и описанием ошибки
Какие комментарии можно отредактировать, зависит от прав бота:
- Боту назначено право администратора
edit— может редактировать комментарии, опубликованные от имени канала - У бота нет права администратора
edit— может редактировать только свои комментарии
Если канал архивирован или в нём отключены комментарии, бот может редактировать старые комментарии, но не позднее 26 ч с момента публикации
Чтобы получить информацию о правах бота, используйте GET /chats/-chatId-/members/admins. Подробнее о правах — в описании POST /chats/{chatId}/members/admins
Пример запроса:
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": "Изменённый текст"
}'Авторизация
Передача токена через query-параметры больше не поддерживается — используйте заголовок
Authorization: <token>
Токен для вызова HTTP-запросов присваивается при создании бота — его можно найти на платформе в разделе Чат-боты. Выберите необходимого бота и нажмите ⋮ → Настройки → значок копирования справа от поля с токеном
Если вы верифицировали профиль и создали бота в мини-приложении «MAX для бизнеса», получить токен можно там же или в боте «MAX для бизнеса» с помощью команды Получить токен
Рекомендуем не разглашать токен посторонним, чтобы они не получили доступ к управлению ботом. Токен может быть отозван за нарушение Правил платформы
Параметры
mid), комментарий к которому вы хотите отредактировать
от 1 символа
Идентификатор редактируемого комментария
Тело запроса
до 4000 символов
Текст комментария
Возможные значения в enum: "forward" "reply"
Тип связанного сообщения:
"reply"— ответ на сообщение или комментарий в чате или канале"forward"— пересланное сообщение в чате или канале
Для комментариев поддерживается только тип reply
Возможные значения в enum: "markdown" "html"
Разметка текста комментария. Для комментариев не поддерживается упоминание других пользователей и гиперссылки. Подробнее — в разделе Форматирование
HTTP-коды ответов
| Код | Описание |
|---|---|
200 | Успешный или неуспешный результат |
401 | Ошибка авторизации. Токен access_token указан некорректно или недействителен |
500 | Внутренняя ошибка сервера |
Подробнее о форматах ответа и кодах ошибок — на странице «Общее описание»
Результат
true, если запрос был успешным, false — в противном случае