How to create a Telegram mini app without a developer
A mini app is an interface that opens inside Telegram itself: nothing to download, nothing to install, launched from a chat by a button in the bot menu. Here is what it takes, in what order, and where people usually trip.
What a mini app is, and what it is not
Technically it is a web page the messenger opens full-screen inside itself, signing the data about who opened it. Two things follow that a website does not have: the person is already identified, so no password is needed, and the app is always at hand, because the messenger is open anyway.
What it is not is a website. A published mini app works in Telegram and MAX; opened in a browser it shows an explanation and a way to the owner’s bot. That holds on a custom domain too, so search traffic into the app itself is not something to count on.
What you need before you start
You need a bot — the one whose menu will carry the button. It is created with @BotFather via /newbot in a minute, and all you need from it is one line: a token like 123456789:AA... There is nothing else to do in BotFather, because the platform sets the menu button itself, calling Telegram with your token.
You do not need a server, a domain or a certificate: a published app lives at the address it is given, and HTTPS and updates are on our side. You do not need a designer on day one either: a template opens assembled and working, and swapping its text and prices is an evening’s work.
How screens are assembled
A screen is built from blocks: a heading, an image, a list, a form, a button. A list is not drawn by hand but from a table inside the app — add rows and the repeater shows them as cards. That is why "add a product" or "add a service" later means adding a row from a phone rather than calling whoever built the layout.
Transitions hang on buttons, on items in the bottom menu and on icons in the header. One rule worth keeping in mind: every screen must have at least one way in, or nobody will ever reach it — the editor marks such a screen with a "no way in" badge.
The form is usually the whole point. Its fields are yours to define, and a submission reaches the owner in Telegram at that moment and stays in the submissions archive in the editor. A file up to 10 MB can be attached: a photograph, a PDF, a document.
Publishing, and what happens next
Publishing is one button. After it the app gets an address and the bot gets an Open button in its menu; from then on it works for anyone you give the bot link to. Updates publish the same way: the address does not change, people simply get the new version.
Building and previewing is free with no time limit. A plan is needed at the moment of publishing: three days of trial from the first publish, then a paid plan — otherwise the app stops opening for visitors, though the project stays intact and comes back the moment anything is paid.
Step by step
- 1Create a bot with @BotFather via /newbot and copy the token.
- 2Open the builder and take a template close to your trade.
- 3Replace the content with your own: table rows, text, photographs, prices.
- 4Check that every screen has a way in, and set the form fields.
- 5Paste the bot token in the editor and press Publish.
Other questions
- How long does it actually take?
- A first working version from a template takes an evening: most of the time goes on writing your own text and gathering photographs rather than on assembly. Starting from an empty project takes longer, which is why we suggest a template.
- Do I need to know HTML or JavaScript?
- No. Screens are assembled from blocks, data lives in tables and transitions hang on buttons. There is no code in the editor at all.
- What if my bot already has a menu button?
- It will be repointed at your app: the platform calls Telegram with your own token. A previous address set by hand will stop opening from the menu.