On this page
The essentials
- A Mini App is a web app that opens right inside Telegram, with nothing to install and no sign-up.
- It is made by a third-party developer, not by Telegram. The familiar frame does not make its contents part of Telegram.
- On launch the app receives your name, username, language and ID, and your photo if your privacy settings allow. Anything else it must ask for.
- Digital goods inside Telegram are paid for with Stars, physical goods by card through a payment provider, crypto by connecting a wallet.
- Before paying, check the bot the app belongs to, and read the payment screen or wallet request in full.
A friend sends a link to a game. One tap, and in the middle of your chat a window opens with a map, buttons and your name in the corner. Nothing to download, no password to invent, and a minute later the app offers you a hint for 50 Stars.
That is a Telegram mini app. Inside it there may be a game, a shop, an exchange, a table booking or a wallet. From the outside it always looks the same: the familiar Telegram frame, the usual Close button, a payment screen that already knows your account.
That sameness creates the illusion that the inside is Telegram too. In fact it is someone else's website, which Telegram has simply shown you conveniently.
- 7 ways
- To open a mini app: from a button on a bot's profile to a direct link.
The basics
A mini app in one minute
A Mini App is a web app that runs inside Telegram. A third-party developer writes it, and Telegram gives it a window, user data for signing in without registration, payments and notifications.
Every mini app belongs to a bot. The bot is its "passport": it has a name, a description and, with luck, a verification mark. That bot is what to judge it by.
Comparison
Bot, mini app and website
Bot | Mini App | Ordinary website | |
|---|---|---|---|
Where it runs | In a chat, through messages and buttons | In a window inside Telegram | In a browser |
Sign-up needed | No | No: Telegram passes on sign-in data | Usually yes |
What it knows about you on opening | What you have written to the bot | Name, username, language, ID | Nothing until you sign in |
How you pay | With Stars or through a provider | With Stars, through a provider, crypto through a wallet | However the site decides |
Who is responsible for the content | The bot's developer | The app's developer | The site's owner |
Ways in
How mini apps open
According to Telegram's documentation, there are seven:
- the launch button on a bot's profile (the main mini app);
- the menu button in a chat with the bot;
- a button under a bot's message;
- a button on the bot's keyboard;
- a result from the bot's inline search in any chat;
- a direct link such as t.me/botname/app or t.me/botname?startapp;
- the attachment menu, if you have added the bot there.
A mini app can go full screen and get a shortcut on your phone's home screen. That does not make it a separate program: it is still a website in a Telegram frame.
Data
What the app learns about you immediately
On launch, Telegram passes the mini app some basic details: your ID, name, username and interface language, whether you have Premium, and your profile photo if your privacy settings allow it. If the app is opened in a chat, it can also learn which chat that is.
Everything else — your phone number, location, permission to message you, access to biometrics — the app has to request separately, and you will see the request. What each request means and how to revoke access is covered in "Mini app permissions".

Money
How you pay in mini apps
What you buy | How you pay | What to know |
|---|---|---|
Digital items inside the app: hints, subscriptions, items | Telegram Stars | Refunds are up to the developer; bots have a /paysupport command for that |
Physical goods and services | By card through a payment provider | The developer connects the provider, and its terms apply |
Crypto, tokens, NFTs | With a connected wallet through TON Connect | Every action is a separate wallet request, and it needs reading |
Stars are bought in Telegram itself, and how to do that more cheaply and without resellers is covered in "How to buy Telegram Stars". If the developer fails to deliver a purchase, Telegram's terms let you send the bot /paysupport and, if refused, report it through Telegram's form with the transaction ID from Your Stars.
A wallet is a separate story. Connecting it authorises nothing, but the next request may ask to transfer your whole balance. How to read the confirmation screen: "Connecting a wallet to an app".
Responsibility
Who is behind it
Telegram does not write mini apps. The developer is responsible for the content, prices and refunds, while Telegram provides the window it all opens in, the sign-in and the payment methods.
Successful mini apps that accept payment in Stars may be featured in the Telegram Mini App Store. Being featured is a sign of popularity, not a guarantee of honesty.
Check
Before your first payment
Questions
Is it safe to open a mini app?
Opening one passes on only basic details: your name, username, language and ID. The risks start with requests and payments, so read every one of them.
Can I get back Stars I spent in a mini app?
If the purchase was not delivered, message the bot /paysupport. Under Telegram's terms the developer can refund Stars without penalty, and if they refuse you can report it through Telegram's form.
How is a mini app different from an ordinary link to a website?
A link opens a website in your browser, and it knows nothing about you. A mini app opens inside Telegram and immediately receives your account's basic details, so it can do without a sign-up.
Mini apps turned Telegram into a platform: inside the messenger you can now play, shop, book and manage money. The price of that convenience is that the familiar Telegram frame surrounds someone else's code.
Treat a mini app as a website you showed your passport to at the door. Check who made it, and read every request and every payment screen before you agree.


