Implementowanie poleceń po ukośniku

Polecenia po ukośniku pozwalają zarejestrować i reklamować określone polecenia, które pomagają użytkownikom poznać niektóre funkcje aplikacji. Gdy użytkownik rozmawia na czacie z aplikacją i wpisuje ukośnik, polecenia po ukośniku są wyświetlane w wyskakującym okienku wraz z opisem każdego polecenia.

Gdy użytkownik wywoła aplikację po ukośniku, do wiadomości wysłanej do aplikacji zostanie dodane dodatkowe pole. To pole wskazuje, że użytkownik wybrał polecenie po ukośniku oraz wybrane polecenie po ukośniku (na podstawie identyfikatora polecenia określonego w konfiguracji aplikacji). Dodatkowo polecenie po ukośniku zawiera adnotację, podobnie jak użytkownik wchodzi w interakcję z Twoją aplikacją po nazwie.

{
  ...
  "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
    }
  }
}

Identyfikator polecenia, który otrzyma Twoja aplikacja, odpowiada identyfikatorowi polecenia określonego w konfiguracji aplikacji:

Dzięki temu aplikacja może obsługiwać polecenia poleceń po ukośniku z ograniczonym analizowaniem argumentów:

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

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