實作斜線指令

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

斜線指令可讓您註冊應用程式並宣傳特定指令,協助使用者瞭解應用程式的部分功能。當使用者與應用程式進行即時通訊並輸入斜線時,應用程式的斜線指令會顯示在彈出式視窗中,並說明每個指令的用途。

當使用者透過斜線指令叫用您的應用程式時,系統會傳送一個額外欄位至傳送至應用程式的訊息中。這個欄位表示使用者選取了斜線指令,以及他們選取的斜線指令 (依據應用程式設定中指定的指令 ID)。此外,斜線指令與註解相同,就像使用者與應用程式互動時一樣。

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

應用程式收到的指令 ID 會對應至您在應用程式設定中為該指令指定的指令 ID:

這可讓應用程式透過有限的引數剖析明確地處理斜線指令:

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

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