AppMage

AppMage

Telegram Mini App

Полная инструкция: от сборки в Studio до кнопки меню в боте

Обновлено: 2026-06-29

1. Соберите приложение в Studio

Войдите в AppMage и создайте mini-app в Studio: опишите задачу, дождитесь предпросмотра и при необходимости доработайте через чат.

Экспорт в Telegram использует текущий HTML из предпросмотра — убедитесь, что приложение выглядит так, как нужно, до экспорта.

Для экспорта нужна активная подписка AppMage. Сам экспорт в Telegram для подписчиков бесплатен.

2. Создайте бота в @BotFather

Откройте @BotFather в Telegram и отправьте команду /newbot.

Шаг 1 — имя бота (как видят люди): например «Мой магазин» или «AppMage Demo».

Шаг 2 — username бота: только латиница, цифры и _. Обязательно заканчивается на bot — например myshop_bot или appmage_demo_bot. Если имя занято, BotFather предложит другой вариант.

Шаг 3 — скопируйте токен (строка вида 123456789:ABCdef…). Его можно вставить в поле «Токен бота» при экспорте в Studio — AppMage один раз настроит кнопку меню. Токен не сохраняется на сервере.

3. Экспортируйте через кнопку Telegram в Studio

В Studio нажмите кнопку экспорта в Telegram (иконка Telegram) или «Создать Telegram Mini App».

При желании вставьте токен бота в поле «Токен бота (необязательно)» — AppMage один раз вызовет API Telegram и настроит Menu Button. Токен не сохраняется на сервере.

Нажмите «Создать Telegram Mini App». Через несколько секунд вы получите готовый URL.

4. Готовый URL на appmage.tech

После экспорта приложение публикуется на хостинге AppMage. Пример ссылки:

https://appmage.tech/tma/abc123def456/index.html

Отдельный аккаунт Cloudflare R2 или свой хостинг не нужны — всё работает на appmage.tech из коробки.

Скопируйте URL из окна экспорта или нажмите «Скопировать URL».

5. Кнопка меню: автоматически или вручную

Автоматически: укажите токен бота перед экспортом — если всё прошло успешно, увидите сообщение «Кнопка меню обновлена в Telegram».

Вручную через @BotFather:

  • Откройте @BotFather → выберите своего бота
  • Bot Settings → Menu Button → Configure menu button
  • Вставьте URL вида https://appmage.tech/tma/…/index.html
  • Откройте бота в Telegram и нажмите кнопку меню слева от поля ввода

6. Разница между /p/ и /tma/

Это разные типы ссылок — не путайте их при настройке бота.

  • /p/abc123… — публичный предпросмотр в браузере на AppMage. Удобно отправить ссылку друзьям или открыть на компьютере. В Telegram Mini App не подходит: нет Telegram SDK и полноэкранного режима внутри мессенджера.
  • /tma/abc123…/index.html — готовый Telegram Mini App: HTML с Telegram Web App SDK, опубликованный для BotFather. Именно этот URL нужно указывать в Menu Button.
  • Если вы экспортировали через кнопку Telegram в Studio — используйте только /tma/… URL.

FAQ для пользователей из России

Нужен ли VPN для Telegram и BotFather?
Обычно нет — Telegram и @BotFather работают в России без VPN. Но отдельные шаги API Telegram (автонастройка кнопки меню по токену, проверка URL) иногда не проходят из‑за блокировок — тогда попробуйте VPN или настройте Menu Button вручную в @BotFather. Экспорт и хостинг на appmage.tech VPN не требуют.
Нужна ли подписка?
Да, активная подписка AppMage. Оплата доступна в рублях (Lava) и других валютах. После оформления подписки экспорт в Telegram бесплатен.
Нужен ли Cloudflare или свой сервер?
Нет. AppMage публикует Mini App на appmage.tech автоматически. Свой хостинг нужен только если сработал запасной вариант со скачиванием .html файла.
Безопасно ли вводить токен бота?
Токен используется один раз для вызова setChatMenuButton и не сохраняется в базе AppMage. Если не хотите вводить токен — настройте Menu Button вручную в @BotFather.
Можно ли обновить приложение после экспорта?
Да. Доработайте проект в Studio и снова нажмите «Создать Telegram Mini App». URL может измениться — обновите его в @BotFather, если вы настраивали кнопку вручную.
Чем отличается ссылка для друзей от ссылки для бота?
Для друзей — /p/… (браузерный предпросмотр). Для бота — /tma/…/index.html (Mini App внутри Telegram).

Решение проблем

Экспорт пишет «нужна подписка»
Оформите или продлите план в AppMage. После активации подписки повторите экспорт.
Приложение не готово к экспорту
Дождитесь завершения генерации в Studio. В предпросмотре должно отображаться готовое приложение, а не пустая страница или ошибка.
Кнопка меню в боте не появилась
Проверьте URL в @BotFather (должен быть /tma/…/index.html). Перезапустите чат с ботом. Если использовали токен — попробуйте настроить Menu Button вручную.
Автонастройка кнопки меню не сработала
Частая причина в России — блокировка API Telegram. @BotFather обычно доступен без VPN; автоматический вызов setChatMenuButton — нет. Попробуйте VPN на момент экспорта с токеном или настройте Menu Button вручную в @BotFather.
Mini App открывается белым экраном
Откройте тот же URL в браузере. Если там тоже пусто — повторите экспорт из Studio. Если в браузере работает, а в Telegram нет — обновите Telegram до последней версии.
Скачался .html файл вместо URL
Это запасной режим. Загрузите файл на любой HTTPS-хостинг и укажите прямую ссылку на index.html в @BotFather. Обычно публикация на appmage.tech проходит автоматически.
Android Studio: «Trust Project» при открытии mobile-kit
Если вы собираете нативное Android-приложение из папки mobile-kit — в Android Studio можно отметить «Trust all projects in mobile-kit folder» (необязательно) и нажать Trust Project. Это не относится к Telegram Mini App — для TMA нужен только экспорт из Studio.