Membangun antarmuka Google Chat

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

Di Google Chat, add-on akan muncul kepada pengguna sebagai aplikasi Google Chat. Untuk mempelajari lebih lanjut, lihat Ringkasan memperluas Google Chat.

Untuk mem-build 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 yang merupakan kartu yang terbuka di jendela baru dan biasanya meminta pengguna untuk mengirimkan informasi.
  • Pratinjau link yang merupakan kartu yang menampilkan pratinjau informasi tentang layanan eksternal.

Pemicu

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

Pemicu adalah cara spesifik yang digunakan pengguna untuk 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 mengirim pesan orientasi yang menjelaskan fungsinya dan cara pengguna di ruang tersebut 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.
  • @mentions aplikasi Chat di jenis ruang apa pun.
  • Mengirim pesan yang berisi link yang cocok dengan pola URL untuk pratinjau link.
  • Mengetik teks ke dalam menu multi-pilih widget selectionInput.
 Aplikasi Chat akan 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-uninstalnya.

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

Pengguna menggunakan perintah aplikasi Chat.

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

Tidak seperti add-on Google Workspace lainnya, Anda harus mengonfigurasi fungsi callback apa pun untuk pemicu ini menggunakan Google Chat API. Untuk 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 memperbarui 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 banyak cara. Dalam banyak kasus, aplikasi Chat akan membalas dengan pesan. Aplikasi chat juga dapat mencari beberapa informasi dari sumber data, mencatat informasi objek peristiwa, atau apa pun. Perilaku pemrosesan ini pada dasarnya adalah yang 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 kembali
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 multipilih. RenderActions
Pratinjau link dalam pesan yang dikirim pengguna Chat di ruang. DataActions

Merespons 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 berlangsung.
  • Melakukan tugas di Chat yang tidak tersedia sebagai tindakan add-on. Misalnya, cantumkan ruang yang menjadi anggota pengguna atau aplikasi Chat, atau tambahkan 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.