Макс 13 мая 2026 · 7 минут чтения

Как добавить чат-бот в мессенджер Макс

Макс — российский мессенджер от VK с собственным Bot API, который идеологически близок к Telegram, но живёт на отдельной платформе. Разберёмся, где регистрируются Макс-боты, что такое портал business.max.ru, как устроен протокол — и как подключить готового бота к MaxBotStat за три шага.

Что такое Макс и его боты

Макс (max.ru) — мессенджер от VK, который стартовал в 2025 году как национальная альтернатива иностранным платформам. У него есть мобильные приложения, веб-версия, групповые чаты, каналы — и то, что нас интересует здесь больше всего — открытый Bot API.

Бот в Максе — это обычный аккаунт, которым управляет ваш сервер по HTTP. Он умеет всё то же, что и бот в Telegram:

принимать сообщения от пользователей (текст, медиа, файлы);
отправлять сообщения и инлайн-кнопки;
реагировать на команды (/start, /help и любые свои);
работать в личных чатах и в группах;
держать сценарий-диалог через состояния пользователя.

Главное отличие от Telegram — способ регистрации. Здесь нет «@BotFather», которому пишут в чат. Боты создаются через отдельный веб-портал для разработчиков и бизнеса.

Портал business.max.ru

business.max.ru — это личный кабинет Макса для бизнеса и разработчиков. Через него компании заводят ботов, привязывают их к бренду, проходят верификацию и получают доступ к Bot API.

Что доступно на портале:

создание и управление ботами;
настройка имени, аватара, описания, команд бота;
верификация бренда и галочка рядом с ботом;
выпуск и перевыпуск ключей доступа (access_token) к API;
базовая статистика на стороне Макса (сообщения, активность);
настройки приватности и соответствия требованиям закона.

Один аккаунт — много ботов. На business.max.ru можно завести несколько ботов под одним аккаунтом и управлять ими из одного кабинета. Каждый получает собственный токен.

Регистрация на портале

Откройте business.max.ru и нажмите кнопку «Войти» в правом верхнем углу.
Авторизуйтесь через приложение Макс — код подтверждения придёт прямо в мессенджер.
Заполните анкету: имя, контактный email, для юрлица — название компании и ИНН. Для пет-проекта и тестов хватает личных данных.
Подтвердите email по ссылке из письма.

После подтверждения вы окажетесь в кабинете: слева — навигация (Боты, Бренды, Аналитика, Настройки), справа — список ваших ботов (пока пустой).

Создание бота

В разделе «Боты» нажмите «Создать бота» и заполните поля:

Имя бота — то, что увидит пользователь в шапке диалога. Можно поменять в любой момент.
Username — латиницей, уникальный в пределах Макса. По нему пользователи находят бота, формат: @my_shop_bot.
Описание — короткий текст на экране бота до первого /start.
Аватар — PNG / JPG, лучше квадратный, не меньше 512×512 пикселей.
Команды — список из /start, /help и ваших собственных. Опционально, но помогает Максу показать подсказки.

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

идентификатор бота (числовой);
username;
access_token — длинная строка, выдаётся один раз.

access_token — это пароль бота к API. Восстановить нельзя, только перевыпустить (а старый сразу станет невалидным). Сразу сохраните его в секрет-менеджере или в .env. Не коммитьте в репозиторий, не показывайте на скриншотах.

Протокол: что такое Bot API Макса

Bot API Макса — это обычный REST поверх HTTPS. Бот сам решает, как получать события: либо опрашивает Макс длинными запросами (long polling через GET /updates), либо подписывается на вебхук — тогда Макс присылает события на ваш HTTPS-эндпоинт.

Базовый адрес:

https://platform-api.max.ru

Токен передаётся в HTTP-заголовке Authorization как есть, без префиксов вроде Bearer:

Authorization: <access_token>

Основные эндпоинты:

Метод	Что делает
`GET /me`	Информация о боте — id, имя, username
`GET /updates`	Long polling — забрать накопившиеся события
`POST /subscriptions`	Зарегистрировать вебхук
`POST /messages`	Отправить сообщение в чат
`GET /chats`	Список чатов, где состоит бот
`POST /chats/{id}/actions`	Показать «бот печатает…»

Все запросы и ответы — в JSON. Структуры объектов (Message, User, Chat, Update) идеологически близки Telegram, но не совместимы по полям: Макс — отдельная платформа, а не форк. Если у вас уже есть Telegram-бот — переиспользовать получится логику и архитектуру, но не типы.

Минимальный пример отправки сообщения через cURL:

curl -X POST "https://platform-api.max.ru/messages?chat_id=12345" \
  -H "Authorization: $MAX_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text":"Привет из бота!"}'

А вот тот же вызов на Node.js — без SDK, просто fetch:

const MAX = 'https://platform-api.max.ru'

await fetch(`${MAX}/messages?chat_id=${chatId}`, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': process.env.MAX_TOKEN,
  },
  body: JSON.stringify({ text: 'Привет!' }),
})

На этом, по большому счёту, всё. У вас есть рабочий бот в Максе — осталось добавить ему аналитику.

Как подключить бота к MaxBotStat

Раз у Макса свой Bot API — у MaxBotStat есть отдельный домен-прокси под него. Сценарий тот же, что и для Telegram: меняете базовый URL, и все вызовы начинают идти через нас. Логику бота переписывать не нужно.

1. Зарегистрируйтесь и привяжите бота

Откройте app.maxbotstat.ru и зарегистрируйтесь по email (или войдите, если аккаунт уже есть).
На главной нажмите «Добавить бота».
Выберите платформу Макс.
Введите название (для себя — как удобно ориентироваться в списке) и тот самый access_token из business.max.ru.
Нажмите «Сохранить».

MaxBotStat автоматически проверит токен через GET /me, подтянет имя бота и аватар, заведёт его в кабинете. Если токен невалидный — увидите ошибку прямо в форме.

2. Замените адрес API в коде

Единственное изменение в коде бота — одна строка. Меняете базовый URL:

# было
MAX_API_BASE = "https://platform-api.max.ru"

# стало
MAX_API_BASE = "https://api-max.maxbotstat.ru"

Все остальные параметры остаются как были: тот же access_token в заголовке Authorization, те же эндпоинты, тот же JSON. Мы прозрачно проксируем запрос на настоящий platform-api.max.ru, а ответ возвращаем без изменений.

Быстрая проверка тем же cURL — должна вернуться информация о боте:

curl "https://api-max.maxbotstat.ru/me" \
  -H "Authorization: $MAX_TOKEN"

3. Перезапустите бота

Перезапустите процесс (или контейнер) — и в кабинете MaxBotStat сразу же начнут накапливаться:

Контакты — каждый, кто написал боту, с именем, username и аватаром;
Сообщения — текст, время, направление (входящие / исходящие);
Источники — UTM-метки из /start?utm_source=..., если используете глубокие ссылки;
Воронки и намерения — автоматическая категоризация сообщений и этапы пути пользователя.

Откатиться можно в любой момент — просто верните в коде старый адрес https://platform-api.max.ru. Бот в кабинете при этом сохранится, новые сообщения перестанут поступать. Вернёте наш домен — сбор данных возобновится.

Что дальше

Документация: привязка Макс-бота — подробнее по кабинету.
Документация: замена адреса API — примеры на разных языках и библиотеках.
Тарифы — на бесплатном можно подключить одного бота и пощупать всё на живых данных без привязки карты.
REST-API v1 — как вытаскивать данные в свою CRM или BI.

Подключить бота — это пять минут. Бесплатный тариф, без привязки карты.

Открыть кабинет →