Halaman ini menyediakan ikhtisar tentang cara membuat add-on Google Workspace yang memperluas Google Chat.
Add-on Google Workspace yang memperluas Chat dapat membantu pengguna melakukan salah satu hal berikut:
- Melihat pratinjau link dari pesan Chat, dan mengambil tindakan tanpa meninggalkan percakapan.
- Mengotomatiskan atau melakukan tugas di seluruh aplikasi Google Workspace.
- Menerima pemberitahuan atau notifikasi tentang alat atau layanan eksternal.
Cara kerja add-on Google Workspace di Chat
Di Chat, add-on muncul kepada pengguna sebagai aplikasi Google Chat. Untuk berinteraksi dengan pengguna, aplikasi Obrolan dapat melakukan hal berikut:
- Kirim pesan yang berisi teks, kartu, dan elemen UI interaktif.
- Menanggapi perintah cepat.
- Tanggapi perintah garis miring.
- Buka dialog untuk membantu pengguna menyelesaikan proses multi-langkah, seperti mengisi data formulir.
- Pratinjau link dalam pesan dengan melampirkan kartu berisi informasi berguna yang memungkinkan pengguna mengambil tindakan langsung dari percakapan.
Mulai
Untuk mulai membuat add-on Google Workspace yang berfungsi di Chat, lihat dokumentasi berikut:
- Coba panduan memulai untuk membangun aplikasi Chat dasar menggunakan Google Apps Script atau layanan HTTP.
- Konfigurasikan aplikasi Chat dan fitur interaktifnya menggunakan Chat API.
- Pelajari cara Anda dapat membangun antarmuka Chat menggunakan pemicu, tindakan, dan objek peristiwa add-on.
Batasan dan masalah umum
Fitur Obrolan dan fitur tambahan berikut tidak tersedia:
- Arsitektur aplikasi Chat Dialogflow, Pub/Sub, dan AppSheet tidak tersedia. Sebagai gantinya, Anda harus membuat aplikasi Chat menggunakan Apps Script atau layanan HTTP.
- Layanan Kartu Apps Script. Untuk menggunakan Tindakan chat dan membuat kartu, tampilkan objek JSON. Untuk contoh, lihat Buka dialog interaktif dan Pratinjau tautan.
- Kartu otorisasi kustom. Untuk mengautentikasi dan memberikan otorisasi ke layanan Anda dari Chat, aplikasi Chat harus menampilkan kartu otorisasi dasar.
- Halaman beranda add-on di sidebar Chat. Jika Anda telah mengonfigurasi pemicu halaman beranda untuk add-on, halaman beranda hanya muncul di sidebar aplikasi Google Workspace lain yang diperluas oleh add-on Anda.
- Halaman beranda aplikasi Chat, yang muncul di tab Beranda pada pesan langsung dengan aplikasi Chat.
Jika Anda memperbarui add-on Google Workspace yang ada, pertimbangkan persyaratan konfigurasi berikut untuk aplikasi Chat:
- Setelan penginstalan Google Workspace Marketplace harus mengizinkan individu dan administrator Google Workspace untuk menginstal add-on.
- Setelan konfigurasi umum apa pun di
manifest
(
addons.common) add-on akan diabaikan di Chat. Untuk mengonfigurasi add-on agar berfungsi di Chat, Anda harus mengaktifkan dan mengonfigurasi Chat API. Untuk langkah-langkahnya, lihat Mengonfigurasi aplikasi Google Chat. - Untuk menyebarkan dan menguji add-on di Chat, Anda harus menggunakan pengaturan Visibilitas Chat API. Setelan visibilitas atau pengujian yang telah Anda konfigurasi di Google Workspace Marketplace SDK akan diabaikan. Untuk menerapkan versi uji coba add-on di Chat, lihat Menguji fitur interaktif untuk aplikasi Google Chat dalam dokumentasi Chat API.
- Jika add-on Anda dipublikasikan ke Google Workspace Marketplace, Anda tidak dapat menyimpan draf perubahan apa pun pada setelan konfigurasi Google Chat API. Saat Anda memperbarui pengaturan konfigurasi Chat API, aplikasi Chat yang diperbarui segera tersedia untuk semua pengguna yang ada. Untuk memperbarui cantuman Marketplace Anda, Anda dapat membuat draf sebelum mengirimkan perubahan apa pun.
Topik terkait
- Ringkasan dokumentasi Google Chat API
- Coba contoh: