Membangun aplikasi Google Chat interaktif

Halaman ini memberikan ringkasan tentang cara membuat aplikasi Google Chat interaktif. Aplikasi Chat interaktif dibuat sebagai add-on Google Workspace yang memperluas Google Chat.

Aplikasi Chat interaktif memungkinkan pengguna melakukan salah satu hal berikut:

  • Menambahkan aplikasi Chat ke ruang Chat atau pesan langsung.
  • Mengirim atau menerima pesan dari aplikasi Chat yang berisi teks, kartu, dan elemen UI interaktif.
  • Melihat dan berinteraksi dengan kartu Beranda Aplikasi di tab Beranda pada pesan langsung 1:1 dengan aplikasi Chat.
  • Berikan perintah pada aplikasi Chat dengan perintah garis miring, perintah cepat, atau tindakan pesan.
  • Pratinjau link dari pesan Chat dan ambil tindakan tanpa keluar dari percakapan.
  • Mengirimkan informasi ke aplikasi Chat, seperti memasukkan teks ke dalam dialog atau pesan kartu.
  • Mengotomatiskan atau melakukan tugas di berbagai aplikasi Google Workspace dan terhubung ke alat atau layanan eksternal.

Cara pengguna menemukan dan menggunakan aplikasi Chat interaktif

Di Chat, add-on yang memperluas Chat tampil kepada pengguna sebagai aplikasi Google Chat. Pengguna dapat menemukan dan menggunakan aplikasi Chat yang dipublikasikan ke Marketplace dengan berbagai cara, termasuk yang berikut:

  • Telusuri dan instal aplikasi Chat dari Google Chat atau Marketplace.
  • Berinteraksi dengan aplikasi Chat yang telah ditambahkan ke ruang Chat.
  • Menemukan aplikasi Chat di panel pesan langsung mereka setelah administrator Google Workspace menginstal aplikasi Chat atas nama mereka.

Untuk mulai menggunakan aplikasi Chat, pengguna Google Chat dapat memulai pesan langsung dengan aplikasi Chat atau menambahkannya ke ruang. Pengguna juga dapat menambahkan aplikasi Chat dengan @menyebutnya. Untuk mengetahui informasi selengkapnya, lihat Menggunakan aplikasi Chat.

Contoh berikut menunjukkan cara pengguna @menyebut aplikasi Chat untuk menambahkannya ke ruang:

Menambahkan aplikasi Chat ke ruang dengan mengetik @ dalam pesan.

Mulai

Untuk mulai membuat aplikasi Chat interaktif, lihat dokumentasi berikut:

Mengonfigurasi dan membuat aplikasi Chat dasar

Tabel berikut mencantumkan dokumentasi untuk mengonfigurasi Chat API dan membuat aplikasi Chat interaktif dasar untuk setiap arsitektur aplikasi Google Chat:

Arsitektur atau tugas Panduan
Mengonfigurasi Chat API Mengonfigurasi Google Chat API
Panduan memulai
Apps Script Membangun aplikasi Chat dengan Apps Script
Layanan HTTP (Cloud Run Functions) Membangun aplikasi Chat HTTP
Pub/Sub Membangun aplikasi Chat dengan Pub/Sub
Dialogflow CX Membangun aplikasi Chat Dialogflow CX
Dialogflow ES Membangun aplikasi Chat Dialogflow ES
Agen AI Agent Development Kit (ADK) Membangun aplikasi Chat agen AI ADK
Agen AI Agent2Agent (A2A) Membangun aplikasi Chat agen AI A2A
Agen AI A2UI Membangun aplikasi Chat agen AI A2UI
Agen AI Gemini Enterprise Membangun aplikasi Chat agen AI Gemini Enterprise

Membangun fitur interaktif

Tabel berikut menunjukkan dokumentasi untuk membuat fitur aplikasi Chat interaktif:

Fitur Panduan
Menerima dan merespons interaksi pengguna Menerima dan merespons interaksi pengguna
Mengirim pesan (membalas interaksi atau mengirim secara proaktif) Membalas dengan pesan atau Mengirim pesan menggunakan Chat API
Merespons perintah garis miring, perintah cepat, dan tindakan pesan Menanggapi perintah
Membangun dialog interaktif Membuka dialog interaktif
Mengumpulkan dan memproses informasi dari kartu dan dialog Membaca input data formulir yang dimasukkan oleh pengguna pada kartu
Melihat pratinjau link dalam pesan Chat Link pratinjau
Membuat halaman beranda (Beranda Aplikasi) dalam pesan langsung personal Membangun halaman beranda untuk aplikasi Chat
Menghubungkan ke sistem dan alat eksternal Menghubungkan aplikasi Chat dengan layanan dan alat lain

Batasan dan pertimbangan untuk add-on Google Workspace

Karena aplikasi Chat dibuat sebagai add-on Google Workspace yang memperluas Chat, perhatikan batasan fitur berikut:

Jika Anda memperluas add-on Google Workspace yang ada agar berfungsi di Chat, 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 add-on (addons.common) diabaikan di Chat. Untuk mengonfigurasi add-on agar berfungsi di Chat, Anda harus mengaktifkan dan mengonfigurasi Chat API. Untuk mengetahui langkah-langkahnya, lihat Mengonfigurasi Google Chat API.
  • Untuk men-deploy dan menguji add-on di Chat, Anda harus menggunakan setelan Visibilitas Chat API. Setelan visibilitas atau pengujian yang telah Anda konfigurasi di Google Workspace Marketplace SDK akan diabaikan. Untuk men-deploy versi uji add-on di Chat, lihat Menguji fitur interaktif untuk aplikasi Google Chat.
  • 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 setelan konfigurasi Chat API, aplikasi Chat yang diperbarui akan segera tersedia untuk semua pengguna lama. Untuk memperbarui listingan Marketplace, Anda dapat membuat draf sebelum mengirimkan perubahan.

Aplikasi Chat yang bukan add-on: Membangun aplikasi Google Chat interaktif

Aplikasi Chat yang bukan add-on Google Workspace dibuat sebagai aplikasi khusus Chat yang menerima peristiwa interaksi Chat API (Event) bukan objek dan tindakan peristiwa add-on Google Workspace (EventObject).

Jika Anda mengelola aplikasi Chat yang bukan add-on, Anda dapat:

  • Mengonversi aplikasi Chat yang bukan add-on menjadi add-on Google Workspace yang memperluas Google Chat. Lihat Mengonversi aplikasi Google Chat menjadi add-on Google Workspace.
  • Lihat bagian Aplikasi chat yang bukan add-on yang dapat diluaskan di bagian bawah setiap panduan fitur interaktif dalam kumpulan dokumentasi ini untuk mengetahui format permintaan dan respons.