Содержание статьи
Коротко о главном
- Mini App — веб-приложение, которое открывается прямо в Telegram, без установки и регистрации.
- Его делает сторонний разработчик, а не Telegram. Знакомая рамка не делает содержимое частью Telegram.
- При запуске приложение получает ваше имя, юзернейм, язык и ID, а фото — если позволяют настройки приватности. Остальное оно должно запросить.
- Цифровые товары внутри Telegram оплачивают звёздами, физические — картой через платёжного провайдера, криптовалюту — через подключение кошелька.
- Перед оплатой проверьте бота, к которому привязано приложение, и прочитайте экран оплаты или запрос кошелька целиком.
Друг присылает ссылку на игру. Одно касание — и посреди переписки открывается окно с картой, кнопками и вашим именем в углу. Ничего не нужно скачивать, не нужно придумывать пароль, а через минуту приложение предлагает купить подсказку за 50 звёзд.
Так выглядит мини-приложение Telegram. Внутри него может быть игра, магазин, обменник, бронирование столика или кошелёк. Снаружи оно всегда одинаковое: знакомая рамка Telegram, привычная кнопка «Закрыть», оплата, которая уже знает ваш аккаунт.
Эта одинаковость и создаёт иллюзию, будто внутри тоже Telegram. На деле внутри чужой сайт, который Telegram просто показал вам удобно.
- 7 способов
- Открыть мини-приложение: от кнопки в профиле бота до прямой ссылки.
Суть
Мини-приложение за минуту
Mini App — веб-приложение, которое запускается внутри Telegram. Его пишет сторонний разработчик, а Telegram даёт ему окно, данные о пользователе для входа без регистрации, оплату и уведомления.
Каждое мини-приложение привязано к боту. Бот — его «паспорт»: у него есть имя, описание и, если повезёт, отметка верификации. По этому боту и стоит судить, кто перед вами.
Сравнение
Бот, мини-приложение и сайт
Бот | Mini App | Обычный сайт | |
|---|---|---|---|
Где работает | В чате, сообщениями и кнопками | В окне внутри Telegram | В браузере |
Нужна регистрация | Нет | Нет: Telegram передаёт данные для входа | Обычно да |
Что знает о вас при открытии | То, что вы написали боту | Имя, юзернейм, язык, ID | Ничего, пока не войдёте |
Как платить | Звёздами или через провайдера | Звёздами, через провайдера, криптой через кошелёк | Как решит сайт |
Кто отвечает за содержимое | Разработчик бота | Разработчик приложения | Владелец сайта |
Входы
Как открываются мини-приложения
По документации Telegram, способов семь:
- кнопка запуска в профиле бота (главное мини-приложение);
- кнопка меню в чате с ботом;
- кнопка под сообщением бота;
- кнопка на клавиатуре бота;
- результат встроенного поиска бота в любом чате;
- прямая ссылка вида t.me/имя_бота/приложение или t.me/имя_бота?startapp;
- меню вложений, если вы добавили туда бота.
Мини-приложение можно развернуть на весь экран и вынести ярлыком на главный экран телефона. От этого оно не становится отдельной программой: это по-прежнему сайт в рамке Telegram.
Данные
Что приложение узнаёт о вас сразу
При запуске Telegram передаёт мини-приложению базовые сведения: ваш ID, имя, юзернейм и язык интерфейса, отметку о Premium, а фотографию профиля — если это позволяют ваши настройки приватности. Если приложение открыто в чате, оно может узнать и что это за чат.
Всё остальное — номер телефона, геопозицию, право писать вам сообщения, доступ к биометрии — приложение должно запросить отдельно, и вы увидите запрос. Что значит каждый такой запрос и как отозвать доступ, разобрано в статье «Разрешения мини-приложений».

Деньги
Как в мини-приложениях платят
Что покупаете | Чем платите | Что важно знать |
|---|---|---|
Цифровое внутри приложения: подсказки, подписки, предметы | Telegram Stars | Возврат решает разработчик; для этого у ботов есть команда /paysupport |
Физические товары и услуги | Картой через платёжного провайдера | Провайдер подключён разработчиком, условия — его |
Криптовалюта, токены, NFT | Подключённым кошельком через TON Connect | Каждое действие — отдельный запрос в кошельке, его надо читать |
Звёзды покупаются в самом Telegram, и как сделать это дешевле и без перекупщиков, разобрано в статье «Как купить Telegram Stars». Если разработчик не выполнил покупку, по условиям Telegram можно написать боту /paysupport, а при отказе — пожаловаться через форму Telegram, приложив номер транзакции из «Ваших звёзд».
С кошельком отдельная история. Подключение само ничего не разрешает, но следующий запрос может попросить перевод всего баланса. Как читать экран подтверждения — в статье «Подключить кошелёк к приложению».
Ответственность
Кто за этим стоит
Telegram не пишет мини-приложения. За содержимое, цены и возвраты отвечает разработчик, а Telegram даёт окно, в котором всё это открылось, вход и способы оплаты.
Успешные мини-приложения, которые принимают оплату в звёздах, могут попасть в витрину Telegram Mini App Store. Попадание в витрину — знак популярности, а не гарантия честности.
Проверка
Перед первой оплатой
Вопросы
Безопасно ли открывать мини-приложение?
Открытие само по себе передаёт только базовые сведения: имя, юзернейм, язык и ID. Риски начинаются с запросов и оплаты, поэтому читайте каждый из них.
Можно ли вернуть звёзды, потраченные в мини-приложении?
Если покупку не выполнили, напишите боту /paysupport. По условиям Telegram, разработчик может вернуть звёзды без штрафа, а при отказе можно пожаловаться через форму Telegram.
Чем мини-приложение отличается от обычной ссылки на сайт?
Ссылка открывает сайт в браузере, и он ничего о вас не знает. Мини-приложение открывается в Telegram и сразу получает базовые данные вашего аккаунта, поэтому может обойтись без регистрации.
Мини-приложения сделали Telegram платформой: внутри мессенджера теперь можно играть, покупать, бронировать и вести финансы. Цена этого удобства в том, что знакомая рамка Telegram окружает чужой код.
Относитесь к мини-приложению как к сайту, которому вы показали паспорт на входе. Проверьте, кто его сделал, и читайте каждый запрос и каждый экран оплаты, прежде чем согласиться.


