WebApp / MiniApp в мессенджере MAX
Работа с мини-приложениями в MAX отличается от Telegram. Ниже — основные особенности, которые нужно учесть.
- Одно мини-приложение на бот (в Telegram — несколько).
- В кнопке указывается юзернейм бота, а не прямая ссылка.
- В приложениях Каталог / Календарь / Mini App нужен токен бота.
- Переменные не работают в типе «Открыть URL».
- Своё mini app требует другой JS-библиотеки.
Одно мини-приложение на бот
В MAX можно создать только одно мини-приложение на каждый бот.
Добавление ботов и мини-приложений происходит на сайте MAX для партнёров: business.max.ru/self
Ссылку на мини-приложение тоже добавляете на сайте партнёров.
Кнопка запуска приложения
В кнопке можно указать ссылку на приложение или юзернейм бота.
@В кнопке нужно указывать юзернейм бота без знака @.
Каталог, Календарь, Mini App — токен бота
В приложениях Каталог, Календарь и Mini App для MAX необходимо указывать токен бота.
Приложения Каталог и Календарь работают точно так же, как в Telegram — никаких отличий в логике сценариев нет.
«Открыть URL» — без переменных
В типе приложения «Открыть URL» используйте только конкретные ссылки, переменные не поддерживаются.
Сгенерировать платёжную ссылку и открыть её внутри мини-приложения не получится — выводите ссылку напрямую в кнопке сообщения.
Собственное Mini App под MAX
Для типа приложения «Mini App» в коде нужно подключить библиотеку MAX:
<script src="https://st.max.ru/js/max-web-app.js"></script>
Если используете готовый бот из базы конструктора и хотите, чтобы mini app, написанное под Telegram, заработало в MAX:
-
Замените в коде
window.Telegram.WebApp→window.WebApp. -
Замените библиотеку Telegram на библиотеку MAX:
<!-- Было -->
<script src="https://telegram.org/js/telegram-web-app.js"></script>
<!-- Стало -->
<script src="https://st.max.ru/js/max-web-app.js"></script>