MAX Bot API: полное руководство по созданию ботов

MAX — российский мессенджер от VK, на который часто ссылаются как «наш WeChat». У него есть открытое Bot API, мини-приложения, интеграции с платёжками и государственными сервисами. Ниже — всё, что нужно знать, чтобы создать бота и запустить его в работу.

Важное ограничение: бизнес-режим с августа 2025

С августа 2025 года MAX перевёл публикацию ботов в бизнес-режим. Это значит:

Создавать публичных ботов могут только юрлица и ИП — резиденты РФ.
Регистрация проходит через портал business.max.ru с верификацией через Т‑Банк, Госуслуги или Сбер.
Физлица и самозанятые пока не проходят.
На одну организацию — не больше 5 ботов.
После регистрации бот проходит модерацию. Только после неё он становится доступен пользователям.

Если вы работаете как ИП — доступ есть. Если только физлицо — потребуется оформить ИП или ЮЛ.

Способ 1: Без кода

Подходит для быстрого запуска без разработки. Официальные партнёры MAX: BotMother, JetBot, WatBot, ChatForma, SaleBot, UseDesk, VK CXhub.

Этапы запуска:

Зарегистрируйтесь на business.max.ru и создайте бота — получите токен.
Выберите конструктор из списка партнёров и зарегистрируйтесь там.
В настройках конструктора найдите раздел MAX, вставьте токен бота.
Настройте сценарий ответов в визуальном редакторе.

Способ 2: Через код (для разработчиков)

Шаг 1. Регистрация и токен

Войдите на business.max.ru и пройдите верификацию организации.
В разделе Чат-боты → Создать бота: укажите имя, аватар, описание.
Ник генерируется автоматически по шаблону idИНН_bot — изменить нельзя.
После модерации перейдите в Интеграция → Получить токен.

Токен передаётся только через заголовок Authorization. Передача через query-параметры больше не работает.

Шаг 2. Уведомления: webhook vs long polling

Режим	Когда использовать	Как работает
Long Polling `GET /updates`	Разработка и тестирование	Бот сам периодически запрашивает события
Webhook `POST /subscriptions`	Production	MAX сам шлёт запрос на ваш сервер при каждом событии

Для webhook обязателен HTTPS (включая самоподписанные сертификаты). HTTP не поддерживается. Лимит запросов к API — 30 rps.

Пример регистрации webhook:

POST /subscriptions
{
  "url": "https://site.ru/api/webhook",
  "update_types": ["message_created", "bot_started", "message_chat_created"],
  "secret": "somepass"
}

Способ 3: JavaScript / TypeScript

MAX предоставляет официальную библиотеку @maxhub/max-bot-api для Node.js.

Установка:

npm install --save @maxhub/max-bot-api

Минимальный бот:

import { Bot } from '@maxhub/max-bot-api';
const bot = new Bot(process.env.BOT_TOKEN);

bot.command('start', (ctx) => ctx.reply('Добро пожаловать!'));
bot.on('message_created', (ctx) => ctx.reply('Получил сообщение!'));

bot.start();

Запуск:

BOT_TOKEN="ваш_токен" node bot.js

Способ 4: Python

Официальной Python-библиотеки от MAX нет. Используйте опенсорсные:

pip install aiomax      # async
pip install maxgram     # sync

Пример на aiomax:

import aiomax

bot = aiomax.Bot("TOKEN", default_format="markdown")

@bot.on("bot_started")
def on_start(context):
    context.reply("Привет! Я готов к работе!")

@bot.hears("ping")
def ping_handler(context):
    context.reply("pong")

if __name__ == "__main__":
    import logging
    logging.basicConfig(level=logging.INFO)
    bot.run()

Возможности ботов MAX

Типы событий

Событие	Что происходит
`bot_started`	Пользователь запустил бота
`message_created`	Новое сообщение
`message_edited`	Сообщение отредактировано
`message_callback`	Нажата inline-кнопка
`bot_added / bot_removed`	Бот добавлен или удалён из чата

Типы кнопок

MAX поддерживает до 210 кнопок в одном сообщении (30 рядов × 7 кнопок) — значительно больше, чем Telegram:

Тип	Что делает
`callback`	Отправляет событие на сервер бота
`link`	Открывает URL
`message`	Отправляет текст боту
`request_contact`	Запрашивает телефон
`request_geo_location`	Запрашивает геолокацию
`open_app`	Открывает мини-приложение
`clipboard`	Копирует текст в буфер обмена

Вложения и форматирование

Изображения, видео, аудио, файлы до 4 ГБ без сжатия.
Markdown и HTML: жирный, курсив, зачёркнутый, ссылки, упоминания.
Deep Links: https://max.ru/YourBot?start=promo_summer2026 — для отслеживания источников трафика.

Что автоматизировать

Ответы на FAQ и типовые вопросы.
Приём заказов и запись на услуги.
Квалификация лидов с прямой связкой в amoCRM.
Рассылки и уведомления.
Сбор контактов и заявок.
Верификация через номер телефона.
Оплата через СБП и мини-приложения.

Полезные ссылки

Ресурс	URL
Документация разработчика	dev.max.ru/docs
API Reference	dev.max.ru/docs-api
Бизнес-портал	business.max.ru
JS-библиотека	github.com/max-messenger
Endpoint API	`platform-api.max.ru`

Вывод

MAX — рабочая платформа для бизнес-ботов с прозрачным API, мини-приложениями и интеграциями. Главное ограничение — нужен ИП или ЮЛ для публикации. Если это условие выполнено, запуск бота занимает от 1 дня на конструкторе до 3–5 дней при разработке полноценного решения с интеграциями.

Если нужен бот для MAX — пишите. Создадём под ключ: от регистрации до запуска.

MAX Bot API: полное руководство по созданию ботов (2025–2026)