TSocial TSocial
Open in Telegram
Better in TelegramOpen in Telegram

Telegram Bot Commands, Menus and Onboarding Flows

· 4 min read · 18+ readers

Telegram Bot Commands, Menus and Onboarding Flows: TSocial guide cover card

A bot icon 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+, safety icon safe for work examples.

The building blocks

  • Start message: what people see after pressing Start.
  • Commands: slash words like /help that appear in the menu.
  • Inline buttons: buttons under a message that trigger actions or open link icon 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 icon (grid) Mini App.
  • Deep links: links like t.me/yourbot?start=instagram that let you know where someone came from.

Design the first screen

A good start message has four parts:

  1. Who the bot is and what it does in one line.
  2. A short promise: "Get my links, ask a question or see what is new."
  3. Three to five buttons.
  4. 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:

  • /start welcome.
  • /links your main links.
  • /help how to use the bot.
  • /contact reach a human.
  • /stop stop 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.

  • 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

More in Bots, automation and AI

All topics: Bots, automation and AI · Guide index · Explore Telegram · About TSocial

Telegram Bot Commands, Menus and Onboarding Flows | TSocial