Как создать бота в Макс: пошаговая инструкция для бизнеса

Что подготовить заранее

Почти все задержки происходят не в коде. Ждут, пока руководитель найдёт время зайти в Госуслуги, пока обновятся данные в реестре, пока дизайнер пришлёт квадратный логотип. Соберите это до начала:

• Статус: ООО, ИП или самозанятый.
• Руководитель с доступом к бизнес-аккаунту на Госуслугах или к банковскому входу T-Business ID / Alfa ID. Самозанятому нужен личный аккаунт Госуслуг.
• Актуальные сведения в ЕГРЮЛ или ЕГРИП. Если в реестре старый руководитель, подтверждение не пройдёт.
• Квадратный логотип 500×500 px (jpg или png, до 5 МБ), название и описание до 200 символов.
• Сценарий: что бот делает в первую очередь. Принимает заявки, записывает на время, отвечает на вопросы о заказе.
• Политика обработки персональных данных, если бот будет спрашивать имя, телефон или адрес.

Шаг 1. Профиль и подтверждение

Профиль создаётся на платформе для партнёров business.max.ru/self или в мини-приложении «MAX для бизнеса» прямо в мессенджере. Входят по номеру телефона. Берите корпоративный номер или номер руководителя: если завести профиль на личный номер маркетолога, после его ухода с доступом могут начаться сложности.

Организация и ИП подтверждаются через Госуслуги или через банк (T-Business ID, Alfa ID). Вход через банк пока работает только в веб-версии платформы. Самозанятого после создания профиля сразу отправляют на подтверждение через личные Госуслуги.

Обычно данные подтягиваются за время от нескольких минут до часа, изредка до суток. Если прошли сутки, а профиль всё ещё не подтверждён, первым делом сверьте сведения о руководителе в ЕГРЮЛ или ЕГРИП.

Шаг 2. Карточка бота

В профиле откройте раздел «Чат-боты» и нажмите «Создать». Карточку увидят клиенты, и по ней же бота проверяет модерация, так что заполняйте её сразу начисто.

Красивого ника вроде @coffee_bot в Макс не будет. Клиенты находят бота по ссылке, QR-коду и названию, поэтому название стоит продумать.

Шаг 3. Модерация

После создания бот получает статус «На модерации». Проверка идёт до 48 часов по рабочим дням, результат приходит в чат «MAX для бизнеса». Если всё в порядке, статус меняется на «Опубликован» и в настройках появляется токен. Если нет, будет «Нужны исправления»: правите карточку по замечаниям и отправляете снова.

Учтите одну особенность. Любая правка карточки после публикации, даже смена описания, снова отправляет бота на проверку. Пользователи в это время видят старую версию, бот не пропадает. Но если вы меняете название за день до рассылки по базе, новое название клиенты увидят уже после рассылки. Собирайте правки вместе и отправляйте одной пачкой.

Шаг 4. Токен и выбор: конструктор или код

Токен — ключ, через который программа управляет ботом. Он лежит в настройках бота на платформе (меню «⋮»), рядом кнопки «скопировать» и «обновить». Храните его в переменных окружения или в хранилище секретов, а не в коде репозитория. Если токен утёк, перевыпустите его.

Дальше два пути. Для сборки без кода документация Макс рекомендует платформы официальных партнёров: там собирают сценарий из блоков и там же его потом меняют. Второй путь — свой сервер, который работает с API Макс напрямую.

Шаг 5. Первые запросы к API

Адрес API — https://platform-api2.max.ru. Токен передают в заголовке Authorization. Раньше его можно было указать параметром в адресе, теперь так запросы не принимаются. Для начала проверьте, что токен рабочий: запрос /me вернёт данные бота.

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

Так отправляется сообщение пользователю:

curl -X POST "https://platform-api2.max.ru/messages?user_id=<id пользователя>" \
  -H "Authorization: <токен>" \
  -H "Content-Type: application/json" \
  -d '{"text": "Заявка принята, менеджер ответит в течение часа"}'

Чтобы бот отвечал на сообщения, ему нужно получать события от Макс. Способов два.

• Webhook (POST /subscriptions). Макс сам отправляет события на ваш сервер, и для рабочего бота это рекомендованный вариант. Требования строгие: только HTTPS и только порт 443, сертификат от доверенного центра, самоподписанный не подойдёт. Ответить кодом 200 нужно за 30 секунд. При подписке задайте секрет и сверяйте его с заголовком X-Max-Bot-Api-Secret в каждом входящем запросе, тогда посторонний не сможет прислать боту поддельное событие. Если на 443 порту уже работает сайт, заведите для бота отдельный путь в настройках веб-сервера.
• Long polling (GET /updates). Бот сам спрашивает у Макс, нет ли новых событий. Удобно, пока пишете и отлаживаете бота на своём компьютере. Для работающего бота документация этот способ не рекомендует: скорость и срок хранения событий ограничены.

Официальные библиотеки есть для JavaScript/TypeScript и Go. Для Python, PHP, C#, Java клиент генерируют по OpenAPI-спецификации из документации или берут неофициальную библиотеку. Её код стоит посмотреть до того, как доверять ей токен.

Чем бот в Макс отличается от Telegram-бота

Устроены боты похоже: сообщения, кнопки, события, webhook. Поэтому готового Telegram-бота переписывать целиком не приходится, меняется часть, которая общается с мессенджером. Разница в основном в оформлении и правилах.

Где чаще всего ошибаются

• профиль пытается подтвердить сотрудник или подрядчик, а нужен руководитель;
• в ЕГРЮЛ или ЕГРИП устаревшие данные, и профиль сутками не подтверждается;
• карточку правят перед запуском рекламы, и бот на пару дней уходит на повторную модерацию;
• токен передают в адресе запроса или оставляют в открытом репозитории;
• webhook подняли на самоподписанном сертификате или не на 443 порту, и события не доходят;
• рабочий бот получает события через long polling и под нагрузкой теряет часть сообщений;
• рассылку отправляют без очереди и упираются в лимиты;
• бот собирает телефоны, а политики обработки данных нет.

Когда проще заказать разработку

Меню с кнопками и анкету можно собрать самостоятельно в конструкторе партнёра. Разработчик нужен, когда через бота проходят заявки и деньги:

1. бот создаёт сделки в CRM, проверяет остатки в 1С или складе, записывает клиентов в расписание;
2. нужны оплата, личный кабинет или мини-приложение внутри Макс;
3. Telegram-бот уже есть, и такой же нужен в Макс без второй копии кода;
4. бот должен работать в Telegram и Макс одновременно, с общей логикой и одной CRM;
5. в компании некому следить за сервером, сертификатом и обновлениями.

Нужен бот в Макс под ваш процесс?

Сделаем бота с интеграцией в CRM, 1С и оплаты или перенесём в Макс вашего Telegram-бота, не дублируя код. Новый бот — от 70 000 ₽, перенос из Telegram — от 30 000 ₽. Подтверждение профиля проходите вы, а мы заранее скажем, что для него подготовить.

Обсудить бота в Макс Написать в Telegram Оставить заявку

Сверено с документацией Макс для разработчиков 4 октября 2026 года. Правила платформы меняются, перед запуском проверьте актуальные условия.

Рядом по теме

Если бот в Макс нужен для бизнеса

Все материалы →

Перенос Перенос Telegram-бота в Макс Что переносится без изменений, что придётся адаптировать и сколько это стоит. → Два мессенджера Один бот для Telegram и Макс Одна логика и одна интеграция с CRM для обоих мессенджеров. → Mini App Мини-приложение в Макс Когда кнопок не хватает: каталог, личный кабинет или длинная форма внутри мессенджера. →