Друг присылает ссылку на игру. Одно касание — и посреди переписки открывается окно с картой, кнопками и вашим именем в углу. Ничего не нужно скачивать, не нужно придумывать пароль, а через минуту приложение предлагает купить подсказку за 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 передаёт базовые данные мини-приложению; сайт и сервер разработчика отделены границей доверия.
Схема слева направо. Запуск передаёт базовые данные мини-приложению разработчика. Номер, геопозиция и другие дополнительные права требуют отдельного запроса.

Деньги

Как в мини-приложениях платят

Что покупаете

Чем платите

Что важно знать

Цифровое внутри приложения: подсказки, подписки, предметы

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 окружает чужой код.

Относитесь к мини-приложению как к сайту, которому вы показали паспорт на входе. Проверьте, кто его сделал, и читайте каждый запрос и каждый экран оплаты, прежде чем согласиться.