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".

Telegram passes basic data to a mini app; the developer’s site and server sit beyond a trust boundary.
Read the diagram from left to right. Launch shares basic data with the developer’s mini app. Phone number, location and other extra permissions need a separate request.

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.