What is a Telegram Mini App

What Is a Telegram Mini App?

A Telegram Mini App is a website built with standard web technology (HTML, CSS, JavaScript) that opens inside Telegram's own window instead of a browser tab, so it looks and feels like part of the app. A bot's developer registers the web address with @BotFather, and Telegram then opens it in a built-in WebView triggered from that bot — through a button, the chat's menu, or a direct link — without ever leaving the Telegram interface.

How to Open a Mini App

There are four common entry points, and any bot can offer more than one:

1. Menu button — tap the button next to the message field inside a bot's chat; it replaces the usual "/" commands icon when the bot has enabled it.
2. Keyboard or inline button — some bots send a message with a button labeled to open the app; tapping it launches the Mini App directly.
3. Attachment menu — tap the paperclip or attachment icon in any chat and pick the Mini App from the list, if the bot has added itself there.
4. Direct link — open a t.me/botname/appname-style link shared by someone or found in a catalog; Telegram opens the Mini App the same way.

Where exactly the button or icon sits differs a little between iOS, Android, and Telegram Desktop, so if you can't find it in one interface, check the menu next to the message field or the attachment icon in the others — the entry points themselves are the same, only their placement shifts.

Categories of Mini Apps

Mini Apps cover a wide range of tasks that would normally need a separate app or website:

• Games — Telegram's own HTML5 games run this way; opening one from a message and pressing Play launches the same kind of WebView.
• Finance and wallets — @wallet is a Mini App for holding and sending TON, Toncoin-based tokens, and USDT without leaving Telegram.
• Shopping and marketplaces — storefronts that let you browse a catalog and check out inside the chat.
• Productivity and utility tools — calculators, converters, and dashboards that need a real interface rather than a chat exchange.
• Quizzes and interactive content — surveys or interactive experiences with buttons, forms, and layouts a plain text message can't offer.

Any bot can combine a Mini App with regular commands and inline mode; the Mini App is just used for the parts of the experience that need a richer interface than a chat bubble.

Paying Inside a Mini App with Telegram Stars

Telegram Stars are the platform's own in-app currency, and many Mini Apps use them instead of a card form. You buy Stars once, through Telegram's own payment screen or from your balance in Settings, and afterward the Mini App can request an amount without ever seeing your bank details — Telegram holds and transfers the payment, and it appears to you as an invoice you confirm with a single tap. Some Mini Apps still support a regular card top-up through Telegram's built-in payments if the developer set that up, but Stars is the option Telegram pushes for digital goods and content.

What a Mini App Can (and Can't) See

A Mini App runs inside a sandboxed WebView, not with the access level of the Telegram client itself:

• It can see the data you actively share with it: your Telegram name, username, user ID, language, and whatever you type or upload inside the app.
• It cannot read your chat history, contacts, or messages in other conversations unless you explicitly send that information through the app's own interface.
• Payments made with Stars go through Telegram's own payment flow, so a Mini App never sees your card number or bank details directly.
• Like a website, it can still be built poorly or maliciously — treat requests for extra permissions, external logins, or unusual data with the same caution you'd use on any external site, and only open Mini Apps from bots you trust.

FAQ

Do I need to install anything to use a Mini App? No. It opens inside Telegram the moment you tap the button or link — there's no separate app to download or account to create beyond your existing Telegram account.

Can a Mini App message me or add me to a group without asking? No. A Mini App can only act within the permissions you grant inside its own interface; sending messages on your behalf or joining groups still requires your explicit action through the bot.

Are Telegram Stars real money? Stars are Telegram's own currency, bought with real money through Telegram's payment screen and spent only inside Telegram on things like Mini App content, so a Mini App never handles your card details directly.