Customize Your Bot
10. Customizing Your Bot
You control how your bot looks and who can use it from Settings. On the desktop app, open ⚙ Settings; in the Mini App, open a bot and go to its settings. Both change the same bot, so use whichever is handy.
On the desktop, Settings has two areas: Privacy (who can use the bot) and Custom Messages (the texts your bot sends).
Arranging buttons
You arrange your menu buttons and set how many columns they use in the content viewer — by dragging tiles and using the density control. See Managing Your Content.
Privacy — who can use your bot
There are three options:
Public — Anyone who starts your bot can use it. No restrictions.
Whitelist — Only specific people you approve can use the bot; everyone else gets an "Unauthorized" message. You can allow:
- Individual people — by Telegram username (
@username) or numeric user ID. - A whole channel — add a channel and any member of it automatically gets access. Great for granting a whole community access without adding people one by one.
Private — Completely closed; only you, the owner, can use it. Useful for testing or while you're still setting things up.
Custom Messages
Change the text your bot sends in specific situations. Everything here is optional — leave a field empty to use the default.
| Message | When it is sent |
|---|---|
| Welcome | When a user starts your bot (/start). |
| Offline | When your bot is in offline mode and a user tries to use it. |
| Unauthorized | When someone not on the whitelist tries to use a private or whitelist-only bot. |
| Invalid Input | When a user sends something the bot doesn't recognize. |
| Menu Header | Shown at the top of every menu. Use {folder} and it's replaced with the current folder name. |
You can reset any field to its default.
Your bot token
If your token was leaked or revoked, you can reveal or rotate it. The desktop setup screen has a link to reconnect with a fresh token, and the Mini App can reveal/rotate the token from the bot's settings.
Need help with your token?
If you're unsure, contact Mariam Initiative support at telegram.me/blessed_tree and they'll guide you.