Как создать бота в MAX: пошагово для новичка

• Юрлицо, ИП или самозанятость — резидент России. Обычный пользователь без статуса бота в MAX не создаст.
• Госуслуги с ролью «Руководитель» или «Администратор» в кабинете организации. Подойдут и T-Business ID или Alfa ID.
• MAX на компьютере. Без приложения конструктор при проверке покажет белый экран.
• Конструктор ботов, который работает с MAX: BotHelp, SmartBot Pro, TextBack и другие партнёры платформы. Ниже пример на BotHelp.

Начните не с сервиса, а с одной задачи. Самая частая — принять заявку: узнать, что нужно человеку, взять имя и телефон и передать менеджеру.

Запишите разговор обычным текстом, прежде чем открывать конструктор:

• Бот: «Здравствуйте! Чем помочь?» Кнопки «Записаться», «Узнать цену», «Задать вопрос».
• Человек нажал «Записаться». Бот спрашивает, на какую услугу и когда удобно.
• Бот просит имя и телефон.
• Бот отвечает, что будет дальше: «Менеджер свяжется с вами сегодня».

Если разговор не помещается на половину страницы, бот получится запутанным. Разбейте его на несколько коротких веток.

Бот создаётся не в мессенджере, а на business.max.ru: раздел «Чат-боты» → «Создать». Заполните карточку: логотип 500×500 px, название до 59 символов без эмодзи, описание до 200 символов. Никнейм вида id<ИНН>_bot платформа присвоит сама.

Бот проходит модерацию — до 48 часов по рабочим дням. Токен потом лежит в «Чат-боты» → «⋮» → «Настройки».

Заполняйте карточку сразу начисто. Любая правка настроек после публикации снова отправляет бота на модерацию. Подробно про верификацию и токен — в статье «MAX для бизнеса: что это и как подключить к CRM».

1. 1
   Откройте каналы

   В кабинете BotHelp: «Настройки» → «Каналы» → «Добавить новый канал» → MAX.

2. 2
   Вставьте токен

   Скопируйте токен бота с платформы MAX и вставьте в окно подключения.

3. 3
   Сохраните

   Нажмите «Сохранить настройки». В кабинете появятся разделы «Диалоги», «Подписчики», «Боты» и «Автоматизация».

Пошагово с картинками это описано в справке BotHelp. По данным сервиса на ноябрь 2026 года, первые 14 дней бесплатны без привязки карты, дальше — от 1 599 ₽ в месяц. Авторассылки для канала MAX в BotHelp пока недоступны.

Приветствие настраивается в разделе «Автоматизация» → «Приветствие». Дальше — сообщения, кнопки и вопросы по вашему тексту из первого шага.

Кнопки у ботов в MAX стоят прямо под сообщением. Типов семь:

• обычная кнопка — ведёт к следующему сообщению;
• ссылка — открывает сайт;
• «Поделиться контактом» — присылает номер телефона, на который зарегистрирован MAX;
• геолокация — присылает, где человек находится;
• мини-приложение — открывает его внутри бота;
• текст — отправляет боту заготовленную фразу;
• копирование — копирует текст, например промокод.

Кнопкой «Поделиться контактом» телефон собирать надёжнее, чем просить набрать его вручную: опечаток не будет. Проверьте, умеет ли её ваш конструктор.

Путь заявки в готовом боте:

Уведомление менеджеру в BotHelp настраивается отдельным шагом: заявка приходит в Telegram или MAX. Кнопку «Задать вопрос» ведите на живого человека: переписка появится в разделе «Диалоги».

Клиенты найдут бота по никнейму в поиске MAX, но цифры никто не запоминает. Раздавайте ссылку и QR-код. В ссылку можно добавить метку источника: max.ru/<никнейм>?start=avito. Сделайте разные метки для сайта, Авито и стойки, и будет видно, откуда пришёл человек. В метку не кладите ничего личного: её видно в открытом виде.

• Клиент пишет первым. Бота нельзя добавить в личный диалог: человек сам открывает чат с ним по ссылке.
• Заявки храните не только в боте. Платформа может приостановить приложение без объяснения причин. Отправляйте заявки ещё и в таблицу или CRM.
• Без рекламы в сервисных сообщениях. Правила платформы это запрещают.
• В группах бот по умолчанию не работает. Добавление в групповые чаты включается в настройках приватности бота.

Для своей логики — проверки записи по расписанию, поиска клиента в базе, заявки в CRM — бота пишут на коде. У MAX есть официальные библиотеки для JavaScript и Go. Минимальный бот на JavaScript из README библиотеки, установка — npm install @maxhub/max-bot-api:

import { Bot } from '@maxhub/max-bot-api';

const bot = new Bot(process.env.BOT_TOKEN);

// Установка подсказок с доступными командами
bot.api.setMyCommands([
  {
    name: 'ping',
    description: 'Сыграть в пинг-понг'
  },
]);

// Обработчик события запуска бота
bot.on('bot_started', (ctx) => ctx.reply('Привет! Отправь мне команду /ping, чтобы сыграть в пинг-понг'));

// Обработчик команды '/ping'
bot.command('ping', (ctx) => ctx.reply('pong'));

// Обработчик для сообщения с текстом 'hello'
bot.hears('hello', (ctx) => ctx.reply('world'));

// Обработчик для всех остальных входящих сообщений
bot.on('message_created', (ctx) => ctx.reply(ctx.message.body.text));

bot.start();

Для Python есть сторонняя библиотека maxapi. Что учесть в коде:

• запросы идут на platform-api2.max.ru, токен — в заголовке Authorization;
• получать сообщения без сервера можно только для проверки. В рабочем боте MAX разрешает только вебхук по HTTPS с настоящим сертификатом;
• не больше 30 запросов в секунду, иначе ответ 429.

Всё это есть в документации MAX. Как собрать похожего бота в Telegram, я разбирал в статье «Как создать Telegram-бота».