Ringkasan

Buat aplikasi Google Chat yang menghadirkan layanan dan resource Anda langsung ke Google Chat, sehingga pengguna dapat memperoleh informasi dan mengambil tindakan tanpa meninggalkan percakapan.

Google Chat mendukung kolaborasi tim dengan menyediakan hal berikut:

  • Pesan langsung antarpengguna.
  • Percakapan berangkai dalam ruang.
  • Ruang chat yang memungkinkan Anda menyediakan ruang diskusi berdasarkan per project, per tim, atau lainnya.
  • Aplikasi chat yang dapat berpartisipasi dalam ruang atau merespons pesan langsung.

Pesan dan ruang

Interaksi antara Google Chat dan aplikasi Chat terjadi menggunakan pesan dalam konteks ruang tertentu. Misalnya, aplikasi Chat dapat mengirim teks (jenis pesan) ke ruang Chat tertentu.

Pesan mencakup interaksi, teks, atau kartu aplikasi Chat, sedangkan ruang mencakup ruang chat dan pesan langsung.

Diagram sebelumnya menunjukkan berbagai jenis interaksi dan konteks yang tersedia untuk pesan dan ruang:

  • Pesan antara Google Chat dan aplikasi Chat mengikuti format pesan yang ditentukan, dengan setiap pesan terdiri dari objek JSON yang komponennya menentukan ID pengguna, gaya, konten, dan aspek pesan lainnya. Aplikasi chat dapat mengirim jenis pesan berikut:

    • Pesan teks berisi konten teks biasa dengan pemformatan teks terbatas.

    • Pesan kartu menentukan format, konten, dan perilaku kartu yang akan ditampilkan di ruang. Misalnya, pesan kartu dapat menyertakan tombol dengan link yang membuka dialog untuk mengumpulkan informasi dari pengguna.

      Gunakan Card Builder untuk mendesain dan melihat pratinjau antarmuka pengguna dan pesan untuk aplikasi Chat:

      Buka Pembuat Kartu

  • Di Google Chat, ruang dapat memiliki konteks berikut:

    • Ruang bernama atau grup dapat dilihat oleh beberapa pengguna.
    • Pesan langsung hanya dapat dilihat oleh pengguna di ruang tersebut.

Kasus penggunaan

Menambahkan aplikasi Chat ke platform percakapan seperti Chat memungkinkan pengguna mengajukan pertanyaan, dan mengeluarkan perintah, tanpa mengubah konteks. Di backend-nya, aplikasi Chat dapat mengakses sistem lain, yang bertindak sebagai perantara untuk sistem tersebut.

Kemampuan ini untuk memberikan akses ke berbagai resource dan alat, sekaligus mempertahankan pengalaman kognitif terpadu, dapat memberikan framework untuk banyak jenis aplikasi, termasuk yang berikut ini:

  • Pengelolaan alur kerja
  • Penyiapan dan konfigurasi
  • Pembuatan pesanan
  • Telusuri
  • Pengumpulan data

Beberapa contoh hal yang dapat Anda minta kepada aplikasi Chat untuk dilakukan dari dalam ruang Chat mencakup hal berikut:

  • Mencari informasi — Aplikasi Chat dapat mengambil informasi berdasarkan kueri teks terstruktur atau bebas yang dimasukkan oleh pengguna.
  • Mengajukan tiket — Aplikasi Chat dapat membuat laporan insiden atau artefak lainnya, menggunakan informasi yang diberikan oleh pengguna.
  • Mengkoordinasikan upaya — Aplikasi Chat dapat meningkatkan cara anggota tim berinteraksi satu sama lain, seperti menyediakan "kenangan tim" atau menjadwalkan referensi.

Mem-build aplikasi Chat

Bagian ini menjelaskan beberapa jenis aplikasi Chat yang dapat Anda build.

Untuk setiap aplikasi Chat yang Anda build, Anda harus membuat project Google Cloud terpisah di konsol Google Cloud. Untuk men-deploy dan membagikan aplikasi Chat dengan pengguna Google Chat lainnya, Anda memublikasikan dan mencantumkannya di Google Workspace Marketplace. Untuk mengetahui detailnya, lihat Membuat dan mengelola deployment untuk aplikasi Chat.

Aplikasi Chat interaktif

Banyak aplikasi Chat yang memungkinkan pengguna mengirim pesan dan berinteraksi dengan aplikasi Chat secara langsung. Aplikasi Chat interaktif dapat melakukan salah satu hal berikut:

  • Respons @sebutan, perintah garis miring, atau pesan langsung dengan pesan teks atau pesan kartu.
  • Buka dialog untuk membantu pengguna menyelesaikan proses multi-langkah, seperti mengisi data formulir.
  • Lihat pratinjau link dengan melampirkan kartu yang berisi informasi bermanfaat yang memungkinkan pengguna mengambil tindakan langsung dari percakapan.

Untuk berinteraksi dengan pengguna, aplikasi Chat Anda harus dapat menerima dan merespons peristiwa interaksi. Untuk mem-build aplikasi Chat interaktif, lihat Menerima dan merespons peristiwa interaksi aplikasi Google Chat.

Aplikasi Chat noninteraktif

Aplikasi Google Chat juga dapat bersifat non-interaktif bagi pengguna, sehingga pengguna tidak dapat berinteraksi langsung dengan aplikasi Chat, tetapi aplikasi Chat memanggil Google Chat API secara langsung. Misalnya, Anda dapat membuat aplikasi Chat yang mengirim pesan di ruang, tetapi pengguna tidak dapat merespons aplikasi Chat. Jenis arsitektur aplikasi Chat ini berguna untuk hal-hal seperti pelaporan alarm. Untuk mengetahui informasi selengkapnya, lihat ringkasan Google Chat API.

Aplikasi Chat berbasis peristiwa

Aplikasi Chat dapat berlangganan peristiwa tentang resource Chat menggunakan Google Workspace Events API. Langganan memungkinkan aplikasi Chat Anda menerima informasi tentang peristiwa, yang mewakili perubahan pada resource Google Workspace yang dilanggani. Misalnya, aplikasi Chat dapat merespons perubahan pada ruang yang diikuti aplikasi Chat, seperti mengirim pesan selamat datang kepada anggota baru yang ditambahkan ke ruang. Untuk informasi selengkapnya, lihat Berlangganan peristiwa Google Chat.

Memilih arsitektur aplikasi Chat

Chat API menyediakan sejumlah cara untuk mengintegrasikan aplikasi ke ruang Chat, tetapi tidak menyediakan atau menentukan cara tertentu untuk menerapkan logika aplikasi Chat. Anda dapat membuat aplikasi Chat berbasis perintah atau menggunakan jenis pemrosesan bahasa dan layanan atau modul AI apa pun yang Anda sukai, dan Anda dapat melakukannya di berbagai platform, termasuk yang berikut ini:

  • AppSheet
  • Google Apps Script
  • Dialogflow
  • Pub/Sub
  • Google Cloud atau server HTTP lokal

Untuk mengetahui informasi selengkapnya, lihat Memilih arsitektur aplikasi Chat.

Akses aplikasi ke data pengguna

Saat dipanggil, aplikasi Chat perlu mengetahui siapa yang memanggilnya, dalam konteks apa, dan cara memanggil pemanggil. Untuk mengakses data di luar data identitas dasar ini, aplikasi Chat harus diberi akses melalui autentikasi.

  • Secara default, aplikasi Chat hanya dapat membaca identitas dasar pengguna yang memanggilnya atau pengguna yang @disebutkan dalam pesan yang sama yang memanggil aplikasi. Informasi ini mencakup nama tampilan, ID pengguna, alamat email, dan gambar avatar pengguna.

  • Untuk aplikasi Chat yang melihat pratinjau link, aplikasi Chat dapat membaca URL yang ditambahkan ke pesan yang cocok dengan pola URL yang dikonfigurasi aplikasi Chat.

  • Jika aplikasi Chat perlu mengakses data lain untuk memberikan kemampuan yang ditingkatkan kepada pengguna, seperti membaca semua pesan atau daftar anggota di ruang, siapkan autentikasi agar dapat mengakses data tersebut. Jika mengakses data pengguna, aplikasi Chat akan meminta pengguna untuk meminta akses, dan pengguna harus memberikannya. Untuk mempelajari lebih lanjut, lihat Menghubungkan aplikasi Chat dengan layanan & alat lainnya.

Ingin melihat cara kerja Google Chat API?
Channel Google Workspace Developers menawarkan video tentang tips, trik, dan fitur terbaru.