Telegram Mini App: что это и когда он нужен

Что такое Mini App

Это обычный сайт (адрес по HTTPS), который Telegram показывает во встроенном окне поверх чата. Его открывают кнопкой в боте, меню, ссылкой или из канала. Пользователю не нужно ничего устанавливать, а интерфейс может быть таким же гибким, как у мобильного приложения.

Чем отличается от бота и сайта

• От бота: вместо сообщений и кнопок под ними здесь полноценный интерфейс: экраны, анимации, фильтры, корзина.
• От сайта: пользователь уже авторизован через Telegram, не вводит логин и пароль, приложение знает его имя и язык, может отправлять ему уведомления через бота.

Как это устроено технически

1. Вы создаёте бота в @BotFather и указываете адрес приложения.
2. Пользователь открывает приложение. Telegram передаёт в страницу данные о нём и подпись.
3. Ваш сервер проверяет подпись (initData) и только после этого доверяет идентификатору пользователя.
4. Приложение работает с вашим API и базой данных.
5. Уведомления и общение продолжает бот.

Что умеет Mini App

• Показывать интерфейс любой сложности: каталоги, кабинеты, дашборды, календари.
• Подстраиваться под тему Telegram (светлая, тёмная) и размер окна.
• Использовать нативные элементы: главную кнопку, подтверждения, вибрацию, кнопку «Назад».
• Принимать платежи через Telegram Stars или платёжных провайдеров.
• Открывать ссылки, делиться материалами, запрашивать номер телефона по согласию пользователя.

Для каких задач подходит

• Магазин и витрина с фильтрами и корзиной.
• Личный кабинет: баланс, история операций, подписка.
• Сервис с многошаговой формой: запись, заявка, калькулятор.
• Панель управления для сотрудников или партнёров.
• Сервисы с высокой ценой ошибки: обмен, финансы (нужна особая аккуратность и соблюдение законов).

Ограничения и подводные камни

• Нет поискового трафика. Страницы Mini App не индексируются как сайт. Для поиска нужен отдельный сайт.
• Доступность хостинга. Приложение — веб-страница, и её должны открывать ваши пользователи. Некоторые зарубежные платформы недоступны в части регионов, это нужно проверить до выбора.
• Скорость. Тяжёлое приложение на слабом телефоне будет тормозить, поэтому важны лёгкий код и оптимизация.
• Правила Telegram. Есть требования к оплате цифровых товаров и контенту, их нужно учитывать.
• Цифровые товары — только Stars. Если продаёте цифровой контент или услугу внутри Mini App, Telegram требует оплату через Stars; сторонний провайдер как единственный способ здесь может нарушать правила платформы. На физические товары это ограничение не действует.

С чего начать

Сформулируйте главный сценарий, ради которого пользователь откроет приложение. Часто выгоднее сделать версию на 2–3 экрана, чем полноценное приложение сразу. Подробнее о том, когда выбрать Mini App, а когда достаточно бота или сайта: «Бот, сайт или Mini App».

Частые вопросы