Команды бота

Команды показываются в подсказках при вводе / и в меню бота.

Установка

POST /setMyCommands
{
  "commands": [
    {"command": "start", "description": "Начать работу"},
    {"command": "help", "description": "Показать помощь"},
    {"command": "settings", "description": "Настройки"}
  ]
}

Параметры:

• commands — массив до 100 команд. Каждая: command (1-32 символа a-z 0-9 _), description (1-256 символов).
• scope — где видны команды (см. ниже)
• language_code — язык для локализации

Получение

GET /getMyCommands?language_code=ru

Удаление

POST /deleteMyCommands
{ "language_code": "ru" }

Без language_code — удаляет дефолтные команды.

Scope

Где видны команды:

{
  "commands": [...],
  "scope": {"type": "all_private_chats"}
}

Типы scope:

• default — везде, кроме переопределённых scope (по умолчанию)
• all_private_chats — только в DM
• all_group_chats — во всех группах
• all_chat_administrators — для админов всех групп
• chat — конкретный чат: {type, chat_id}
• chat_administrators — админы конкретного чата
• chat_member — конкретный юзер в конкретном чате

Локализация

Команды можно локализовать для каждого языка:

POST /setMyCommands
{
  "commands": [
    {"command": "start", "description": "Начать работу"},
    {"command": "help", "description": "Помощь"}
  ],
  "language_code": "ru"
}

POST /setMyCommands
{
  "commands": [
    {"command": "start", "description": "Get started"},
    {"command": "help", "description": "Help"}
  ],
  "language_code": "en"
}

Юзер увидит на своём языке.

Через приложение

Проще всего настроить команды через GUI @botmaker → бот → «Команды». Поддерживаются вкладки для каждого языка с автосохранением.