Разработка ботов в MAX в 2026 году начинается не с кода, а с доступа: создать чат-бот можно только через верифицированный профиль организации на платформе MAX для партнёров, и на одну организацию доступно до 5 ботов.
После создания бот уходит на модерацию — проверка занимает до 48 часов по рабочим дням, а настройки во время проверки менять нельзя. Токен для подключения к API появляется после успешной проверки — без токена бот фактически “не живёт” в интеграции.
Главный вывод: если у вас уже есть верифицированная организация, MVP бота реально собрать за 1 день, а дальше всё упирается в модерацию и сценарии
В статье разберём требования, пошаговый процесс, нюансы токена, а также быстрый старт на официальной библиотеке MAX Bot API.
Кто может разрабатывать ботов в MAX и какие есть ограничения
Кто вообще может создать бота в MAX?
Ответ: только организация с верифицированным профилем на платформе MAX для партнёров.
Ключевые ограничения, которые важно знать заранее:
- Доступ к платформе партнёров (чат-боты/мини-приложения/каналы) пока ограничен списком юрлиц и ИП, в документации прямо упоминаются критерии вроде RuStore и МСП.РФ.
- Лимит: до 5 ботов на одну организацию.
- Публичность: сейчас пользователей нельзя “скрыть” от бота — в справке MAX указано, что любого бота можно найти по ссылке или по нику через поиск.
- Ник генерируется автоматически по шаблону idИНН_bot и менять его нельзя (пока).
Важно про планирование сроков
На код MVP вы потратите часы, а на “выход в люди” — время модерации и настройку карточки бота. Модерация — часть процесса, а не “формальность”.
Как устроен процесс: от создания до токена и запуска
Если коротко, процесс включает 3 этапа:
- Создаёте бота в кабинете MAX для партнёров (через раздел “Чат-бот и мини-приложение”).
- Ждёте модерацию: статус “на модерации” → “создан” (или “требует исправлений”).
- Получаете токен в разделе интеграции — и только после этого подключаетесь к API.
Что на практике чаще всего “ломает” сроки:
- карточка бота заполнена кое-как (описание не отвечает “что делает бот и зачем”);
- забыли контакты/атрибуты, которые ожидаются для корпоративного сценария;
- после правок бот уходит на повторную модерацию.
Модерация MAX: сроки, статусы и как пройти с первого раза
Вопрос → Ответ: сколько идёт модерация?
Ответ: официально — до 48 часов по рабочим дням.
Статусы, которые вы увидите:
- «на модерации» — идёт проверка; настройки менять нельзя.
- «создан» — бот прошёл проверку; можно включать сервисы и дальше развивать.
- «требует исправлений» — не прошёл; смотрите причину, правите и отправляете снова.
Практический чек-лист перед отправкой:
- описание: 2–3 предложения, что бот делает + для кого;
- сценарий: что пользователь получит после /start;
- ограничьте “лишние” функции на MVP — модерация любит ясность;
- подготовьте быстрый “план Б” на случай статуса “требует исправлений”.
Быстрый старт на официальной библиотеке MAX Bot API (TypeScript/JS)
MAX прямо рекомендует использовать официальную библиотеку @maxhub/max-bot-api для TypeScript/JavaScript.
Установка и минимальный бот
Официальный сценарий установки выглядит так (смыслово):
- создаёте папку проекта
- ставите пакет @maxhub/max-bot-api
- создаёте bot.js или bot.ts
- создаёте Bot и передаёте токен через env
- добавляете обработчики и запускаете bot.start()
Что важно про токен:
- токен появляется в кабинете после успешной проверки и используется для взаимодействия с API.
- при необходимости токен можно обновлять через интерфейс.
Какие события обрабатывать в первую очередь
Для MVP почти всегда достаточно:
- /start — приветствие + меню команд;
- обработка обычного текста (message_created) — чтобы бот не “молчал”;
- кнопки/меню — когда захотите UX как в “продукте”, а не как в “чатике”.
Тезис, который экономит недели
Сначала делайте бота “полезным в одном сценарии”, потом — “умным во всех сценариях”. MAX пока развивается, и переусложнение на первом релизе чаще мешает, чем помогает.
Архитектура “по-взрослому”: как мы бы собирали MVP для бизнеса
Мы (Максим и Елизавета) делали ботов на других платформах и знаем типовую картину: сначала нужен сценарий и метрики, а уже потом — красивые фичи. У Максима — опыт 13+ ботов разной сложности, включая воронки и интеграции.
Рекомендуемая структура MVP (без лишнего пафоса):
- Сценарии: 1 главный поток + 1 поток “ошибок” (непонятный ввод).
- Хранилище: хотя бы простая БД для пользователей/состояний.
- Логи: минимум — чтобы понимать, где бот “сыпется”.
- Анти-хаос: таблица команд/состояний, чтобы не плодить условные ветки.
Как добавить бота в групповой чат и что будет с каналами
В настройках бота можно разрешить или запретить добавление в групповой чат через кабинет платформы.
И есть нюанс: в документации указано, что если запретить добавление в групповой чат, добавить бота в канал тоже не получится.
Хотите бота в MAX под ваш сценарий (MVP за 7–14 дней)?
Коротко разберём задачу и скажем честно, что и за сколько дней можно сделать именно для вас!
Частые ошибки разработчиков MAX-ботов
• Путают “бот готов” и “бот опубликован”: без модерации пользователи не получат нормальный доступ.
• Пытаются “пересобрать Telegram один в один” вместо адаптации сценария под MAX.
• Сразу делают 20 команд — а потом утопают в состояниях и тестировании.
• Не закладывают время на повторную модерацию после правок.
Сколько стоит разработка и монетизация: что можно говорить точно
Про деньги в MAX важно говорить аккуратно: часть коммерческих моделей и инструментов может меняться по мере развития платформы.
Что можно сказать надёжно на базе официальной схемы работы:
- бот проходит модерацию, после чего становится доступным, и вы получаете токен для API.
- ограничения по доступу (кто может подключаться к платформе партнёров) прописаны в документации и завязаны на статус юрлица/ИП и критерии доступа.
Если вы планируете монетизацию:
- начните с понятного B2B-сценария (поддержка, заявки, статусы, уведомления);
- платежи и подписки лучше строить так, чтобы их можно было переносить между платформами (не “замыкать” бизнес на одной интеграции).
Нужна SEO-статья под MAX (боты/каналы/мини-приложения) без выдумок и с фактчекингом?
Мы делаем контент так, чтобы он приносил трафик и лиды
✅ семантика
✅ структура под AEO/GEO
✅ техничка без воды
Мини-чеклист: что сделать сегодня, чтобы бот в MAX запустился без боли
- Проверьте, что у вас есть верифицированный профиль организации (без него бота не создать).
- Уложитесь в лимит: до 5 ботов на организацию — не плодите сущности.
- Соберите MVP: /start + 1 сценарий + fallback на любой текст.
- Отправьте на модерацию и заложите до 48 часов по рабочим дням.
- После статуса “создан” заберите токен и подключайте API.
Короткая рекомендация
Если вы только заходите в MAX, стартуйте с “бота-утилиты” или “бота поддержки”: там проще показать ROI и проще пройти модерацию.
Хотите, чтобы мы набросали структуру вашего MAX-бота + контент-план под продвижение?
Без лишних созвонов и “консалтинга ради консалтинга”
✅ MVP-архитектура
✅ сценарии
✅ контент под запуск
Об авторах
Максим Наговицын — маркетинг-стратег с 10+ годами в digital, IT-предприниматель. Создатель AI-продуктов с 110K+ пользователей (Neuroscribe, @nanobananas_bot). Эксперт по запуску цифровых продуктов и вайб-кодингу. 300+ реализованных проектов.
Елизавета Наговицына — IT-предприниматель, контент-маркетолог, AI-интегратор. Co-founder Neuroscribe (60K+ пользователей), эксперт по SEO/GEO оптимизации. 700+ SEO-статей, опыт работы с международными рынками.
Глоссарий
Платформа MAX для партнёров — веб-кабинет MAX, где создают и настраивают чат-ботов, получают токен и управляют интеграциями.
Верифицированный профиль организации — подтверждённый профиль юрлица/ИП, без которого нельзя создать чат-бота в MAX.
Модерация чат-бота — проверка бота перед публикацией; по документации занимает до 48 часов по рабочим дням.
Токен бота — ключ доступа к API: появляется после успешной проверки и используется для работы бота с серверами MAX.
MAX Bot API — интерфейс для интеграции и разработки ботов; для JS/TS есть официальная библиотека @maxhub/max-bot-api.
message_created — тип события (в примерах библиотеки), который позволяет обрабатывать входящие сообщения пользователя.
Часто задаваемые вопросы
Как создать бота в MAX, если я физлицо?
По справке MAX, чат-бот можно создать только при наличии верифицированного профиля организации.
Когда бот становится доступен пользователям?
После успешной модерации бот получает статус “создан” и становится доступным (его можно найти по нику через поиск).
Сколько длится модерация бота в MAX?
Официально — до 48 часов по рабочим дням.
Как получить токен MAX-бота для подключения к API?
Токен появляется в кабинете после успешной проверки; далее его используют для работы с API ботов.
Можно ли сделать непубличного бота в MAX?
В справке указано, что сейчас пользователи могут найти любого бота по ссылке или по нику через поиск.
Сколько ботов можно создать на одну организацию?
Для одной организации доступно создание 5 ботов.
Какая библиотека для разработки на JavaScript/TypeScript в MAX рекомендована официально?
MAX рекомендует официальную библиотеку @maxhub/max-bot-api и показывает базовый пример подключения.
