LIVE PORTAL • Telegram v11.8 API Synchronized • Free Animated Stickers
translate Translated

How to Use Telegram Bot Menus: Contextual Command Palettes, Role-Based Access & Quick Action Buttons Guide

play_circle Video tip • Bots

Next to the message box in a bot chat there is a menu button. Tap it and you get the bot's commands as a list, each with a description, instead of having to know that it answers to a slash and a word.

Bots used to require memorising their vocabulary. The menu turned them into something you can use without having read anything first, which is most of why they are worth using at all now.

What you will be able to do

  • check_circle Find out what a bot can do without guessing.
  • check_circle Tell the three kinds of button in a bot chat apart.
  • check_circle Get a stuck bot back to a known state.
  • check_circle Recognise the commands almost every bot understands.
play_circle Official Telegram video short — the bot menu
1080p clip from @TelegramTips #283 • 0:06
AUTOPLAY

The menu pill replaces the message box for a moment and lists what the bot actually accepts.

menu_open Three kinds of button, and they behave differently

The menu button beside the message box is the bot's own command list, always available, written by its developer. Tapping a command sends it for you. On some bots this button opens a mini app instead of a list, which is a web page inside Telegram rather than a conversation.

The buttons under a message belong to that message. They do things without sending anything visible, and they are the ones that stop working when the message is old — the bot has often forgotten what that message was about.

The keyboard that replaces your keyboard is the third kind. Those buttons send ordinary text; you could type the same words. That is why the bot understands them whether you tap or type.

terminal
The list is contextual A bot can show different commands in a group than in a private chat, and different ones again to admins. A command that a friend mentions and you cannot find may simply not be offered to you here.
smart_toy Interactive

Four situations with a bot

The first two are how to start. The last two are what to do when it stops making sense.

touch_app Start with the menu, not the message box

check_circle Press start, then open the menu and read the list. Thirty seconds there saves a conversation of trial and error.
check_circle The descriptions are written by the developer, so a bot with a clear list is usually a bot that was made carefully.
cancel A bot with no menu and no help is not necessarily broken, but it is asking you to guess. Treat that as information about it.

The menu is the bot's manual and it is one tap away. Read it before typing anything.

settings Working with a bot

  1. Press start Nothing happens before that; a bot cannot open a conversation with you.
  2. Open the menu beside the message box And read the commands and their descriptions.
  3. Tap one rather than typing it No spelling to get wrong.
  4. Type a slash to search commands Once you know the names.
  5. Use cancel or start to reset When the bot seems to be waiting for something you cannot identify.
  6. Keep sensitive requests in the private chat Not in a group where the answer is public.
menu_book
Part of the beginner curriculum Step 87 — Inline bots and how they work

This page is the bot you open a chat with. The curriculum step is the other kind: bots you call from inside any conversation by typing their name, what an inline query is, and why those never join the chat at all.

insights Visual recap

Bot menus at a glance

The menu button, the three kinds of button, the conventional commands, resetting a stuck bot, and behaviour in groups, on one page. Tap to open it at full resolution.

Infographic summarising the Telegram bot menu button and command list
Enlarged Preview
Click anywhere outside or press ESC to close viewer
smart_display Telegram Video Short
1080p HD
Official Source: @TelegramTips Post #44 Press ESC or click outside to close