Бот в MAX для бизнеса: как подключить и что он умеет

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

Ниже — как это работает на практике. Всё сверено с документацией на dev.max.ru на начало ноября 2026 года. Платформа активно развивается, поэтому детали могут меняться — перед запуском стоит сверить их ещё раз.

Кто может завести бота

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

Количество ботов зависит от типа профиля:

Профиль	Сколько ботов можно создать
Организация или ИП	5
Самозанятый	2

Отсюда практический вывод: если бота вам делает подрядчик, регистрировать его нужно на свою организацию. Разработчику вы передаёте токен — это ключ доступа к API, — а сам бот и его аудитория остаются вашими.

Как подключить бота: по шагам

1. Регистрация на платформе

Войти на платформу MAX для партнёров можно двумя способами: через веб-версию или через мини-приложение «MAX для бизнеса» внутри мессенджера. Шаги в обоих вариантах совпадают.

2. Профиль и верификация

После регистрации создаётся профиль организации, ИП или самозанятого, и его нужно верифицировать. Для организаций и ИП доступны Госуслуги и банковские сервисы T-Business ID и Alfa ID; через банковские сервисы — пока только в веб-версии.

Верификацию от имени организации может пройти только её руководитель (единоличный исполнительный орган) или представитель с правом первой или единственной подписи. Если бота делает сотрудник или подрядчик, этот шаг всё равно проходит руководитель.

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

В разделе «Чат-боты» нажимаете «Создать» и заполняете карточку:

логотип 500×500 px, JPG или PNG, до 5 МБ;
название до 59 символов: кириллица, латиница, цифры, без эмодзи;
описание до 200 символов: что бот делает, график работы оператора, контакты поддержки.

Никнейм пока формируется автоматически: idИНН_bot для юрлиц и ИП и se…_bot для самозанятых. Выбрать или изменить его пока нельзя. В логотипе и текстах запрещены ненормативная лексика, контент 18+ и данные других компаний, а описание должно соответствовать деятельности организации.

4. Модерация

После создания бот получает статус «на модерации». По документации проверка занимает до 48 часов по рабочим дням. После неё бот получает статус «создан», и пользователи могут найти его по никнейму.

5. Токен

Токен находится на платформе: «Чат-боты» → нужный бот → ⋮ → «Настройки». Если бот создан в мини-приложении «MAX для бизнеса», токен можно получить там же или командой в боте «MAX для бизнеса». Токен никому не пересылайте в открытых чатах: тот, у кого он есть, управляет ботом.

Два пути: конструктор или код

Простой сценарий можно собрать без программирования: у MAX есть конструкторы с готовыми решениями. Это подходит для FAQ, сбора заявок и простой записи.

Когда нужны своя логика, база данных, интеграции с CRM или оплата, бота пишут на коде через MAX Bot API. У MAX есть официальные библиотеки для JavaScript/TypeScript (@maxhub/max-bot-api) и Go, а также спецификация OpenAPI — по ней можно сгенерировать клиент для Python, PHP, C# и других языков. Можно работать и с API напрямую: это обычные HTTPS-запросы с JSON.

Как устроен MAX Bot API

Запросы и авторизация

Базовый адрес API — https://platform-api2.max.ru/. Старый домен platform-api.max.ru документация просит заменить. Токен передаётся в заголовке Authorization; в параметрах запроса его больше не принимают.

Проверить, что токен рабочий, можно одним запросом:

curl -X GET "https://platform-api2.max.ru/me" \
  -H "Authorization: <токен бота>"

В ответ придёт информация о боте: идентификатор, имя, никнейм.

Отправка сообщения с кнопками

Сообщения отправляются методом POST /messages. Получателя указывают в параметрах: user_id для личного диалога или chat_id для чата или канала. Кнопки — это вложение типа inline_keyboard:

{
  "text": "Здравствуйте! Чем помочь?",
  "attachments": [{
    "type": "inline_keyboard",
    "payload": {
      "buttons": [
        [{"type": "callback", "text": "Записаться", "payload": "book"}],
        [{"type": "link", "text": "Наш сайт", "url": "https://example.ru"}]
      ]
    }
  }]
}

Текст сообщения — до 4000 символов. Отправлять можно не больше двух сообщений в секунду в один чат, а всего к API — не больше 30 запросов в секунду. Для рассылок это значит одно: нужна очередь.

Вебхуки и Long Polling

Бот узнаёт о действиях пользователей двумя способами:

Webhook — MAX сам присылает событие на ваш сервер. Подписка настраивается методом POST /subscriptions. Для рабочих ботов документация рекомендует именно его.
Long Polling — бот сам опрашивает GET /updates. Способ ограничен по скорости и сроку хранения событий, поэтому подходит только для разработки и тестов.

Одновременно использовать оба нельзя. Требования к вебхуку строгие: HTTPS на порту 443, сертификат доверенного центра или Минцифры, полная цепочка сертификатов, совпадение домена с сертификатом. HTTP и самоподписанные сертификаты не поддерживаются. Если при подписке указать secret, MAX будет присылать его в заголовке X-Max-Bot-Api-Secret — по нему сервер проверяет, что запрос пришёл именно от MAX.

Что умеет бот в MAX

Семь типов кнопок

Под сообщением можно разместить до 210 кнопок: до 30 рядов, до 7 кнопок в ряду. Для кнопок-ссылок, запроса контакта, геолокации и открытия мини-приложения — не больше 3 в ряду.

Кнопка	Что делает	Пример
`callback`	Отправляет боту событие	Выбрать услугу, подтвердить запись
`link`	Открывает ссылку	Страница оплаты, сайт, каталог
`request_contact`	Запрашивает номер телефона	Регистрация, программа лояльности
`request_geo_location`	Запрашивает геолокацию	Ближайший филиал, доставка
`open_app`	Открывает мини-приложение	Каталог, калькулятор, календарь
`message`	Отправляет заранее заданный текст	Быстрые ответы
`clipboard`	Копирует текст в буфер	Промокод, трек-номер, реквизиты

У кнопки request_contact есть полезная деталь: в сообщении с контактом приходит поле hash, по которому можно проверить, что человек поделился именно тем номером, который привязан к его аккаунту. Это позволяет использовать номер для регистрации. Но правила платформы ограничивают такие данные: использовать их можно только для работы с текущим ботом.

Диплинки

Ссылка вида https://max.ru/<никнейм_бота>?start=<payload> открывает бота и передаёт ему параметр длиной до 128 символов. Бот получает событие bot_started с этим значением. Отсюда сценарии:

QR-код на столике или в чеке ведёт в бота с номером заведения — бот сразу предлагает оставить отзыв;
кнопка «Отследить заказ» на сайте открывает бота с номером заказа, и он сразу показывает статус;
разные ссылки для разных площадок показывают, откуда пришли пользователи.

Конфиденциальные данные в payload в открытом виде передавать нельзя — только одноразовые токены или закодированные идентификаторы. Отправлять через диплинки авторизационные сообщения правила тоже запрещают.

Файлы и редактирование сообщений

Через POST /uploads бот загружает изображения, видео и файлы и прикрепляет их к сообщениям: так приходят PDF-анкеты, счета и договоры. Отправленные сообщения можно редактировать и удалять, поэтому меню не обязано копиться в чате: бот обновляет одно и то же сообщение.

Групповые чаты и каналы

Бота можно добавить в групповой чат или канал. В чате он принимает команды и присылает уведомления — например, о новых заявках в рабочую группу менеджеров. В канале публикует посты. По умолчанию добавление в групповые чаты выключено, его включают в настройках приватности после модерации. Чтобы бот видел сообщения и мог отвечать, ему нужны как минимум права read_all_messages и write.

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

Когда кнопок не хватает, к боту подключают мини-приложение — веб-интерфейс, который открывается внутри MAX кнопкой open_app. Это тот же подход, что и Telegram Mini Apps: обычная веб-разработка плюс проверка данных пользователя на сервере. О том, как это устроено, — в статье про Mini App для кафе и магазина.

Сценарии, которые хорошо ложатся на бота

Запись и заявки. Выбор услуги, даты и времени кнопками, подтверждение и напоминание накануне.
Статус заказа. Диплинк с номером заказа с сайта или из SMS, уведомления о смене статуса.
Поддержка. Ответы на частые вопросы кнопками и передача сложного вопроса оператору в рабочий чат.
Документы. Счёт, договор или анкета в PDF прямо в чат — без почты и ручной сборки.
Подбор персонала. Каталог вакансий, скрининг кандидата, анкета в PDF и уведомления рекрутеру. Так устроен мой демо-бот «Виртуальный рекрутер» — его можно открыть в MAX и пройти весь путь кандидата самому. Вакансии в нём вымышлены, это демонстрация, а не работа для клиента.
Внутренние задачи. Уведомления сотрудникам, сбор отчётов, согласования в групповом чате.

Частые ошибки при запуске

Бот зарегистрирован не на того. Если бота заводит подрядчик на свой профиль, вы зависите от него. Профиль и бот должны принадлежать вашей организации.
Long Polling в продакшене. Для отладки удобно, для живого бота — нет: события теряются и приходят с задержкой.
Рассылка без очереди. Ограничение в два сообщения в секунду на чат и 30 запросов в секунду на API быстро даёт о себе знать.
Не учли модерацию. Запуск «завтра утром» не получится, если бот ещё не прошёл проверку.
Нет сопровождения. API меняется: за 2026 год сменился домен, способ передачи токена, а часть методов перестала поддерживаться. Кто-то должен следить за этим и обновлять бота.

Что дальше

Если вы только присматриваетесь к MAX, начните с одного сценария: заявки, записи или статуса заказа. Сколько это может стоить и из чего складывается цена, я разобрал в статье «Сколько стоит разработать чат-бота для MAX».

А если хотите понять, как бот впишется в ваши процессы, напишите — посмотрю на задачу и предложу, с чего начать.