Как создать бота в мессенджере Max
Относительно недавно вышел новый русский мессенджер Max, который призван заменить Telegram в России, по мнению депутатов. Так как огромное количество бизнеса влило в маркетинг внутри Telegram огромные деньги, мы решили изучить вопрос и посмотреть, как создаются чат-боты в Max, и насколько сложно будет перенести их из Telegram.
Документация и знакомство с API
Мы ознакомились с документацией Max… и были приятно удивлены, она написана хорошо, а самое главное – есть куча примеров, да еще и с картинками. Автор, как программист, очень сильно обрадовался от увиденного.
Первый беглый обзор показал, что разработка ведется с помощью Node.js, ведь Max предлагает готовое API именно под него. А еще есть поддержка TypeScript, Deno, а значит можно еще использовать Bun.
На момент 16.06.2025 для других языков программирования пока готового официального API нет. Хотя в документации описаны маршруты для работы по HTTP, значит, это вопрос времени: рано или поздно кто-нибудь обернёт это в готовую библиотеку (ну или сами сделаете). То есть техническая возможность есть, можно работать и на других языках программирования, просто API придётся делать самостоятельно.
U.P.D от 15.05.2026: появилась поддержка Golang.
Более детальное рассмотрение показало, что тут есть поддержка сообщений, ответов на них и даже кнопок, как в Telegram:
Хотя документация в общем своём виде меньше, чем в Telegram, потому что некоторых вещей тут ещё нет, например, платежей. А вот Max App (аналог Telegram App) всё-таки есть.
Сам дизайн API (code style) похож на телеграмовский, но не без изменений. То есть взять и быстро портировать бота из Telegram в Max не получится, придётся немного покодить, так как вызовы команд и работа с пользовательскими взаимодействиями немного отличаются.
Но если бот изначально спроектирован нормально: всё разбито по модулям, а не «накакано» в одном файле, то процесс переноса займёт незначительное время. Какие-то простые боты могут быть перенесены за пару часов из Telegram в Max.
Создаем простого бота в Max
Когда только появился Max, бот создавался по аналогии с Telegram: нужно было найти бота «@BotMaster» в поиске, а дальше процесс был схож с любимым Telegram. Но где‑то весной 2025 года это убрали, и теперь бот создаётся из личного кабинета партнера-разработчика.
Вам надо зарегистрироваться по ИНН, подтвердить свой аккаунт и только потом можно начать работу.
После, в личном кабинете выбрать раздел "Чат-боты", зайти в него и найти там кнопку "Создать бота".
Надо будет заполнить все требуемые поля и нажать "Создать":
После, надо найти раздел "Интеграции" и нажать там кнопку "Получить токен".
Сохраните его.
Теперь подготавливаем Node.js среду для разработки: автор будет использовать Docker-контейнер с Node.js 20.11.1.
Чтобы было быстрее, автор оставит свои конфигурационные файлы:
Файл .env создайте сами и поместите туда переменную BOT_TOKEN=Ваш_токен.
Кодим
Устанавливаем официальное API пакетом для npm:
npm install --save @maxhub/max-bot-api
Создаем index.js файл и пишем туда:
Что мы тут делаем? Мы добавили новую команду /hello в бота и запрограммировали ответ на неё. Давайте проверим.
Запускаем все командой:
node index.js
Сейчас ищем своего бота по названию в поиске Max, после нажимаем «Начать» и вводим команду:
Как видите, всё работает, да и времени заняло совсем немного.
Итог
Цель этой небольшой статьи — показать, что создать своего бота в Max дело не сильно сложное, тем более не сложнее, чем делать это в Telegram, ибо документация меньше и функционала пока не так много. Но базовый функционал весь есть, а из него обычно состоят 80% всех ботов, так что работать можно. Если вам потребуется помощь в создании своих ботов или надо портировать бота из Telegram, то свяжитесь с нами через форму обратной связи ниже, ответим как можно быстрее.
Оставьте комментарий