Telegram Bot Commands, Menus and Onboarding Flows
· 4 min read · 18+ readers

A bot succeeds or fails in the first thirty seconds. If a new person understands what it does and gets what they came for in two taps, they stay. If they face a wall of text or unclear options, they leave. This guide covers the building blocks of a good bot flow: the start message, commands, buttons and fallbacks. It applies whether you code the bot or use a builder. Adults 18+, safe for work examples.
The building blocks
- Start message: what people see after pressing Start.
- Commands: slash words like
/helpthat appear in the menu. - Inline buttons: buttons under a message that trigger actions or open links.
- Reply keyboards: buttons replacing the keyboard for quick choices.
- Menu button: a button near the input box that opens commands or a Mini App.
- Deep links: links like
t.me/yourbot?start=instagramthat let you know where someone came from.
Design the first screen
A good start message has four parts:
- Who the bot is and what it does in one line.
- A short promise: "Get my links, ask a question or see what is new."
- Three to five buttons.
- A note about being a bot and 18+ where relevant.
Example: "Hi, I am the assistant for Mia. I can share her links, answer common questions and pass messages on. This is an 18+ space. What would you like?" Buttons: Links, FAQ, Latest post, Talk to Mia.
Keep commands few and clear
Register commands with BotFather so they show in the menu. A typical set:
/startwelcome./linksyour main links./helphow to use the bot./contactreach a human./stopstop receiving messages.
Use plain words. Avoid commands that need arguments if a button can do it.
Buttons over typing
On a phone, tapping beats typing. Use inline buttons for most choices. Keep labels short (a few words) and limit rows to two or three buttons. Put the most common choice first.
Handle unexpected messages
People will type things your bot does not expect. Plan for it:
- Show a friendly message: "I did not understand that. Choose an option below or tap Talk to Mia."
- Do not loop forever. After two misses, offer a human.
- If the bot uses AI for free text, set guardrails. See writing a persona prompt.
Tracking where people come from
Deep link parameters let you tag the source: ?start=ig, ?start=tiktok, ?start=reddit. Your bot reads the value and records it, so you can compare sources. Use short, neutral tags. See link in bio tools and the traffic guides, for example Instagram to Telegram.
Language and tone
- Match the language of your audience, and offer a language switch if needed.
- Keep a consistent voice that sounds like you.
- Avoid heavy emoji use, which can look spammy.
- Use clear dates and time zones.
Accessibility
Use enough contrast in images, keep messages short, and avoid putting key information only in images.
Respect and consent
- Only message people who started the bot or asked to hear from you.
- Offer an easy way to stop messages and honour it.
- Do not send repeated promotions.
- Store the minimum data. See bots for creators.
Flow checklist
- Can a stranger complete the main task in two taps?
- Is there always a way back to the main menu?
- Is there a human option?
- Does the bot say it is a bot?
- Have you tested on a small phone and in dark mode?
Quick checklist
- Start message explains the bot in one line.
- Three to five buttons on the first screen.
- Commands registered and short.
- A back to menu option everywhere.
- A fallback for unexpected messages.
- A human contact option.
- Deep link tags for each source.
- A test on a small phone in dark mode.
Watch real users
The fastest way to improve a flow is to watch a stranger use it. Ask a friend to try three tasks without help, and note every hesitation. Fix the earliest confusion first, then repeat with another person.
Frequently asked questions
How many buttons are too many?
More than five or six at once can overwhelm. Use sub menus.
Should I use a Mini App instead of buttons?
If your flow needs forms, catalogues or richer design, a Mini App may be better. See Mini Apps for creators.
Can I update the menu later?
Yes. Change commands in BotFather and update messages in your bot.
How do I know the flow works?
Watch real users, check where they stop, and fix the earliest drop-off first.
Related guides

How to Create a Telegram Bot with BotFather
Step by step: make a Telegram bot with BotFather, set its name, photo and commands, keep the token safe and decide whether to code it or use a tool.

Telegram Welcome Messages for New Fans: Templates and Rules
Write a Telegram welcome message that feels personal: structure, examples for channels, bots and Business chats, timing and mistakes to avoid.

Telegram Bots for Creators: 8 Useful Jobs a Bot Can Do
What a Telegram bot can do for a creator: welcome menus, FAQs, link delivery, polls, giveaways, payments with Stars and moderation, with safety tips.

Automating Welcome and Follow-Up Messages on Telegram
Use Telegram's tools and bots to send welcome and follow-up messages without spam: timing, consent, segmentation, opt-outs and a sample sequence.

Telegram Mini Apps for Creators: What They Can Do
How creators can use Telegram Mini Apps: link pages, shops, member areas, games and tools. Includes launch options, Stars, design and safety tips.

AI Chat Companions on Telegram: What They Are and How to Judge Them
An explainer on AI companions and chat characters on Telegram: how they work, creator clones versus fictional characters, safety, privacy and red flags.
More in Bots, automation and AI
- AI Clone Safety and Disclosure: A Creator Checklist
- How Chat Bots and Auto-Reply Work on Telegram
- How to Find Good Telegram Bots (and Avoid Bad Ones)
- How to Link My AI Clone to My Telegram Account
All topics: Bots, automation and AI · Guide index · Explore Telegram · About TSocial