Telegram Mini Apps (TMA) — открытая платформа для запуска web-приложений и игр внутри Telegram. Приложения собираются на стандартном стеке HTML/CSS/JavaScript, открываются по ссылке из чата или кнопки бота и используют встроенные возможности мессенджера: авторизацию, платежи, обмен медиа, отправку звёзд и подарков.
Платформа стала ключевой точкой входа в экосистему TON — большинство пользователей TON-приложений впервые видят dApp именно как Mini App, а не как браузерный сайт или мобильное приложение.
Особенности#
- Один клиент. Mini App работает в том же приложении Telegram, где пользователь уже авторизован — на Android, iOS, Windows, macOS и Linux.
- Низкий порог. Знакомый веб-стек, никакой публикации в магазины приложений, мгновенное обновление: достаточно задеплоить новую сборку.
- Авторизация без seed-фразы. Через TON Connect приложение подключается к кошельку пользователя и запрашивает подпись без передачи приватных ключей.
- Платежи. Поддерживаются крипто-платежи в TON и Jettons, а также внутренняя валюта Telegram — Stars.
- Бот как сервер. Mini App обычно работает в паре с Telegram-ботом: бот хранит состояние, рассылает уведомления и инициирует диалог.
Как создать Mini App#
Полный путь до запуска приложения:
- Создать Telegram-бота через BotFather командой
/newbot. - Зарегистрировать Mini App: команда
/newappв BotFather, выбрать ранее созданного бота и привязать к нему приложение. После регистрации Mini App доступен по ссылкеhttps://t.me/{bot}/{app}. - Опубликовать веб-приложение по HTTPS с действительным SSL-сертификатом. В песочнице можно использовать IP, но в продакшене Telegram отклонит любую другую схему.
- Подключить кнопку запуска: команда
/setmenubuttonустанавливает Mini App в кнопку меню бота. Альтернатива — прямая ссылка через/myapps→Edit link.
После этого приложение доступно из кнопки меню, по прямой ссылке или из любого чата, в котором переслали инвайт.
Платежи и монетизация#
Mini App может зарабатывать несколькими способами:
- Внутриигровые покупки и подписки — в Stars или в TON через подписанные транзакции;
- Криптовалютные платежи — пользователь подтверждает транзакцию в подключённом кошельке (Tonkeeper, Wallet, MyTonWallet и др.) через TON Connect;
- Реклама и партнёрки — собственная атрибуция через
start_param, реферальные коды, выплаты через TON.
Для продвижения TON-проектов доступна рекламная сеть Telegram Ads. Реклама не использует персональные данные пользователя — таргетинг идёт по контексту канала. Бюджет можно оплатить непосредственно в TON.
Каталог и продвижение#
- Telegram Apps Center — каталог сторонних приложений и ботов; присутствует на
tapps.center. - Trending Apps (
t.me/trendingapps) — канал, в котором публикуют новые TMA и крупные обновления; модерируется сообществом. - The Open League (
Open_league_bot) — приложение, агрегирующее проекты, участвующие в одноимённой программе грантов и стимулов; даёт прямые ссылки на пулы STON.fi и DeDust.
Известные приложения#
- Notcoin и Hamster Kombat — tap-to-earn-игры, рекордсмены по охвату в категории TMA;
- Wallet — встроенный в Telegram кошелёк с криптой, P2P-маркетом и мультичеками;
- STON.fi — DEX на TON с интерфейсом, работающим прямо внутри Telegram;
- DeDust — второй крупный DEX экосистемы TON с TMA-фронтом;
- Getgems — NFT-маркетплейс с Mini App-версией.
Telegram Mini Apps 2.0#
В ноябре 2024 года Telegram выпустил крупное обновление платформы, расширившее её возможности до уровня нативных приложений:
- Полноэкранный режим в вертикальной и горизонтальной ориентации;
- Доступ к датчикам — акселерометр и гироскоп для управления в играх;
- Ярлык на главный экран — Mini App можно поставить рядом с обычными приложениями;
- Геолокация — карты, гео-игры, локальный поиск;
- Стикеры и TON Gifts — отправка подарков и достижений за Stars прямо из чата;
- Эмодзи-статусы для Premium — выставление через приложение;
- Документы и медиа — генерация файлов, реферальных карточек, мемов;
- Подписки — рекуррентная монетизация в Stars;
- Кастомизация загрузочного экрана;
- Расширенная информация об устройстве — для адаптации графики и производительности.
Обновление переводит часть UX-паттернов из мобильных ОС в Telegram, делая Mini App конкурентным интерфейсом для криптокошельков, игр и social-commerce.
Блокчейн-политика Telegram#
Telegram опубликовал рекомендации по работе с блокчейном в ботах и Mini Apps. Ключевые правила:
- использовать только TON для эмиссии и распространения токенов или блокчейн-активов;
- подключать кошельки только через TON Connect;
- не продвигать кошельки, которые не основаны на TON и не используют TON Connect.
Нарушение правил может привести к блокировке Mini App в каталогах Telegram.
Инструменты разработчика#
@twa-dev/sdkи@telegram-apps/sdk— официальные/комьюнити-SDK для работы с Telegram WebApp API;@tonconnect/ui-react— готовый UI-слой подключения кошелька внутри TMA;- Документация:
core.telegram.org/bots/webapps— спецификация WebApp API,docs.telegram-mini-apps.com— расширенная документация комьюнити,docs.ton.org/develop/dapps/telegram-apps/— гайд по интеграции от TON Foundation.