Редактирование команд бота

Для корректной работы ваших чат-ботов и мини-приложений направляйте запросы на домен platform-api2.max.ru вместо platform-api.max.ru. Также убедитесь, что добавили сертификат Минцифры в список доверенных

PATCH/me/commands

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

Для удаления команд передайте пустой массив commands

Пример запроса:

BASH

Скопировать

curl -X  "https://platform-api2.max.ru/me/commands" \
  -H "Authorization: {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
        "commands": [
          {
            "name": "string",
            "description": "string"
          }
        ]
      }'

Авторизация

access_token
apiKey

Передача токена через query-параметры больше не поддерживается — используйте заголовок Authorization: <token>

Токен для вызова HTTP-запросов присваивается при создании бота — его можно найти на платформе в разделе Чат-боты → Перейти → Расширенные настройки → Настроить
Eсли вы верифицировали профиль и создали бота в мини-приложении «MAX для бизнеса», получить токен можно там же или в боте «MAX для бизнеса» с помощью команды Получить токен

Рекомендуем не разглашать токен посторонним, чтобы они не получили доступ к управлению ботом. Токен может быть отозван за нарушение Правил платформы

Тело запроса

commands
BotCommand[] optional

до 32 элементов

Список команд и их описаний, отображаемых пользователю в подсказках при вводе « / »

Результат

commands
BotCommand[] optional

до 32 элементов

Команды, которые поддерживает бот

Коды ответов

Код	Описание
`200`	Информация о командах бота
`401`	Ошибка авторизации. Токен `access_token` указан некорректно или недействителен
`500`	Внутренняя ошибка сервера