API документация · /max/api · 78 документов

MAX API: Документация Bot API и мини-приложений мессенджера MAX

Методы Bot API, объекты Update и Message, вебхуки и Long Polling, клавиатуры и вложения, MAX Bridge для мини-приложений. Ищите на сайте или подключите MCP-сервер к Claude Code и Cursor — каждый ответ со ссылкой на dev.max.ru.

Искать в MAX API Подключить MCP

Попробуйте найти

Паспорт источника

Service ID: /max/api
Источник: dev.max.ru — официальная документация
Документов: 78
Состав: 35 страниц · 33 метода Bot API · 10 объектов
Спецификация: OpenAPI «Max Bot API» 0.0.33
Проверка источника: 21.10.2026
Версия API: не подтверждена

dev.max.ru/docs-api

MAX API — один из 17 API в Bridge8. Тот же поиск и MCP-сервер работают для VK, Яндекса, Битрикс24, Авито и других:

Весь каталог: 25 источников →

Что включено

78 документов MAX API в одном поиске

Сохранённые копии dev.max.ru: страницы документации и спецификация OpenAPI «Max Bot API» 0.0.33. У каждого документа — ссылка на официальную страницу и дата импорта.

Методы Bot API
33
Сообщения, чаты и каналы, участники и администраторы, загрузка файлов, подписки Webhook, Long Polling, ответы на callback.
- POST /messages
- GET /updates
- POST /subscriptions
Объекты API
10
Поля и типы объектов, которые возвращают методы и которые приходят в событиях.
- Update · Message · NewMessageBody
- Chat · ChatMember · User
- BotInfo · CommentMessage
Сценарии использования
10
Пошаговые руководства: сообщения с медиа и клавиатурой, форматирование, ID чата, команды, модерация комментариев, уведомления о событиях.
- Клавиатура в сообщениях
- Форматирование текста
- Получение ID чата или канала
Чат-боты и каналы
9
Создание и модерация бота, управление, конструктор без кода, библиотеки JavaScript и Go, примеры; создание каналов и управление ими.
- Создание и модерация чат-бота
- Библиотека JavaScript
- Библиотека Golang
Мини-приложения и Цифровой ID
5
Подключение мини-приложения, MAX Bridge, валидация данных, Цифровой ID и интеграция с сервисами партнёров.
- MAX Bridge
- Валидация данных
- Подключение к Цифровому ID
Платформа и правила
11
Обзор API и авторизация, истории изменений API и платформы, подключение организаций, Open Client API, правила для ботов и мини-приложений.
- Обзор и авторизация
- История изменений API
- Правила размещения чат-ботов

С чего начать

Как создать бота в MAX: пять шагов по документации

Коротко по официальным руководствам dev.max.ru. Подробности каждого шага — в поиске Bridge8 или у вашего ИИ-агента.

Подключитесь к платформеСоздайте и верифицируйте профиль организации, ИП или самозанятого на платформе MAX для партнёров.
Создайте ботаРаздел «Чат-боты» → «Создать»: логотип, название и описание. Никнейм формируется автоматически.
Пройдите модерациюПосле модерации бот доступен пользователям, а вам — управление ботом и подключение мини-приложения.
Получите токенТокен — в разделе «Чат-боты» → ⋮ → «Настройки» или в мини-приложении «MAX для бизнеса». Передавайте его в заголовке Authorization.
Настройте сценарииЧерез Bot API, библиотеки JavaScript и Go или конструктор без кода. События получайте через Webhook.

Кто может создать бота

Организация или ИП: 5 ботов на профиль
Самозанятый: 2 бота на профиль

Подключение к платформе MAX для партнёров доступно юрлицам, ИП и самозанятым — резидентам РФ. Цифровой ID — только юрлицам и ИП.

dev.max.ru/docs/chatbots/bots-create/create

Без программиста

Простые сценарии можно собрать в конструкторе без кода — руководство «Настройка сценариев работы бота с помощью конструктора».

Документация

Частые задачи: методы и руководства

Название ведёт на документ в поиске Bridge8, стрелка — на официальную страницу dev.max.ru.

Методы Bot API

7 из 33

Все 33 метода в поиске

Руководства

7 из 35

Все 35 страниц документации в поиске

Как использовать

Три способа работать с документацией MAX API

Без регистрации — на сайте. С регистрацией — через MCP-сервер прямо в Claude Code, Cursor или своём агенте.

01 · На сайте
Поиск без регистрации
Выберите MAX API в поиске и введите метод или задачу. Результаты — только из этого источника, со ссылкой на dev.max.ru.
MAX API · 78 → клавиатура в сообщении
02 · ИИ-агент по MCP
Спросите Claude Code или Cursor
Агент сам находит сервис, ищет фрагменты и читает документ целиком. В ответе — ссылка на источник и дата импорта.
«Напиши на Python обработчик Webhook для бота MAX: ответ на /start с inline-клавиатурой. Сверь методы с dev.max.ru»
resolve_service → search_docs → get_document
03 · Документ целиком
Читайте страницу полностью
get_document отдаёт документ постранично: параметры, поля, примеры. Удобно, когда агенту нужна вся страница, а не фрагмент.
get_document → POST /messages

Пример ответа · POST /messages

MAX API /max/api

POST /messages

Отправляет сообщение в диалог, групповой чат или канал. Кроме текста сообщение может содержать вложения: изображение, видео, аудио, файл, стикер, контакт.

Параметры

user_idinteger: ID пользователя, если сообщение отправляется пользователю.
chat_idinteger: ID чата или канала, если сообщение отправляется в чат или канал.
notifyboolean: Если false, участники чата не получат push-уведомления.

dev.max.ru/docs-api/methods/POST/messages

OpenAPI 0.0.33версия не подтверждена

Подключение

Подключите документацию MAX API к ИИ-агенту

Один MCP-сервер Bridge8 — и агент знает MAX API и ещё 16 API: VK, Яндекс Директ, Битрикс24, Авито и другие. Доступ бесплатный, вход по коду из письма — без пароля.

Как подключить за минуту

Получите токенВойдите в личный кабинет по почте и создайте Bearer-токен.
Добавьте серверАдрес https://bridge8.ru/mcp, транспорт Streamable HTTP. В совместимых клиентах можно войти через OAuth.
Спросите про MAX API«Найди в MAX API, как подписаться на события через Webhook, и покажи ссылку на источник».

Получить токен

Только документация

Bridge8 не подключается к вашему боту, не хранит его токен и не отправляет сообщения. Агент получает документацию и сам пишет код.

Claude Code — команда

claude mcp add --transport http bridge8 \
  https://bridge8.ru/mcp \
  --header "Authorization: Bearer <TOKEN>"

JSON для --mcp-config

{
  "mcpServers": {
    "bridge8": {
      "type": "http",
      "url": "https://bridge8.ru/mcp",
      "headers": {
        "Authorization": "Bearer <TOKEN>"
      }
    }
  }
}

Инструменты сервера — в порядке вызова

resolve_serviceНаходит сервис и версию по названию: «VK API», «Директ», «Битрикс24».
search_docsИщет фрагменты внутри выбранного сервиса — до 10 за запрос.
get_documentЧитает документ целиком, постранично, со ссылкой на источник.

Вопросы

Вопросы о MAX API

Что такое MAX API?

Bot API мессенджера MAX: HTTPS-методы, через которые бот отправляет сообщения, работает с чатами и каналами и получает события. Отдельно в документации описаны мини-приложения и MAX Bridge, Цифровой ID и подключение организаций.

Кто может создать бота в MAX?

Юрлица, ИП и самозанятые — резиденты РФ, подключённые к платформе MAX для партнёров. Организация или ИП может создать 5 ботов, самозанятый — 2. Каждый бот проходит модерацию.

Как получить токен бота MAX?

Токен присваивается при создании бота: на платформе в разделе «Чат-боты» → ⋮ → «Настройки» или в мини-приложении «MAX для бизнеса». В запросах его передают в заголовке Authorization — по обзору документации передача токена в query-параметрах больше не поддерживается, хотя спецификация OpenAPI ещё описывает её.

Webhook или Long Polling?

Для production документация рекомендует Webhook — подписку через POST /subscriptions. Long Polling (GET /updates) ограничен по скорости и сроку хранения событий и подходит для разработки и тестов.

Есть ли SDK для Python?

Официальные руководства — для JavaScript и Go. Для Python документация предлагает сгенерировать клиент по спецификации OpenAPI из репозитория max-messenger/api-schema; пример проверки данных мини-приложения на Python есть в разделе «Валидация данных».

На какой домен отправлять запросы?

В обзоре документации указан домен platform-api2.max.ru вместо platform-api.max.ru. Сверяйте адрес на dev.max.ru: у каждого фрагмента в Bridge8 есть дата импорта.

Это официальный сайт MAX?

Нет. Bridge8 хранит копию официальной документации dev.max.ru для поиска и ИИ-агентов. У каждого фрагмента — ссылка на первоисточник и дата импорта; версия API не подтверждена.

Bridge8 может управлять моим ботом?

Нет. Bridge8 — документация для разработчиков: он не подключается к MAX от вашего имени, не выдаёт и не хранит токены, не отправляет сообщения.

Ещё в Bridge8

Один поиск и один MCP-сервер для 17 API, справки и курсов. Сервисы и версии ищутся раздельно и не смешиваются.

Другие API в Bridge8

16 API · 5 680 документов

Яндекс

8 API

VK и MAX

2 API

CRM, телефония, банк

3 API

Объявления и рассылки

3 API

Справка и курсы

8 источников

Справка Яндекс Директа, Справка Яндекс Метрики, Справка Яндекс Вебмастера, Справка Яндекс Вордстата, Справка VK Рекламы, Справка Авито Рекламы, Курсы Яндекса (ЯРД), Курсы VK Рекламы.

Каталог на главной

← На главную: поиск по всем источникам bridge8.ru/#catalog

MAX API: Документация Bot API и мини-приложений мессенджера MAX

78 документов MAX API в одном поиске

Методы Bot API

Объекты API

Сценарии использования

Чат-боты и каналы

Мини-приложения и Цифровой ID

Платформа и правила

Как создать бота в MAX: пять шагов по документации

Частые задачи: методы и руководства

Методы Bot API

Руководства

Три способа работать с документацией MAX API

Поиск без регистрации

Спросите Claude Code или Cursor

Читайте страницу полностью

Подключите документацию MAX API к ИИ-агенту

Как подключить за минуту

Вопросы о MAX API

Что такое MAX API?

Кто может создать бота в MAX?

Как получить токен бота MAX?

Webhook или Long Polling?

Есть ли SDK для Python?

На какой домен отправлять запросы?

Это официальный сайт MAX?

Bridge8 может управлять моим ботом?

Связанные источники и все API

Другие API в Bridge8

Яндекс

VK и MAX

CRM, телефония, банк

Объявления и рассылки

Справка и курсы

Добавим документацию вашего API в Bridge8