Реализовать слеш-команды

Слэш-команды позволяют регистрировать и рекламировать определенные команды для вашего приложения, которые помогают пользователям понять некоторые функции приложения. Когда пользователь общается с приложением и вводит косую черту, во всплывающем окне появляются косые команды приложения с описанием того, что делает каждая команда.

Когда пользователь вызывает ваше приложение с помощью косой черты, к сообщению, отправляемому вашему приложению, добавляется дополнительное поле. Это поле указывает, что пользователь выбрал команду косой черты, а также какую команду косой черты он выбрал (на основе идентификатора команды, указанного в конфигурации вашего приложения). Кроме того, команда косой черты имеет аннотацию, как и когда пользователь взаимодействует с вашим приложением по имени.

{
  ...
  "message": {
    ...
    "text": "/vote yes",
    "argumentText": " yes",
    "annotations": [
      {
        "length": 5,
        "startIndex": 0,
        "slashCommand": {
          "type": "INVOKE",
          "user": {
            "avatarUrl": "https://.../avatar.png",
            "displayName": "VoteBot",
            "name": "users/1234567890987654321",
            "type": "BOT"
          }
        },
        "type": "SLASH_COMMAND"
      }
    ],
    "slashCommand": {
      "commandId": 2
    }
  }
}

Идентификатор команды, который получит ваше приложение, соответствует идентификатору команды, указанному для этой команды в конфигурации вашего приложения:

Это позволяет вашему приложению явно обрабатывать случаи команд с косой чертой с ограниченным анализом аргументов:

if (message.slashCommand) {
  switch (message.slashCommand.commandId) {
    case 2:  // /vote
      return vote(message.argumentText);
  }
}

// Other existing handling for users invoking your app by name.