Отправка комментария

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

POST/messages/{messageId}/comments

Функциональность временно недоступна

Отправляет комментарий к посту в канале

Для этого:

• В настройках канала должны быть включены комментарии
• Бот, чей токен access_token используется для авторизации, должен быть администратором этого канала c правами read_all_messages и write

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

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

BASH
Скопировать
curl -X GET "https://platform-api2.max.ru/messages/{messageId}/comments" \ -H "Authorization: {access_token}"

Авторизация

access_token
apiKey

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

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

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

Параметры

messageId
string
(mid.)?[a-zA-Z0-9_\-]+

Идентификатор сообщения (mid), к которому относится комментарий

disable_link_preview
boolean optional

Если false, сервер не будет генерировать предпросмотр для ссылок в тексте. Работает только для десктоп-клиента

Тело запроса

text
string Nullable

до 4000 символов

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

link
object NewMessageLink Nullable

Ссылка на комментарий

format
enum TextFormat Nullable optional

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

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

Результат

message
object CommentMessage

Комментарий в чате. Возвращается в ответ на запросы группы /comments. В отличие от обычного сообщения в чате или канале не содержит вложений attachments и не поддерживает пересылку комментариев (поле link.type = forward)

Коды ответов

КодОписание
200

Возвращает информацию о созданном комментарии

401

Ошибка авторизации. Токен access_token указан некорректно или недействителен

500

Внутренняя ошибка сервера