Редактирование команд Telegram-бота онлайн

Команды бота видны в меню и в подсказках при вводе «/». Можно задать разные списки для личных чатов, групп, администраторов и языков.

Сделайте это в пару кликов — без кода и сервера, прямо в браузере.

Открыть редактор команд

Формат

Одна команда на строку, имя и описание разделены дефисом:

start - Start the bot
help - Show help
settings - Open settings
tip - A hint only you can see [ephemeral]

До 100 команд в списке.
Имя: 1–32 символа, строчные латинские буквы, цифры и подчёркивание. Начальный «/» удаляется автоматически.
Описание: 1–256 символов.
[ephemeral] отмечает команды, ответ на которые видит только отправитель (Bot API 10.2).

Области видимости (scope)

Scope	Кто видит список
`default`	Все, если не подходит более узкая область.
`all_private_chats`	Все личные чаты.
`all_group_chats`	Все группы и супергруппы.
`all_chat_administrators`	Администраторы всех групп.
`chat`	Один конкретный чат (chat_id).
`chat_administrators`	Администраторы одного чата.
`chat_member`	Один участник одного чата (chat_id + user_id).

Для каждой области можно задать отдельные списки по language_code (двухбуквенный ISO 639-1). Telegram выбирает самую узкую область, затем язык пользователя, затем список без языка.

То же самое через curl

curl -X POST "https://api.telegram.org/bot$BOT_TOKEN/setMyCommands" \
  --form-string 'commands=[{"command":"start","description":"Start the bot"},{"command":"help","description":"Show help"}]' \
  --form-string 'scope={"type":"all_private_chats"}' \
  --form-string "language_code=en"

Удалить список:

curl -X POST "https://api.telegram.org/bot$BOT_TOKEN/deleteMyCommands" \
  --form-string 'scope={"type":"all_group_chats"}'

Советы

Пишите короткие описания — в узких меню они обрезаются.
Пользователи увидят изменения после повторного открытия чата: клиенты кэшируют список.
На вкладке «Кнопка меню» можно показать на кнопке у поля ввода список команд или Mini App.