Как создать бота в мессенджере Max

Относительно недавно вышел новый русский мессенджер Max, который призван заменить Telegram в России, по мнению депутатов. Так как огромное количество бизнеса влило в маркетинг внутри Telegram огромные деньги, мы решили изучить вопрос и посмотреть, как создаются чат-боты в Max, и насколько сложно будет перенести их из Telegram.

Документация и знакомство с API

Мы ознакомились с документацией Max… и были приятно удивлены, она написана хорошо, а самое главное – есть куча примеров, да еще и с картинками. Автор, как программист, очень сильно обрадовался от увиденного.

Первый беглый обзор показал, что разработка ведется с помощью Node.js, ведь Max предлагает готовое API именно под него. А еще есть поддержка TypeScript, Deno, а значит можно еще использовать Bun.

На момент 16.06.2025 для других языков программирования пока готового официального API нет. Хотя в документации описаны маршруты для работы по HTTP, значит, это вопрос времени: рано или поздно кто-нибудь обернёт это в готовую библиотеку (ну или сами сделаете). То есть техническая возможность есть, можно работать и на других языках программирования, просто API придётся делать самостоятельно.

Более детальное рассмотрение показало, что тут есть поддержка сообщений, ответов на них и даже кнопок, как в Telegram:

Хотя документация в общем своём виде меньше, чем в Telegram, потому что некоторых вещей тут ещё нет, например, платежей. А вот Max App (аналог Telegram App) всё-таки есть.

Сам дизайн API (code style) похож на телеграмовский, но не без изменений. То есть взять и быстро портировать бота из Telegram в Max не получится, придётся немного покодить, так как вызовы команд и работа с пользовательскими взаимодействиями немного отличаются.

Но если бот изначально спроектирован нормально: всё разбито по модулям, а не «накакано» в одном файле, то процесс переноса займёт незначительное время. Какие-то простые боты могут быть перенесены за пару часов из Telegram в Max.

Создаем простого бота в Max

Ну что, давайте посмотрим на процесс создания бота в Max, чтобы самостоятельно уже всё своими руками пощупать.

Для начала идём в поиск и ищем «@BotMaster». Тут процесс создания бота похож на манипуляции из Telegram. Находим «мастера», нажимаем «Начать», отправляем ему команду /create и придумываем название бота. После нам выдадут его токен:

Теперь подготавливаем Node.js среду для разработки: автор будет использовать Docker-контейнер с Node.js 20.11.1.

Чтобы было быстрее, автор оставит свои конфигурационные файлы:

docker-compose.yml

Dockerfile

Файл .env создайте сами и поместите туда переменную BOT_TOKEN=Ваш_токен.

Кодим

Устанавливаем официальное API пакетом для npm:

npm install --save @maxhub/max-bot-api

Создаем index.js файл и пишем туда:

index.js

Что мы тут делаем? Мы добавили новую команду /hello в бота и запрограммировали ответ на неё. Давайте проверим.

Запускаем все командой:

node index.js

Сейчас ищем своего бота по названию в поиске Max, после нажимаем «Начать» и вводим команду:

Как видите, всё работает, да и времени заняло совсем немного.

Итог

Цель этой небольшой статьи — показать, что создать своего бота в Max дело не сильно сложное, тем более не сложнее, чем делать это в Telegram, ибо документация меньше и функционала пока не так много. Но базовый функционал весь есть, а из него обычно состоят 80% всех ботов, так что работать можно. Если вам потребуется помощь в создании своих ботов или надо портировать бота из Telegram, то свяжитесь с нами через форму обратной связи ниже, ответим как можно быстрее.