To create a Telegram Mini App you need three things: a Telegram bot, a web app that lives at a public address, and a link between the two set up in @BotFather. Once they are connected, a tap on a button in the bot opens your web app inside Telegram, with the user already known and no download. This guide covers both ways to get there: building the web app yourself, step by step, and creating a Mini App store with a no-code builder, where the web app, the hosting and the checkout are done for you.
Quick answers (2026)#
- How do I get started with a Telegram Mini App? Create a bot in @BotFather with
/newbot, put your web app online at an HTTPS address, and attach that address to the bot as its menu button or as its Main Mini App. Add Telegram'stelegram-web-app.jsscript to the page so it can read the user, the theme and the main button. - How much does Telegram Mini App development cost? Telegram charges nothing for the bot or for attaching a Mini App. A custom build costs whatever the development, hosting and upkeep cost for your scope. A no-code builder replaces that with a plan: Tiny Shops starts at $0 a month, with 7% per order after your first $100 in sales.
- What are the hosting requirements for a Telegram Mini App? A public HTTPS address that Telegram loads every time the app opens, plus a server that checks the
initDatasignature (HMAC-SHA-256 with a key derived from your bot token) before it trusts the user. The frontend can sit on any static host; the check has to run on your server. - How does payment integration work in a Telegram Mini App? Digital goods and services must be paid in Telegram Stars (currency
XTR). Physical goods can be paid through payment providers via Telegram's Payments API, or through an outside checkout such as Stripe. Per Telegram's developer terms, a seller receives about $0.013 per Star in rewards. - Where is the official Telegram Mini Apps documentation? Mini Apps: core.telegram.org/bots/webapps. Payments in Stars: core.telegram.org/bots/payments-stars. The Bot API: core.telegram.org/bots/api.
- What are the best practices for a Telegram Mini App? Check
initDataon the server, follow the user's Telegram theme colors, put the main action on Telegram's main button, keep the first screen fast on mobile data, and test inside Telegram on a phone, not only in a desktop browser. - What are some Telegram Mini App examples? Online stores with a catalog and cart (Telegram's own demo is @DurgerKingBot), booking for salons and classes, games such as Hamster Kombat, the @wallet crypto wallet, and courses or subscriptions sold for Stars.
If you are still deciding whether a Mini App is worth it for your business and what it costs, read Telegram Mini Apps for business first. This page is about the build.
What a Telegram Mini App is#
A Telegram Mini App is a web page (HTML, CSS and JavaScript) that Telegram opens in its own in-app window instead of a browser. Telegram passes the page the user's identity, the color theme and the language, and gives it native controls such as a main button and haptic feedback. Every Mini App is attached to a bot, and the bot is how people find it.
Telegram's Mini Apps documentation lists seven ways to launch one:
- a menu button next to the message field in the bot chat;
- a keyboard button or an inline button under a bot message;
- the Main Mini App, which opens from the bot's profile and from a link like
t.me/yourbot?startapp; - a direct link like
t.me/yourbot/appname; - inline mode and the attachment menu.
A shop usually needs only two of them: the menu button in the bot, and links that open the store straight from a channel post or a bio.
Two ways to create a Telegram Mini App#
| Build it yourself | Use a no-code builder | |
|---|---|---|
| What you make | The whole web app: screens, cart, admin, backend | Only your content: products, prices, branding |
| Skills you need | Frontend, backend, the Telegram Bot API | None |
| Hosting | Yours to run and pay for | Included |
| Checking the user's identity | You validate Telegram's data on your server | Done for you |
| Payments | You integrate each provider | Connected from the dashboard |
| Time to first order | Weeks, depending on scope | The same day |
| Best for | A product nobody has built: a game, a custom tool | A shop, a catalog, a storefront |
If what you need is a store, a builder saves you rebuilding a catalog, a cart and a checkout that already exist. If your idea is something new, the code path below is the one.
How to create a Telegram Mini App with code#
- Create a bot. Open @BotFather, send
/newbot, pick a display name and a username ending inbot, and copy the token. Keep the token secret: whoever has it controls the bot. The full walkthrough is in how to make a Telegram bot. - Build the web app. Any frontend stack works, because a Mini App is a web page. Add Telegram's
telegram-web-app.jsscript to the page head so your code can reachwindow.Telegram.WebApp: the user, the theme colors, the main button. - Put it online. Deploy the app to a server or static host so it has a public web address. Telegram loads it from there each time someone opens it.
- Attach it to the bot. In @BotFather, set a menu button (
/setmenubutton, or Bot Settings β Menu Button) with your app's address. To get the Main Mini App andt.me/yourbot?startapplinks, go to /mybots β your bot β Bot Settings β Configure Mini App β Enable Mini App. - Check who the user is on your server. Telegram sends the app
initDatawith a hash. Before you trust it, recompute the HMAC-SHA-256 signature on your server with a key derived from your bot token, as the documentation describes. Never trust the user ID the browser sends without that check. - Add payments. Telegram's rules split goods in two. For digital goods and services, payments must be made in Telegram Stars (currency
XTR). Physical goods and services can use other currencies and payment providers. - Test it in Telegram. Open the bot on your phone, tap the menu button, and walk through the flow you built, payment included.
After launch you still own the hosting, the updates, the admin screens for orders and products, and every new payment method.
How to create a Telegram Mini App store in Tiny Shops#
Tiny Shops is a no-code Telegram Mini App shop builder: it hosts the storefront, the cart and the checkout, and gives you a dashboard to run them. Setup is a short wizard.
- Start at tiny-shops.com. The first question is What is the shop called? Buyers see this name, and your store address starts with it.
- Pick the format. Under Where will you sell?, choose Mini app storefront (catalog, cart and card payments inside Telegram). The other option, In a Telegram chat, is for selling in chat without a storefront.
- Choose how you take payment. Under How will you take payment?: Manual (you mark orders as paid yourself), Stars, Card (connect Stripe after launch) or Local payments (Indonesia, the Philippines and Malaysia). You can change this later.
- Connect a bot. Pick Create it for me, and Telegram creates the bot on your account with no BotFather and no token, or pick I already have one and paste the token from @BotFather.
- Launch. Press Create store and open dashboard. Tiny Shops connects the bot and gives it an Open Shop menu button that opens your storefront.
- Add products. Go to Products β Add Product: photos, a name, a description and a price. Products can also come from a Google Sheet.
- Turn on the Main Mini App. This is the one step only BotFather can do. The Telegram bot page shows the exact steps and the link to paste: open @BotFather, send
/mybots, choose your bot, then Bot Settings β Configure Mini App β Enable Mini App. After that, product links in your posts open the store directly instead of the bot chat. - Connect online payments. Stripe (cards, Apple Pay and Google Pay inside the Mini App), Telegram Stars, TON, Xendit and others. Each method and its setup is in Telegram payment methods.
- Share the store. Post the link in your channel, pin it, put it in your bio. Every buyer who opens the bot can later get your broadcasts.
The whole storefront, from the catalog to the order confirmation, is built from these settings. You don't write or host any code.
What to check after launch#
- Place a test order yourself. Open the bot on your phone, buy something cheap, and see the order arrive in Orders.
- Open a product link from a channel post. If it opens the bot chat instead of the store, the Main Mini App is still off.
- Watch the first week's numbers. The dashboard home shows visitors, new customers, orders and revenue, so you can see where people drop off.
Limits to know#
- Digital goods are paid in Stars. That is Telegram's rule for any Mini App, not a Tiny Shops one.
- The Main Mini App is set in BotFather only. No platform can switch it on for you; Tiny Shops checks it and shows you the steps.
- A builder fixes the layout. You choose the theme, colors and logo from the dashboard, but you can't add your own code to the storefront. If you need a completely custom app, take the code path.
- Your own domain is a Pro and Scale feature. Every store works on its included
tiny-shops.comaddress; see how to add a custom domain.
FAQ#
Is it free to create a Telegram Mini App? Creating a bot in @BotFather costs nothing. With code, you pay for development and hosting. On Tiny Shops, the Free plan is $0 a month: each order pays 7% after your account's first $100 in sales, which are commission-free once (not every month). Full prices are on the pricing page.
Do I need to know how to code? Only if you build the web app yourself. With a builder you fill in products and settings, and the Mini App is generated for you.
What language are Telegram Mini Apps written in?
They are web apps: HTML, CSS and JavaScript, with any framework you like. The server side can be written in any language that can check Telegram's initData signature.
Can a Telegram Mini App accept payments? Yes. Digital goods and services are paid in Telegram Stars. Physical goods can be paid through payment providers such as Stripe. A Tiny Shops store can also take cash or bank transfer and mark the order as paid by hand.
How do people open my Mini App?
From the menu button in your bot, from a link like t.me/yourbot?startapp once the Main Mini App is on, or from buttons in your messages and posts.
Create your Telegram Mini App store at tiny-shops.com β
Read next#
- Telegram Mini Apps for business: what businesses use them for and what one costs, custom vs builder.
- How to make a Telegram bot: the BotFather walkthrough in full.
- Telegram payment methods: Stars, Stripe, TON and local payments, and how to connect each.
- Telegram store bot: how to set one up: the full launch checklist.
- How to run multiple Telegram shops: a second Mini App brand on one login.
