Where can I find the Telegram bot token?
A token is a secret key that allows Mini Apps Builder to connect your bot to the project. It is not your Telegram password or a link to the bot. You do not need to code to get it.
How to get a token if you don’t have a bot yet
Open the official BotFather. This is Telegram’s tool for creating and managing bots. Check the username carefully — it must be @BotFather, with no extra letters or numbers. The interface is the same on all platforms: Android, iOS, macOS, Windows, Linux, Web.
The next steps are performed in the BotFather chat: Click Start Bot,
You will see this message. Next, you can create a bot in two ways: through chat or Mini App.
Creating a new bot through chat
You need to select /newbot from the message sent by BotFather. Just click this text in the message, and it will immediately start the bot creation process.
BotFather will ask you what to name the app. This is the “name” of your bot/app that any user in Telegram will see. You can also change it later at any time.
After entering the “name,” BotFather will ask you to придумать username_bot — this is a unique ID, and it cannot be changed after creation. Telegram will also let you know if the username you entered is already taken.
After entering username_bot, you will see a message like this, which means the bot has been created. The message will contain the bot token. Just click it, and it will be copied, so you can paste it on our website.
The copied token must be pasted into the "Token" field when creating a project in Mini Apps Builder. After that, the project will be created.
Creating a new bot through Mini App
This is the second way to create a new bot and get a bot token. If you have already used the method above, you do not need to read this part.
Click the "Open" button in the bottom left, next to the text input field in the chat.
This screen will open. If you have never created bots before, the area under "My bots" will be empty. In any case, we are now covering the scenario of creating a new bot, so click the "Create a New Bot" button.
The highlighted fields are required. You can add the logo and "About" later at any time.
Bot Name is the name of your bot/app that any user in Telegram will see. You can also change it later at any time.
username_bot is a unique ID, and it cannot be changed after creation. Telegram will also let you know if the username you entered is already taken.
After entering Bot Name and username_bot, click the "Create Bot" button at the bottom of the screen.
You will see this screen, click the "Copy" button to copy your Bot Token for this bot.
After clicking the "Copy" button, you will briefly see a notification like this. It means you copied the token, and you can paste it on our website.
The copied token must be pasted into the "Token" field when creating a project in Mini Apps Builder. After that, the project will be created.
What to do if something doesn’t work
| Problem | What to do |
|---|---|
| The bot you need is not in the list | Check whether the Telegram account that owns the bot is open. If someone else created it, ask them who the owner is. |
| BotFather does not accept the username | Use Latin letters, numbers, and underscores, and add the bot ending. If the name is taken, придумайте другое. |
| Can’t send the command | Open the @BotFather chat specifically and send /mybots or /newbot in the message field. |
| Mini Apps Builder does not accept the token | Copy it again. Make sure you pasted the entire string without extra text or spaces. |
If the error persists, send Mini Apps Builder support the error text and describe the last step you completed. Do not attach the token itself. Hide it completely in the screenshot.
How to keep the token safe
The token gives access to bot management, so treat it like a password. Do not publish it or send it to anyone else. Enter the key only in the dedicated field of a service you trust to connect the bot.
