Чат-бота для бизнеса в MAX можно создать только после подключения к платформе «MAX для партнёров» и верификации профиля организации, ИП или самозанятого, а опубликовать — только после модерации, которая по документации занимает до 48 часов по рабочим дням [dev.max.ru, 08.10.2026]. Ниже — порядок действий, ограничения карточки бота и то, как бот получает сообщения. Практика взята из нашего демо-бота, все данные в демо вымышленные.
Что нужно до создания бота
Бота создаёт не человек, а верифицированный профиль. Сначала нужно подключиться к платформе «MAX для партнёров», создать профиль организации, ИП или самозанятого и подтвердить его. Подключение доступно только резидентам РФ: физическое лицо без статуса самозанятого или ИП чат-бота создать не сможет [help.max.ru, 08.10.2026].
От статуса зависят лимиты. Организация или ИП может создать до пяти ботов, самозанятый — до двух. Никнейм бота формируется автоматически и пока не меняется: для ИП и юрлиц это idИНН_bot, для самозанятых — se(orgid)_bot [dev.max.ru, 08.10.2026]. Поэтому в публичных материалах, скриншотах и примерах ник лучше скрывать или заменять заглушкой id<ИНН>_bot: в нём зашит идентификатор организации.
Перед регистрацией подготовьте данные, которые понадобятся в кабинете: реквизиты организации или ИП, контакт ответственного человека и готовый логотип бота нужного размера. Если часть данных придётся запрашивать у заказчика, начните с этого пункта: ожидание документов обычно занимает больше времени, чем сама модерация. Также заранее решите, какой сценарий бот будет выполнять первым.
Если вы пока не определились с форматом, прочитайте, чем бот отличается от мини-приложения, в статье про подключение мини-приложения.
→ По теме: Как создать мини-приложение в MAX и подключить к чат-боту
Как создать бота и заполнить карточку
Бот создаётся в кабинете платформы в разделе «Чат-боты». Сначала вы заполняете карточку, затем отправляете её на проверку. Требования к полям такие:
- Логотип: изображение 500×500 пикселей, до 5 МБ, формат jpg, jpeg или png.
- Название: от 1 до 59 символов.
- Описание: до 200 символов.
Модераторы проверяют содержимое карточки. Запрещены ненормативная лексика, материалы 18+ и использование данных других компаний [dev.max.ru, 08.10.2026]. Название и описание стоит писать так, чтобы пользователь сразу понял, чем бот полезен: «Запись на просмотр», «Подбор квартиры», «Заявка на расчёт». Общие формулировки вроде «Бот компании» хуже объясняют, зачем нажимать «Начать».
Название бота видит пользователь в списке чатов, а описание — на стартовом экране до первого нажатия. Поэтому логотип лучше сделать читаемым в маленьком круглом размере: мелкий текст на нём теряется.
Прежде чем заполнять карточку, определите один сценарий, который бот закрывает лучше всего. Для агентства недвижимости это может быть запись на просмотр, подбор вариантов по бюджету или заявка на консультацию по ипотеке. Бот, который пытается делать всё сразу, сложнее объяснить модератору и клиенту, а тексты кнопок получаются размытыми. Первый запуск разумнее ограничить одной задачей и расширять её после теста на реальных вопросах.
Это пожелание по организации работы, а не правило платформы: документация MAX не требует выбирать сценарий заранее.
Как проходит модерация
Каждый бот должен пройти модерацию. Пока бот на проверке, менять его настройки нельзя, а после успешной проверки открываются токен и настройки мини-приложения [dev.max.ru, 08.10.2026]. У бота может быть один из трёх статусов.
| Статус | Что означает | Что делать |
|---|---|---|
| На модерации | Бот проверяют, до 48 часов по рабочим дням | Ждать, настройки не менять |
| Опубликован | Бот доступен, открыты токен и настройки | Подключать код и сценарии |
| Нужны исправления | Модерация нашла замечания | Исправить карточку и отправить заново |
Источник: dev.max.ru, документация по созданию и модерации чат-бота, дата проверки 08.10.2026.
Важная деталь касается уже опубликованных ботов. Если изменить настройки такого бота, он снова перейдёт в статус «На модерации» [dev.max.ru, 08.10.2026]. Это совпадает с нашим наблюдением: после правок в разделе «Основная информация» бот снова проходил проверку. Поэтому не вносите изменения в бота перед важным показом или запуском рекламы, а на первый запуск закладывайте запас времени.
Срок «до 48 часов» — это официальная оценка, а не гарантия. Мы наблюдали более быстрый случай с мини-приложением (подробности в соседней статье), но единичное наблюдение не стоит превращать в обещание клиенту.
Как бот получает сообщения и что учесть
После модерации в кабинете открывается токен бота. Это секрет: его нельзя публиковать в статьях, чатах и репозиториях, а на скриншотах его нужно закрывать. Все запросы идут на platform-api2.max.ru, а общий лимит — 30 запросов в секунду на бота [dev.max.ru, 08.10.2026].
Сообщения боту можно получать двумя способами: через webhook и через long polling. Для боевой работы документация рекомендует webhook, причём только по HTTPS, а long polling считается подходящим для разработки и тестов [dev.max.ru, 08.10.2026]. Если запускаете бота на сервере, заранее подготовьте адрес с действующим сертификатом.
Несколько практических правил по токену. Храните его в переменных окружения на сервере, а не в коде и не в файле, который попадает в репозиторий. Если токен случайно оказался на скриншоте или в сообщении, считайте его скомпрометированным и перевыпустите. В логах приложения не печатайте заголовки запросов целиком: токен передаётся в них. Для проверки конфигурации достаточно вывести имена переменных без значений.
Отдельно подумайте, кто в компании имеет доступ к кабинету «MAX для партнёров». Профиль привязан к организации, ИП или самозанятому, и через него меняются настройки бота, а любое изменение отправляет опубликованного бота на повторную проверку. Поэтому лучше назначить одного ответственного, который вносит правки по согласованию с командой, а не нескольких людей, меняющих карточку независимо.
Стартовый сценарий строится вокруг диплинка max.ru/<ник бота>?start=<payload>. Параметр payload может содержать до 128 символов, а бот получает событие bot_started, когда пользователь нажимает «Начать» [dev.max.ru, 08.10.2026]. Через payload удобно передавать код источника или услуги (например, lot_12), но не личные данные и не секреты: параметр видно в ссылке.
Есть и ограничения среды. Бота нельзя добавить в личный диалог, а в групповые чаты он по умолчанию не добавляется [dev.max.ru, 08.10.2026]. Для сценариев «клиент пишет компании» это нормально: пользователь сам открывает бота.
В нашем демо-боте кнопка «Перейти к демо» создана классом OpenAppButton библиотеки maxapi: она открывает мини-приложение внутри MAX, а не во внешнем браузере. Как привязать приложение к боту, мы описали в отдельной статье.
Минимальный сценарий для бизнеса обычно состоит из четырёх шагов. Бот приветствует пользователя после нажатия «Начать» и коротко объясняет, что умеет. Затем предлагает выбрать задачу кнопкой. Потом собирает минимально нужные данные и подтверждает, что заявка принята. Наконец, даёт способ вернуться в начало или связаться с менеджером. Каждый шаг стоит проверить на телефоне: длинные тексты в чате читаются хуже, чем на сайте.
Если сценарий требует экрана с каталогом, калькулятором или формой, вместо цепочки кнопок удобнее подключить мини-приложение: бот остаётся входом, а сложный экран открывается внутри MAX. Когда достаточно двух-трёх кнопок, мини-приложение не нужно.
Частые ошибки и что проверить перед запуском
Большинство задержек возникает не из-за кода, а из-за карточки и настроек. Перед отправкой на модерацию пройдите короткий список:
- Профиль верифицирован, а статус (организация, ИП или самозанятый) соответствует нужному лимиту ботов.
- Логотип 500×500, до 5 МБ, в формате jpg или png; название до 59 символов, описание до 200.
- В карточке нет чужих данных, ненормативной лексики и материалов 18+.
- Ник бота и токен не попали на скриншоты и в публичные файлы.
- Адрес webhook работает по HTTPS, а бот отвечает на событие
bot_started. - В payload диплинка нет персональных данных.
- Правки в настройках внесены до запуска: после изменения опубликованный бот уйдёт на повторную проверку.
Если вы делаете бота для агентства недвижимости или сервисного бизнеса, лучше сначала собрать сценарий на вымышленных данных и показать его заказчику. Так проще согласовать тексты и кнопки до модерации. Посмотреть, как это выглядит в MAX и Telegram, можно на нашем демо: Открыть демо каталога. Обсудить пилот под свою задачу можно здесь: Обсудить пилот для агентства.
Перед запуском полезно показать бота заказчику на вымышленных данных. Откройте его с телефона, пройдите сценарий от «Начать» до подтверждения и запишите вопросы, на которых бот ошибся или промолчал. Так проще заранее согласовать тексты и не ждать повторной модерации из-за поправок в карточке. В нашем случае демо-бот работает именно на вымышленных данных, а реальные заявки и переписки в материалах не показываются.
→ По теме: Бот для записи клиентов в Telegram и MAX: сценарий записи