

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

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

 Для этого: 

• В настройках канала должны быть [включены комментарии](/docs/channels/manage#Как%20включить%20комментарии%20в%20канале)
• Бот, чей токен `access_token` используется для авторизации, должен быть администратором этого канала c правами `read_all_messages` и `write`

 Чтобы получить информацию о правах бота, используйте [`GET /chats/-chatId-/members/admins`](/docs-api/methods/GET/chats/-chatId-/members/admins). Подробнее о правах — в описании [`GET /chats/{chatId}/members/admins`](/docs-api/methods/POST/chats/-chatId-/members/admins#Доступные%20права%20администратора) 

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

curl -X POST "https://platform-api2.max.ru/messages/{messageId}/comments" \
  -H "Authorization: {access_token}"

## Авторизация

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

Токен для вызова HTTP-запросов присваивается при создании бота — его можно найти на [платформе](https://business.max.ru/self) в разделе **Чат-боты**. Выберите необходимого бота и нажмите **⋮** → **Настройки** → значок копирования справа от поля с токеном

Если вы верифицировали профиль и создали бота в [мини-приложении «MAX для бизнеса»](https://max.ru/business_bot?startapp), получить токен можно там же или в [боте «MAX для бизнеса»](https://max.ru/business_bot) с помощью команды **Получить токен**

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

## Параметры

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

## Тело запроса

до `4000` символов

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

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

Тип связанного сообщения:
  - `"reply"` — ответ на сообщение или комментарий в чате или канале
- `"forward"` — пересланное сообщение в чате или канале

 **Для комментариев поддерживается только тип `reply`**
ID исходного сообщения

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

Разметка текста комментария. Для комментариев не поддерживается упоминание других пользователей и гиперссылки. Подробнее — в разделе [Форматирование](/docs-api#Форматирование%20текста%20в%20сообщениях)

## Результат

Комментарий в чате. Возвращается в ответ на запросы группы [`/comments`](/docs-api/methods/GET/messages/-messageId-/comments). В отличие от обычного сообщения в чате или канале не содержит вложений `attachments` и не поддерживает пересылку комментариев (поле `link.type = forward`)

Пользователь, отправивший комментарий. Может быть `null`, если сообщение было опубликовано от имени канала

Идентификатор пользователя или бота
Отображаемое имя пользователя или бота
Отображаемая фамилия пользователя. Для ботов это поле не возвращается
Никнейм бота или уникальное публичное имя пользователя. В случае с пользователем может быть `null`, если тот недоступен или имя не задано
`true`, если это бот
Время последней активности пользователя или бота в MAX (Unix timestamp в миллисекундах). Если пользователь отключил в настройках профиля мессенджера MAX возможность видеть, что он в сети онлайн, поле может не возвращаться
_Устаревшее поле, скоро будет удалено_

Получатель сообщения: для комментариев — канал

ID чата или канала. Как получить ID — в [разделе «Получение chat_id»](/docs-api#Получение%20chat_id)
Возможные значения в enum: `"chat"` `"channel"` `"dialog"`

Тип чата:
 - `chat` — групповой чат
 - `channel` — канал или комментарий к посту (для вызовов методов группы `/comments`)
 - `dialog` — диалог
ID получателя сообщения в диалоге (пользователя или бота). Если сообщение отправлено в групповой чат или канал, то параметр отсутствует
Идентификатор поста в канале, к которому оставлен комментарий

Время создания сообщения в формате Unix timestamp в миллисекундах
Комментарий, на который получен ответ

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

Тип связанного сообщения:
  - `"reply"` — ответ на сообщение или комментарий в чате или канале
- `"forward"` — пересланное сообщение в чате или канале

 **Для комментариев поддерживается только тип `reply`**
Пользователь или бот, отправивший комментарий

Идентификатор пользователя или бота
Отображаемое имя пользователя или бота
Отображаемая фамилия пользователя. Для ботов это поле не возвращается
Никнейм бота или уникальное публичное имя пользователя. В случае с пользователем может быть `null`, если тот недоступен или имя не задано
`true`, если это бот
Время последней активности пользователя или бота в MAX (Unix timestamp в миллисекундах). Если пользователь отключил в настройках профиля мессенджера MAX возможность видеть, что он в сети онлайн, поле может не возвращаться
_Устаревшее поле, скоро будет удалено_

Чат или канал, в котором сообщение было изначально опубликовано. Только для пересланных сообщений с `type = forward`. Как получить ID — в [разделе «Получение chat_id»](/docs-api#Получение%20chat_id)
Информация о комментарии

Уникальный ID комментария
Порядковый номер расположения комментария в посте
Текст комментария
Разметка текста комментария. Подробнее — в разделе [Форматирование](/docs-api#Форматирование%20текста%20в%20сообщениях)

**Обратите внимание**: в тексте комментариев не поддерживаются гиперссылки и упоминание пользователя

Тип элемента разметки. Может быть **жирный**,  *курсив*, ~зачеркнутый~, подчеркнутый, `моноширинный`, выделенный, цитата, заголовок, ссылка или упоминание пользователя

**Обратите внимание**: в тексте комментариев не поддерживаются гиперссылки и упоминание пользователей
Индекс начала элемента разметки в тексте. Нумерация с нуля
Длина элемента разметки в символах

Информация о комментарии

Уникальный ID комментария
Порядковый номер расположения комментария в посте
Текст комментария
Разметка текста комментария. Подробнее — в разделе [Форматирование](/docs-api#Форматирование%20текста%20в%20сообщениях)

**Обратите внимание**: в тексте комментариев не поддерживаются гиперссылки и упоминание пользователя

Тип элемента разметки. Может быть **жирный**,  *курсив*, ~зачеркнутый~, подчеркнутый, `моноширинный`, выделенный, цитата, заголовок, ссылка или упоминание пользователя

**Обратите внимание**: в тексте комментариев не поддерживаются гиперссылки и упоминание пользователей
Индекс начала элемента разметки в тексте. Нумерация с нуля
Длина элемента разметки в символах

## Коды ответов

| Код | Описание |
| --- | --- |
| `200` | Возвращает информацию о созданном комментарии |
| `401` | Ошибка авторизации. Токен `access_token` указан некорректно или недействителен |
| `500` | Внутренняя ошибка сервера |

