Merespons perintah garis miring sebagai aplikasi Google Chat

Halaman ini menjelaskan cara menyiapkan dan merespons perintah garis miring untuk Aplikasi Google Chat.

Perintah garis miring adalah cara umum yang digunakan pengguna untuk memanggil dan berinteraksi dengan Aplikasi Chat. Perintah garis miring juga membantu pengguna menemukan dan menggunakan fitur-fitur utama aplikasi Chat.

Untuk menggunakan perintah garis miring, pengguna mengetik garis miring (/) lalu perintah teks pendek, seperti /about untuk mendapatkan informasi tentang aplikasi Chat. Pengguna dapat menemukan perintah garis miring yang tersedia dengan mengetik Google Chat, yang menampilkan jendela yang mencantumkan perintah yang tersedia untuk Aplikasi Chat:

Jendela perintah garis miring
Gambar 1: Jendela yang muncul saat pengguna mengetik garis miring ke Google Chat.

Untuk memutuskan apakah Anda harus mengatur perintah garis miring, dan untuk memahami cara mendesain interaksi pengguna, melihat Mendefinisikan semua perjalanan pengguna.

Perintah garis miring dengan respons pribadi

Ketika pengguna mengirim pesan yang berisi perintah garis miring, pesan itu hanya terlihat oleh pengguna dan aplikasi Chat. Jika Anda telah mengonfigurasi aplikasi Chat untuk ditambahkan ke ruang dengan beberapa orang, Anda dapat mempertimbangkan untuk merespons perintah {i>/.<i} secara pribadi, untuk menjaga privasi interaksi antara pengguna dan Aplikasi Chat.

Misalnya, untuk mempelajari aplikasi Chat yang temukan di ruang, pengguna dapat menggunakan perintah seperti /about atau /help. Agar tidak memberi tahu semua orang di ruang, Aplikasi Chat dapat merespons secara pribadi dengan informasi tentang cara menggunakan aplikasi Chat dan mendapatkan dukungan.

Prasyarat

Node.js

Aplikasi Google Chat yang diaktifkan untuk fitur interaktif. Untuk membuat aplikasi Chat interaktif menggunakan layanan HTTP, selesaikan panduan memulai ini.

Apps Script

Aplikasi Google Chat yang diaktifkan untuk fitur interaktif. Untuk membuat aplikasi Chat interaktif di Apps Script, selesaikan panduan memulai ini.

Python

Aplikasi Google Chat yang diaktifkan untuk fitur interaktif. Untuk membuat aplikasi Chat interaktif menggunakan layanan HTTP, selesaikan panduan memulai ini.

Java

Aplikasi Google Chat yang diaktifkan untuk fitur interaktif. Untuk membuat aplikasi Chat interaktif menggunakan layanan HTTP, selesaikan panduan memulai ini.

Menyiapkan perintah garis miring

Bagian ini menjelaskan cara menyelesaikan langkah-langkah berikut untuk menyiapkan garis miring berikut:

  1. Buat nama untuk perintah garis miring Anda.
  2. Konfigurasikan perintah garis miring di Google Chat API.

Beri nama perintah garis miring Anda

Nama perintah garis miring adalah hal yang diketik pengguna dalam pesan Chat untuk memanggil aplikasi Chat. Deskripsi singkat juga akan muncul di bawah nama, untuk memberi tahu pengguna lebih lanjut tentang cara menggunakan perintah tersebut:

Nama dan deskripsi perintah garis miring
Gambar 2: Nama dan deskripsi untuk perintah garis miring.

Saat memilih nama dan deskripsi untuk perintah garis miring Anda, pertimbangkan rekomendasi berikut:

  • Untuk memberi nama perintah garis miring:

    • Gunakan kata atau frasa pendek, deskriptif, dan dapat ditindaklanjuti untuk menyampaikan perintah yang jelas dan sederhana bagi pengguna. Misalnya, daripada mengatakan /createAReminder, gunakan /remindMe.
    • Jika perintah Anda berisi lebih dari satu kata, bantu pengguna membaca perintah tersebut dengan menggunakan huruf kecil semua untuk kata pertama dan menggunakan huruf besar untuk kata pertama huruf dari kata tambahan. Misalnya, sebagai ganti /updatecontact, gunakan /updateContact.
    • Pertimbangkan apakah akan menggunakan nama yang unik atau umum untuk perintah Anda. Jika perintah Anda menjelaskan interaksi atau fitur khas, Anda dapat menggunakan nama umum yang dikenali dan diharapkan pengguna, seperti /settingsatau /feedback. Jika tidak, coba gunakan nama perintah yang unik, karena jika sama dengan nama perintah untuk aplikasi Chat lainnya, pengguna harus menyaring perintah yang mirip untuk menemukan dan menggunakan milik Anda.
  • Untuk mendeskripsikan perintah garis miring:

    • Buat deskripsi yang singkat dan jelas sehingga pengguna tahu apa yang diharapkan ketika mereka memanggil perintah itu.
    • Beri tahu pengguna jika ada persyaratan pemformatan untuk perintah tersebut. Misalnya, jika Anda membuat perintah /remindMe yang memerlukan argumen teks, setel deskripsi menjadi Remind me to do [something] at [time].
    • Beri tahu pengguna jika aplikasi Chat membalas semua orang di ruang, atau secara pribadi kepada pengguna yang menjalankan perintah. Misalnya, untuk perintah garis miring /about, Anda dapat mendeskripsikannya sebagai Learn about this app (Only visible to you). Untuk merespons secara pribadi Perintah garis miring, lihat bagian Merespons dengan pesan pribadi.

Konfigurasi perintah garis miring di Google Chat API

Untuk membuat perintah garis miring, Anda perlu menentukan informasi tentang perintah tersebut di konfigurasi aplikasi Chat Anda untuk Google Chat API.

Untuk mengonfigurasi perintah garis miring di Google Chat API, selesaikan langkah-langkah berikut langkah:

  1. Di Konsol Google Cloud, klik Menu &gt; API & Layanan &gt; API yang diaktifkan & Layanan &gt; Google Chat API

    Buka halaman Google Chat API

  2. Klik Konfigurasi.

  3. Di bagian Perintah garis miring, klik Tambahkan perintah garis miring.

  4. Masukkan nama, ID perintah, dan deskripsi untuk perintah tersebut:

    1. Name: nama tampilan untuk perintah, dan jenis pengguna untuk memanggil aplikasi Anda. Harus diawali dengan garis miring, hanya berisi teks, dan dapat hingga 50 karakter.
    2. Deskripsi: teks yang menjelaskan cara menggunakan dan memformat perintah tersebut. Deskripsi dapat berisi hingga 50 karakter.
    3. Command ID: angka dari 1 sampai 1000 yang Aplikasi Chat yang digunakan untuk mengenali perintah garis miring dan memberikan respons.
  5. Opsional: Jika Anda ingin aplikasi Chat merespons perintah dengan dialog, pilih Kotak centang Buka dialog.

  6. Klik Simpan.

Perintah garis miring sekarang dikonfigurasi untuk aplikasi Chat.

Merespons perintah garis miring

Saat pengguna membuat pesan Chat yang berisi perintah garis miring, aplikasi Chat Anda menerima peristiwa interaksi MESSAGE. Payload peristiwa berisi slashCommand dan slashCommandMetadata objek terstruktur dalam jumlah besar. Objek ini berisi detail tentang perintah yang digunakan dalam pesan (termasuk ID perintah), sehingga Anda bisa mengembalikan respons yang sesuai.

Pesan pribadi untuk
  Aplikasi Cymbal Labs Chat. Pesannya mengatakan bahwa
  Aplikasi Chat dibuat oleh Cymbal Labs dan membagikan link
  ke dokumentasi dan tautan untuk menghubungi tim dukungan.
Aplikasi Chat merespons secara pribadi perintah garis miring /help untuk menjelaskan cara mendapatkan dukungan.

Kode berikut menunjukkan contoh aplikasi Chat yang membalas perintah garis miring /about dengan menangani MESSAGE peristiwa interaksi dan deteksi apakah pesan berisi ID perintah yang cocok atau tidak. Jika pesan berisi ID perintah, aplikasi Chat akan menampilkan pesan pribadi:

Node.js

node/avatar-app/index.js
// Checks for the presence of a slash command in the message.
if (event.message.slashCommand) {
  // Executes the slash command logic based on its ID.
  // Slash command IDs are set in the Google Chat API configuration.
  switch (event.message.slashCommand.commandId) {
    case ABOUT_COMMAND_ID:
      return res.send({
        privateMessageViewer: event.user,
        text: 'The Avatar app replies to Google Chat messages.'
      });
  }
}

Apps Script

apps-script/avatar-app/avatar-app.gs
// Checks for the presence of a slash command in the message.
if (event.message.slashCommand) {
  // Executes the slash command logic based on its ID.
  // Slash command IDs are set in the Google Chat API configuration.
  switch (event.message.slashCommand.commandId) {
    case ABOUT_COMMAND_ID:
      return {
        privateMessageViewer: event.user,
        text: 'The Avatar app replies to Google Chat messages.'
      };
  }
}

Python

python/avatar-app/main.py
# Checks for the presence of a slash command in the message.
if "slashCommand" in request_json["message"]:
  # Executes the slash command logic based on its ID.
  # Slash command IDs are set in the Google Chat API configuration.
  if request_json["message"]["slashCommand"]["commandId"] == ABOUT_COMMAND_ID:
    return {
      "privateMessageViewer": request_json["user"],
      "text": 'The Avatar app replies to Google Chat messages.'
    }

Java

java/avatar-app/src/main/java/App.java
// Checks for the presence of a slash command in the message.
if (body.getAsJsonObject("message").has("slashCommand")) {
  // Executes the slash command logic based on its ID.
  // Slash command IDs are set in the Google Chat API configuration.
  JsonObject slashCommand = body.getAsJsonObject("message").getAsJsonObject("slashCommand");
  switch (slashCommand.get("commandId").getAsString()) {
    case ABOUT_COMMAND_ID:
    JsonObject aboutMessage = new JsonObject();
    aboutMessage.addProperty("text", "The Avatar app replies to Google Chat messages.");
    aboutMessage.add("privateMessageViewer", body.getAsJsonObject("user"));
      response.getWriter().write(gson.toJson(aboutMessage));
      return;
  }
}

Tetapkan ABOUT_COMMAND_ID dengan ID perintah yang Anda tentukan saat Anda mengonfigurasi perintah garis miring di Chat API. Untuk menguji kode ini, lihat Menguji fitur interaktif untuk aplikasi Google Chat.