斜線指令可讓您註冊應用程式並宣傳特定指令,協助使用者瞭解應用程式的部分功能。當使用者與應用程式進行即時通訊並輸入斜線時,應用程式的斜線指令會顯示在彈出式視窗中,並說明每個指令的用途。
當使用者透過斜線指令叫用您的應用程式時,系統會傳送一個額外欄位至傳送至應用程式的訊息中。這個欄位表示使用者選取了斜線指令,以及他們選取的斜線指令 (依據應用程式設定中指定的指令 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.