Telegram Mini Apps are web applications that open inside Telegram instead of in a separate browser. They are attached to a bot, launched with a tap, and can look and feel like part of the Telegram interface: a shop, a booking form, a game, a quiz or a dashboard, all without installing anything. Under the hood, a Mini App is a regular website built with HTML, CSS and JavaScript that talks to Telegram through a small JavaScript interface.
This guide explains how Mini Apps work for users, how developers build them, and what to watch out for when you open one.
How Mini Apps differ from regular bots
A classic Telegram bot communicates through messages: you send a command, it replies with text and maybe some buttons. That works for simple tasks, but gets clumsy for anything with many options, such as picking seats or filling a form. A Mini App replaces that back-and-forth with a full interface.
| Classic bot | Mini App | |
|---|---|---|
| Interface | Messages, commands, buttons | A full web page inside Telegram |
| Built with | Bot API calls from server code | Web technologies plus the bot behind it |
| Best for | Quick commands, notifications, moderation | Shops, forms, games, dashboards, multi-step flows |
| Where it runs | On the developer's server, shown as chat messages | In Telegram's built-in web view on your device, backed by the developer's server |
The two usually work together: the bot sends notifications and handles commands, while the Mini App handles anything visual.
How you open a Mini App
Developers can offer a Mini App from several places, so you may meet them in different ways:
- The menu button next to the message field in a bot's chat.
- An app button on the bot's profile, for bots that set a main Mini App.
- Buttons under messages, such as "Open store" or "Book now".
- Direct links in the form
t.me/botusername/appnamethat open the app straight away, often shared in groups and channels. - The attachment menu for certain apps that can be used in any chat.
When an app opens, it appears as a panel or full screen inside Telegram, adapted to your theme (light or dark). You can close it like any other screen.
What a Mini App can access
When you launch a Mini App, Telegram passes it some information so it can personalize the experience. This typically includes your Telegram user ID, name, username and language settings, plus details about how the app was opened. It does not get your phone number, your contacts or your chats automatically.
A Mini App can ask for more, but Telegram shows you a prompt first. Examples include sharing your phone number, letting the bot message you, or using device features that newer versions support. You can decline these requests.
Remember that a Mini App is a website run by whoever built it. Everything you type into it goes to that developer's servers, not to Telegram.
How developers build a Mini App
If you can build a website, you can build a Mini App. The basic process:
- Create a bot with @BotFather, which gives you a bot token. See how to create a Telegram bot with BotFather.
- Host a web app on an HTTPS URL. Any framework works, from plain HTML to modern JavaScript frameworks.
- Include Telegram's JavaScript file (
telegram-web-app.js), which exposes aTelegram.WebAppobject. It provides the launch data, theme colors, a main button at the bottom of the screen, a back button, haptic feedback and methods to close the app or send data back to the bot. - Connect the app to your bot in @BotFather, for example as the bot's menu button or as a named app with its own direct link.
- Validate the launch data on your server. The app receives a signed
initDatastring. Your backend must verify its signature with your bot token before trusting the user ID inside it. Skipping this step lets anyone impersonate any user.
Telegram's developer documentation covers the full interface, including theme parameters, viewport handling and newer capabilities such as full-screen mode.
Payments inside Mini Apps
Mini Apps can accept payments through the bot. For digital goods and services, Telegram requires payments in Telegram Stars, its in-app currency. Physical goods can use supported payment providers. Check the current rules in the official documentation before you build a paid feature, because they have changed over time.
Using Mini Apps safely
Most Mini Apps are legitimate, but the format is also popular with scammers, especially around crypto and "earn by tapping" games. Keep these rules in mind:
- Check the bot behind the app. Look for the official username from the company's website, not a lookalike shared in a group.
- Never enter your Telegram login code or two-step verification password in a Mini App. Telegram never asks for them there.
- Be careful connecting a crypto wallet. Approve only transactions you understand, and treat promises of guaranteed rewards as a red flag. Nothing here is financial advice. Our guide to crypto scams on Telegram lists common tricks.
- Think before sharing your phone number when an app asks for it.
- Watch for fake login pages. A Mini App that imitates a bank or another service is a phishing attempt; see how to avoid phishing links on Telegram.
Where Mini Apps are useful for communities
For group and channel owners, Mini Apps can add features that chat alone cannot: event sign-ups, member directories, quizzes with leaderboards, or a shop for a small business. A community might use a Mini App for registration and keep the group for discussion. If you want to see how others in your field use these tools, browse active communities in the technology section of the Grupla directory.
Frequently asked questions
Do I need to install anything to use a Telegram Mini App?
No. Mini Apps run inside the Telegram app you already have. Opening one is as simple as tapping a button or link.
Are Telegram Mini Apps made by Telegram?
Mostly not. Telegram provides the platform, but almost all Mini Apps are built and operated by independent developers and businesses.
Can a Mini App read my chats?
No. A Mini App receives basic profile information when you open it and anything you choose to enter or share. It cannot read your chats.