Что такое Telegram Mini App: полный гайд

Что такое Telegram Mini App

Telegram Mini App — это веб-приложение на обычных веб-технологиях (HTML, CSS, JavaScript), которое открывается прямо внутри окна Telegram, а не в браузере, и поэтому выглядит и ощущается как часть самого мессенджера. Разработчик бота регистрирует адрес приложения через @BotFather, и дальше Telegram открывает его во встроенном WebView — по кнопке, через меню чата или по прямой ссылке, — не выходя из интерфейса Telegram.

Как открыть Mini App

Есть четыре типичных способа запуска, и один бот может предлагать сразу несколько:

Кнопка меню — нажмите кнопку рядом с полем ввода сообщения в чате с ботом; она заменяет обычную иконку команд «/», если бот её включил.
Кнопка в клавиатуре или под сообщением — бот может прислать сообщение с кнопкой для открытия приложения; нажатие сразу запускает Mini App.
Меню вложений — нажмите на иконку скрепки в любом чате и выберите Mini App из списка, если бот добавил себя туда.
Прямая ссылка — откройте ссылку вида t.me/имя_бота/имя_приложения, полученную от кого-то или найденную в каталоге; Telegram откроет Mini App так же.

Точное расположение кнопки или иконки немного отличается на iOS, Android и в Desktop-версии: если не нашли её в одном интерфейсе, проверьте меню рядом с полем ввода или иконку вложений в другом — сами способы запуска везде одинаковые, меняется только их расположение на экране.

Категории Mini Apps

Mini Apps закрывают широкий круг задач, для которых раньше требовалось отдельное приложение или сайт:

Игры — собственные HTML5-игры Telegram работают именно так: открытие игры из сообщения и нажатие Play запускает такой же WebView.
Финансы и кошельки — @wallet — это Mini App для хранения и отправки TON, токенов на его основе и USDT, не выходя из Telegram.
Покупки и маркетплейсы — витрины, где можно просмотреть каталог и оформить заказ прямо в чате.
Продуктивность и утилиты — калькуляторы, конвертеры и панели, которым нужен полноценный интерфейс, а не обмен сообщениями.
Викторины и интерактивный контент — опросы и интерактивные форматы с кнопками, формами и версткой, недоступной обычному текстовому сообщению.

Любой бот может сочетать Mini App с обычными командами и inline-режимом — приложение используется только там, где нужен более богатый интерфейс, чем обычный пузырёк сообщения.

Оплата внутри Mini App через Telegram Stars

Telegram Stars — собственная внутренняя валюта платформы, и многие Mini Apps принимают оплату именно ей вместо формы для карты. Вы покупаете Stars один раз — через платёжный экран самого Telegram или из баланса в Настройках, — а дальше Mini App может запросить сумму, ни разу не увидев данные вашей карты: сам перевод проводит и хранит Telegram, а вы подтверждаете счёт одним нажатием. Часть Mini Apps по-прежнему поддерживает и обычное пополнение картой через встроенные платежи Telegram, если разработчик это настроил, но именно Stars Telegram продвигает для цифровых товаров и контента.

Что видит Mini App, а что нет

Mini App работает в изолированном WebView, а не с уровнем доступа самого клиента Telegram:

Ему видны данные, которыми вы сами делитесь: имя в Telegram, username, ID пользователя, язык интерфейса и всё, что вы вводите или загружаете внутри самого приложения.
Он не может читать историю переписки, контакты или сообщения в других чатах, если вы сами не передали эту информацию через интерфейс приложения.
Платежи через Stars проходят через собственный платёжный механизм Telegram, поэтому Mini App никогда напрямую не видит номер карты или банковские данные.
Как и обычный сайт, он может быть сделан небрежно или недобросовестно: относитесь к запросам лишних разрешений, внешним логинам и необычным просьбам о данных с той же осторожностью, что и на любом стороннем сайте, и открывайте Mini Apps только у ботов, которым доверяете.

Вопросы и ответы

Нужно ли что-то устанавливать, чтобы пользоваться Mini App? Нет. Приложение открывается прямо внутри Telegram по нажатию кнопки или ссылки — скачивать отдельное приложение или заводить новый аккаунт не нужно, хватает существующего аккаунта Telegram.

Может ли Mini App написать мне или добавить меня в группу без спроса? Нет. Mini App действует только в рамках разрешений, которые вы даёте внутри его собственного интерфейса; отправка сообщений от вашего имени или вступление в группы по-прежнему требует вашего явного действия через бота.

Telegram Stars — это настоящие деньги? Stars — собственная валюта Telegram, которую покупают за реальные деньги через платёжный экран Telegram и тратят только внутри Telegram, например на контент в Mini App, поэтому само приложение никогда напрямую не работает с данными вашей карты.