Ringkasan

Bangun 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 memberikan hal-hal berikut:

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

Pesan dan ruang

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

Pesan mencakup interaksi aplikasi Chat, teks, atau kartu, 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 telah ditentukan, di mana 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 format teks terbatas.
    • Pesan kartu menentukan format, konten, dan perilaku kartu yang akan ditampilkan dalam ruang. Misalnya, pesan kartu dapat menyertakan tombol dengan link yang membuka dialog untuk mengumpulkan informasi dari pengguna.


      Desain dan pratinjau kartu dengan Pembuat Kartu.

      Buka Pembuat Kartu

  • Di Google Chat, ruang dapat memiliki konteks berikut:

    • Ruang yang diberi nama 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 orang mengajukan pertanyaan dan memberikan perintah, tanpa mengubah konteks. Di backend-nya, aplikasi Chat dapat mengakses sistem lain, yang bertindak sebagai perantara bagi sistem tersebut.

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

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

Beberapa contoh hal yang mungkin Anda minta untuk dilakukan aplikasi Chat dari dalam ruang Chat meliputi:

  • Mencari informasi — Aplikasi Chat dapat mengambil informasi berdasarkan kueri teks bebas atau terstruktur yang dimasukkan oleh pengguna.
  • Tiket file — Aplikasi Chat dapat membuat laporan insiden atau artefak lain, menggunakan informasi yang diberikan oleh pengguna.
  • Mengoordinasikan upaya — Aplikasi Chat dapat meningkatkan cara anggota tim berinteraksi satu sama lain, seperti menyediakan "memori tim" atau menjadwalkan resource.

Membangun aplikasi Chat

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

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

Aplikasi Chat interaktif

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

  • Tanggapi @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 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, baca artikel Menerima dan merespons peristiwa interaksi aplikasi Google Chat.

Aplikasi Chat noninteraktif

Aplikasi Google Chat juga dapat bersifat non-interaktif bagi pengguna yang 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 acara 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 berlangganan. Misalnya, aplikasi Chat dapat merespons perubahan pada ruang yang menjadi langganan aplikasi Chat, seperti mengirim pesan selamat datang kepada anggota baru yang ditambahkan ke ruang. Untuk mengetahui informasi selengkapnya, lihat Berlangganan peristiwa Google Chat.

Memilih arsitektur aplikasi Chat

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

  • AppSheet
  • Google Apps Script
  • 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 menangani pemanggilan. 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 memanggil mereka atau pengguna yang @disebut dalam pesan yang sama dengan 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 dalam 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.