Что такое Telegram Mini App

Что такое Telegram Mini App

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

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

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

1. Кнопка меню — нажмите кнопку рядом с полем ввода сообщения в чате с ботом; она заменяет обычную иконку команд «/», если бот её включил.
2. Кнопка в клавиатуре или под сообщением — бот может прислать сообщение с кнопкой для открытия приложения; нажатие сразу запускает Mini App.
3. Меню вложений — нажмите на иконку скрепки в любом чате и выберите Mini App из списка, если бот добавил себя туда.
4. Прямая ссылка — откройте ссылку вида 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, поэтому само приложение никогда напрямую не работает с данными вашей карты.