Mengimplementasikan perintah garis miring

Perintah Garis miring memungkinkan Anda mendaftarkan dan mengiklankan perintah tertentu untuk aplikasi Anda yang membantu pengguna memahami beberapa fitur aplikasi. Saat pengguna melakukan chat dengan aplikasi dan mengetikkan garis miring, perintah garis miring aplikasi akan muncul di pop-up, dengan deskripsi tentang apa yang dilakukan setiap perintah.

Saat pengguna memanggil aplikasi Anda dengan perintah garis miring, kolom tambahan dilampirkan ke pesan yang dikirim ke aplikasi Anda. Kolom ini menunjukkan bahwa pengguna memilih perintah garis miring, serta perintah garis miring yang mereka pilih (berdasarkan ID perintah yang ditentukan dalam konfigurasi aplikasi Anda). Selain itu, perintah garis miring memiliki anotasi, sama seperti saat pengguna berinteraksi dengan aplikasi Anda berdasarkan nama.

{
  ...
  "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 perintah yang akan diterima aplikasi Anda sesuai dengan ID perintah yang Anda tentukan untuk perintah tersebut dalam konfigurasi aplikasi:

Kolom konfigurasi perintah garis miring.

Hal ini memungkinkan aplikasi Anda menangani kasus perintah garis miring secara eksplisit dengan penguraian argumen terbatas:

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

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