

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

Отправляет ответ после того, как пользователь нажал на кнопку. Ответом может быть обновленное сообщение и/или одноразовое уведомление для пользователя

#### Ограничения

Можно отправлять не более двух ответов в секунду в один диалог, групповой чат или канал. При превышении этого лимита сообщения следует ставить в очередь или делать задержку перед отправкой

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

curl -X POST "https://platform-api2.max.ru/answers?callback_id=callback_id" \
  -H "Authorization: {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "message": {
      "text": "Это сообщение с кнопкой-ссылкой",
      "attachments": [
        {
          "type": "inline_keyboard",
          "payload": {
            "buttons": [
              [
                {
                  "type": "link",
                  "text": "Откройте сайт",
                  "url": "https://example.com"
                }
              ]
            ]
          }
        }
      ]
    }
  }'

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

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

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

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

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

## Параметры

от `1` символа

Идентификатор кнопки, на которую нажал пользователь

 Идентификатор можно получить в обновлениях о событиях через [Webhook](/docs-api/methods/POST/subscriptions) или [Long Polling](/docs-api/methods/GET/updates)

 Получение обновлений с помощью [Long Polling](/docs-api/methods/GET/updates) ограничено по скорости и сроку хранения событий — этот способ не подходит для production-окружения. Рекомендуем на всех этапах работы использовать [Webhook](/docs-api/methods/POST/subscriptions)

 Когда пользователь нажмёт на кнопку, MAX отправит событие, содержащее объект [Update](/docs-api/objects/Update) с типом `message_callback` и идентификатором кнопки в поле `updates[i].callback.callback_id`
Если `true`, сервер не будет генерировать превью для ссылок в тексте сообщения или поста

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

Заполните это, если хотите изменить текущее сообщение

до `4000` символов
Вложения сообщения. Если поле пустое или равно `null`, изменений не произойдёт. Если массив пуст, все вложения будут удалены

Данные для прикрепления изображения (все поля являются взаимоисключающими). Вместе с изображениями можно прикрепить видеофайлы (`type: video`) и одно вложение с кнопками (`type: inline_keyboard`). Общее количество вложений не должно превышать общее ограничение — 12. Подробнее — [в примерах](/docs-api/use-cases/sending-messages/media#Как%20отправить%20аудио)

от `1` символа

Любой внешний URL изображения, которое вы хотите прикрепить
Токен существующего вложения
Токены, полученные после загрузки изображений

Данные, которые вы получили в ответ на запрос [POST /uploads](/docs-api/methods/POST/uploads). Можно передавать после того, как вы загрузили аудио, видео или файл и получили в ответ от сервера `retval`. Подробнее — в описании [POST /uploads](/docs-api/methods/POST/uploads)

Токен вложения — уникальный ID загруженного медиа: изображения, аудио, видео или файла. Возвращается в ответ на вызов [POST /uploads](/docs-api/methods/POST/uploads)

Данные, которые вы получили в ответ на запрос [POST /uploads](/docs-api/methods/POST/uploads). Можно передавать после того, как вы загрузили аудио, видео или файл и получили в ответ от сервера `retval`. Подробнее — в описании [POST /uploads](/docs-api/methods/POST/uploads)

Токен вложения — уникальный ID загруженного медиа: изображения, аудио, видео или файла. Возвращается в ответ на вызов [POST /uploads](/docs-api/methods/POST/uploads)

Данные для прикрепления файла к сообщению, которые вы получили в ответ на запрос [POST /uploads](/docs-api/methods/POST/uploads). К сообщению можно прикрепить только один файл вместе с одним вложением с кнопками. Отправка файла совместно с другими вложениями не поддерживается

Токен вложения — уникальный ID загруженного медиа: изображения, аудио, видео или файла. Возвращается в ответ на вызов [POST /uploads](/docs-api/methods/POST/uploads)

Данные для при прикрепления стикера к сообщению. Должен быть единственным вложением в сообщении. В одном запросе можно отправить только один стикер

Код стикера

Данные для прикрепления карточки контакта к сообщению. К сообщению можно прикрепить один контакт. Совместно с ним можно прикрепить дополнительно одно вложение с кнопкой (`type: inline_keyboard`). Передача других типов вложений совместно с контактом не поддерживается

Имя контакта
ID контакта, если он зарегистрирован в MAX
Полная информация о контакте в формате VCF

Данные для прикрепления кнопок к сообщению
Ограничения:
- Максимальное количество кнопок в ряду — 7
- Максимальное количество строк с кнопками — 30
- Если в ряду кнопки с типами: `link`, `open_app`, `request_geo_location`, `request_contact`, то максимальное количество кнопок в ряду — три

от `1` символа

Двумерный массив кнопок. Подробнее о типах кнопок и клавиатуре в ботах — [в разделе «Клавиатура для чат-бота»](/docs-api/use-cases/sending-messages/keyboard)

от `1` до `128` символов

Видимый текст кнопки. Чтобы он отображался полностью, рекомендуем не превышать заданное количество символов в зависимости от размещения текста: `20` символов — при одной кнопке в ряду, `10` — при двух, `5` — при трёх, `3` — при четырёх

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

Токен кнопки

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

Если `true`, отправляет местоположение без запроса подтверждения пользователя
Если `false`, возвращает модальное окно с дополнительным уточнением об отправке местоположения

Публичное имя (username) бота или ссылка на него, чьё мини-приложение надо запустить
Идентификатор бота, чьё мини-приложение надо запустить
Параметр запуска, который будет передан в [initData](/docs/webapps/bridge#WebAppData) мини-приложения

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

Текст, который будет скопирован

Широта, до 15 символов
Долгота, до 15 символов

Данные для прикрепления предпросмотра контента по внешнему URL

от `1` символа

URL, прикреплённый к сообщению для предпросмотра медиавложения
Токен вложения

Ссылка на сообщение в чате или пост в канале. Ссылки на комментарии к постам в каналах не поддержаны

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

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

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

По умолчанию: `true`

Для каналов всегда отправляйте запрос с `notify = true` или без этого поля. Отключить push-уведомления в каналах нельзя

В групповых чатах и диалогах, если `notify = true` или поле отсутствует, уведомление отобразится пользователю

При `notify = false` отображение push-уведомлений зависит от платформы:
- **Десктоп-клиент и веб-приложение на iOS**. В диалогах и групповых чатах при `notify = false` уведомления не отображаются
- **Приложение на Android**. В диалогах при `notify = false` уведомления не отображаются. В групповых чатах при `notify = false` уведомление не отображаются, только если приложение МАХ свёрнуто или закрыто. Если приложение открыто, пользователь увидит уведомление
- **Веб-приложение**. Управление отображением уведомлений с помощью параметра `notify` не поддержано
Возможные значения в enum: `"markdown"` `"html"`

Разметка текста сообщения. Подробнее — в разделе [Форматирование](/docs-api/use-cases/sending-messages/text-formatting)

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

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

Подробнее о форматах ответа и кодах ошибок — [на странице «Общее описание»](/docs-api/#Результат%20выполнения%20запроса)

## Результат

`true`, если запрос был успешным, `false` — в противном случае
Код ошибки. Подробнее об ошибках API MAX — [на странице «Общее описание»](/docs-api/#Тело%20ответа)
Сообщение об ошибке

