Implementowanie poleceń po ukośniku

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Polecenia po ukośniku umożliwiają rejestrację i reklamowanie określonych poleceń, które pomagają użytkownikom zrozumieć niektóre funkcje aplikacji. Gdy użytkownik rozmawia na czacie z aplikacją, wpisując w wyskakującym okienku ukośnik, pojawia się informacja o tym, do czego służy poszczególne polecenia.

Gdy użytkownik wywoła Twoją aplikację za pomocą polecenia po ukośniku, do wiadomości wysłanej do aplikacji zostanie dołączone dodatkowe pole. To pole wskazuje, że użytkownik wybrał polecenie po ukośniku oraz wybrane przez niego polecenie po ukośniku (na podstawie identyfikatora polecenia określonego w konfiguracji aplikacji). Oprócz tego polecenie po ukośniku ma adnotację, tak samo jak użytkownik używa aplikacji 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ślonemu dla tego polecenia w konfiguracji aplikacji:

Dzięki temu aplikacja będzie obsługiwać instancje poleceń po ukośniku z ograniczoną analizą 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.