Membangun antarmuka Google Chat

Halaman ini memberikan ringkasan cara membuat antarmuka pengguna (UI) untuk add-on Google Workspace yang memperluas Google Chat.

Untuk membuat antarmuka aplikasi Chat, Anda menggunakan komponen add-on berikut:

  • Pemicu: Cara pengguna Google Chat dapat memanggil aplikasi Chat, seperti menambahkannya ke ruang atau mengirim pesan ke aplikasi tersebut.
  • Objek peristiwa: Data yang diterima aplikasi Chat dari pemicu atau interaksi UI.
  • Tindakan: Cara aplikasi Chat dapat merespons interaksi, seperti mengirim pesan atau menampilkan antarmuka pengguna berbasis kartu.
Aplikasi Chat menerima objek peristiwa dari pemicu Ditambahkan ke ruang
Gambar 1: Saat pengguna menambahkan aplikasi Chat ke ruang, pemicu Ditambahkan ke ruang akan diaktifkan dan mengirim objek peristiwa. Untuk merespons dengan pesan, aplikasi Chat menangani objek peristiwa dan menampilkan tindakan yang membuat pesan.

Aplikasi Chat dapat membuat dan menampilkan kartu di antarmuka berikut:

  • Pesan yang dapat berisi teks, kartu statis atau interaktif, dan tombol.
  • Dialog adalah kartu yang terbuka di jendela baru dan biasanya meminta pengguna untuk mengirimkan informasi.
  • Pratinjau link adalah kartu yang mempratinjau informasi tentang layanan eksternal.

Pemicu

Bagian ini menjelaskan pemicu yang digunakan add-on Google Workspace di Chat.

Pemicu adalah cara khusus pengguna memanggil aplikasi Chat menggunakan UI Chat, seperti menggunakan sebutan @atau perintah aplikasi.

Tabel berikut menunjukkan pemicu Chat, deskripsi, dan cara aplikasi Chat biasanya merespons:

Pemicu Deskripsi Respons umum
Ditambahkan ke ruang

Pengguna menambahkan aplikasi Chat ke ruang, atau administrator Google Workspace menginstal aplikasi Chat di ruang pesan langsung untuk pengguna di organisasi mereka. Untuk mempelajari aplikasi Chat yang diinstal oleh administrator, lihat Menginstal aplikasi Marketplace di domain Anda dalam dokumentasi Bantuan Admin Google Workspace.

 Aplikasi Chat mengirimkan pesan aktivasi yang menjelaskan fungsi aplikasi dan cara pengguna di ruang berinteraksi dengannya.
Kirim pesan

Pengguna berinteraksi dengan aplikasi Chat dalam pesan dengan salah satu cara berikut:

  • Mengirim pesan di ruang pesan langsung (DM) dengan aplikasi Chat.
  • @menyebut aplikasi Chat di semua jenis ruang.
  • Mengirim pesan yang berisi link yang cocok dengan pola URL untuk pratinjau link.
  • Mengetik teks ke dalam menu multiselect dari selectionInput widget.
 Aplikasi Chat merespons berdasarkan konten pesan. Misalnya, aplikasi Chat membalas perintah garis miring /about dengan pesan yang menjelaskan tugas yang dapat dilakukan aplikasi Chat.
Dihapus dari ruang

Pengguna menghapus aplikasi Chat dari ruang, atau administrator Google Workspace meng-uninstal aplikasi Chat untuk pengguna di organisasinya.

Pengguna tidak dapat menghapus aplikasi Chat yang diinstal oleh administrator mereka. Jika pengguna sebelumnya telah menginstal aplikasi Chat, aplikasi Chat akan tetap diinstal terlepas dari apakah administrator Google Workspace mencoba meng-uninstal atau tidak.

 Aplikasi Chat menghapus semua notifikasi masuk yang dikonfigurasi untuk ruang (seperti menghapus webhook) dan menghapus semua penyimpanan internal. Aplikasi chat tidak dapat merespons dengan pesan ke pemicu ini, karena aplikasi tersebut bukan lagi anggota ruang.
Perintah aplikasi

Pengguna menggunakan perintah aplikasi Chat.

 Aplikasi Chat akan merespons perintah. Misalnya, membalas dengan pesan atau membuka dialog.

Tidak seperti add-on Google Workspace lainnya, Anda harus mengonfigurasi fungsi callback untuk pemicu ini menggunakan Google Chat API. Untuk mendapatkan panduan, lihat Mengonfigurasi aplikasi Google Chat.

Untuk merespons pemicu, lihat panduan berikut:

Objek peristiwa

Aplikasi Chat menerima objek peristiwa saat pemicu Chat diaktifkan, atau saat pengguna Chat berinteraksi dengan UI dari aplikasi Chat (seperti mengklik tombol). Objek peristiwa berisi data tentang interaksi yang dapat digunakan aplikasi Chat untuk merespons atau mengupdate UI.

Untuk mempelajari cara menangani objek peristiwa, lihat panduan berikut:

Untuk mempelajari objek peristiwa add-on dalam Chat dan aplikasi Google Workspace lainnya, lihat Objek peristiwa.

Tindakan chat

Bagian ini menjelaskan cara aplikasi Chat dapat menggunakan tindakan add-on untuk merespons interaksi pengguna.

Untuk merespons dengan tindakan add-on, aplikasi Chat harus merespons dalam waktu 30 detik, dan respons harus diposting di ruang tempat interaksi terjadi. Jika tidak, aplikasi Chat harus menyiapkan autentikasi dan memanggil Google Chat API untuk merespons.

Aplikasi chat dapat menangani dan merespons interaksi dengan berbagai cara. Dalam banyak kasus, aplikasi Chat membalas dengan pesan. Aplikasi chat juga dapat mencari beberapa informasi dari sumber data, mencatat informasi objek peristiwa, atau melakukan hal lainnya. Perilaku pemrosesan ini pada dasarnya menentukan aplikasi Google Chat.

Untuk merespons interaksi pengguna, aplikasi Chat harus menangani objek peristiwa yang sesuai dan menampilkan salah satu objek JSON berikut:

Respons aplikasi Chat Tindakan yang diperlukan untuk pengembalian
Mengirim atau memperbarui pesan. DataActions
Membuka, memperbarui, atau menutup dialog. RenderActions
Untuk mengumpulkan informasi dari kartu atau dialog, sarankan item pilihan berdasarkan apa yang diketik pengguna ke dalam menu multiselect. RenderActions
Pratinjau link dalam pesan yang dikirim pengguna Chat di ruang. DataActions

Memberikan respons menggunakan Google Chat API

Daripada menampilkan tindakan add-on, aplikasi Chat mungkin perlu menggunakan Google Chat API untuk merespons interaksi. Misalnya, aplikasi Chat harus memanggil Google Chat API untuk melakukan salah satu hal berikut:

  • Merespons interaksi setelah 30 detik.
  • Melakukan tugas di luar ruang tempat interaksi terjadi.
  • Menjalankan tugas di Chat yang tidak tersedia sebagai tindakan add-on. Misalnya, mencantumkan ruang tempat pengguna atau aplikasi Chat menjadi anggota, atau menambahkan pengguna ke ruang.
  • Melakukan tugas atas nama pengguna Chat (yang memerlukan autentikasi pengguna).

Untuk mempelajari cara mengautentikasi dan memanggil Chat API, lihat Ringkasan Chat API.