MAX Bot API: возможности и с чего начать разработку

MAX Bot API открывает возможности для автоматизации бизнес-процессов и прямого взаимодействия с аудиторией в мессенджере MAX (по данным VK — более 100 миллионов зарегистрированных пользователей). Это инструмент для компаний, которые хотят автоматизировать продажи, поддержку и маркетинг через интерактивных ботов.

Что такое MAX Bot API

MAX Bot API — интерфейс, через который ваш сервер взаимодействует с мессенджером от имени бота. Актуальный базовый адрес — `https://platform-api2.max.ru` (прежний `platform-api.max.ru` платформа выводила из эксплуатации). Авторизация — токеном бота в HTTP-заголовке `Authorization` (сырая строка токена). Создавать ботов и пользоваться API могут самозанятые, ИП и юридические лица — резиденты РФ после верификации профиля на платформе MAX для партнёров.

Как получить доступ к API

1. Зарегистрируйте и верифицируйте профиль на business.max.ru (самозанятый, ИП или юрлицо).

2. Создайте чат-бота в разделе «Чат-боты» и дождитесь модерации (до 48 часов в рабочие дни).

3. Откройте Расширенные настройки → Настроить и скопируйте токен.

4. Дальше подключайте токен к своему бэкенду, конструктору или заказывайте разработку.

Отдельного «Master Bot» в официальной документации MAX нет — это устаревший совет из сторонних гайдов. Подробный путь к токену — в статье как получить токен бота MAX.

Официальные библиотеки и документация

На dev.max.ru платформа рекомендует официальные библиотеки:

• JavaScript / TypeScript — `@maxhub/max-bot-api`;
• Golang — клиент MAX Bot API.

Отдельного официального SDK на Python нет: с API работают через HTTPS-запросы или сторонние обёртки на свой страх и риск. Документация методов, вебхуков и примеров — на dev.max.ru/docs-api.

Основные возможности API

• отправка текстовых, медиа-сообщений и форматированного контента (Markdown / HTML);
• интерактивные кнопки для диалогов, выбора опций, запуска действий;
• вебхуки — основной механизм получения обновлений в проде: при событии MAX отправляет HTTP-запрос на ваш URL (нужен HTTPS и доверенный сертификат);
• long polling — удобен для разработки и тестов, не как основной прод-режим;
• лимит нагрузки: ориентир платформы — до 30 запросов в секунду на `platform-api2.max.ru`.

Расширяем функционал: мини-приложения, CRM, платежи

Мини-приложения

Мини-приложение запускается прямо из чата с ботом — полноценный интерфейс для каталога, формы, калькулятора или личного кабинета. Связка «бот + мини-приложение» закрывает и диалог, и сложный UI.

Интеграция с CRM

Подключение к CRM автоматизирует лидогенерацию, квалификацию, запись и управление обращениями. Данные из диалога уходят в CRM без ручного переноса.

Платежи через СБП

Приём оплаты через Систему быстрых платежей обычно делают через платёжного провайдера: бот отдаёт ссылку или QR-код, провайдер подтверждает оплату вебхуком, статус фиксируется в CRM. Подробнее — в статье оплата в MAX-боте через СБП.

Мониторинг, логирование и типовые ошибки

Рекомендуется записывать входящие и исходящие запросы, ошибки API и ключевые шаги сценария. Типовые ошибки при старте:

• некорректная настройка вебхука — URL недоступен извне, проблемы с SSL или фаерволом;
• ошибки авторизации — неверный токен, токен ещё не выдан (бот на модерации) или устаревший после перевыпуска;
• обращение к старому домену `platform-api.max.ru` вместо `platform-api2.max.ru`;
• недостаточная обработка ошибок — бот должен переживать сбои API и неожиданный ввод;
• игнорирование документации на dev.max.ru.

Частые вопросы (FAQ)

Кто может использовать MAX Bot API? Самозанятые, ИП и юридические лица — резиденты РФ после верификации профиля на платформе MAX для партнёров. Физлицам боты недоступны.

Где найти документацию? Актуальная документация, примеры и официальные библиотеки — на dev.max.ru.

Можно ли интегрировать бота с CRM и платежами? Да: API закрывает диалоги и события, а CRM и СБП подключают через ваш бэкенд или партнёрские сервисы.

Если хотите использовать MAX Bot API для своего бизнеса, вы можете заказать разработку в MAX под ключ и рассчитать стоимость разработки. Посмотрите кейсы внедрений.