Команды для чат-бота

Вы можете добавить, изменить и удалить команды для чат-бота с помощью метода PATCH /me/commands

Команды отображаются пользователю в виде подсказок в диалоге или групповом чате, когда он вводит « / », — доступно на платформах iOS, Android, десктоп, или нажимает соответствующую кнопку в интерфейсе — только на платформе iOS

Отображение команд в каналах не поддерживается

Доступность функциональности команд в МАХ

Тип чата	Диалог с ботом	Групповой чат с ботом	Канал c ботом
Поддерживаемые платформы	iOS Android Десктоп	iOS Android	Недоступно

После добавления команд вы можете настроить логику сценариев работы чат-бота так, чтобы он выполнял необходимые вам действия в ответ на эти команды или другие слова, отправленные в чат. Для этого используйте библиотеки JavaScript и Golang. Примеры использования библиотек для работы с чат-ботом смотрите в разделе «Примеры создания ботов»

Также вы можете добавить команды в кнопки с типом callback, которые чат-бот будет присылать сообщением

Примеры запросов для создания и удаления команд для ботов

BASH

curl -X PATCH "https://platform-api2.max.ru/me/commands" \
  -H "Authorization: {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
        //  максимум 32 элемента в массиве
        "commands": [  
          {
            "name": "name", //от 1 до 64 символов
            "description": "string" // опционально, от 1 до 128 символов
          },
          {
            "name": "string",
            "description": "string"
          },
          {
            "name": "string",
            "description": "string"
          }
        ]
      }'

BASH

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

Если у вас возникли вопросы, посмотрите раздел с ответами