Ikhtisar

Bangun aplikasi Google Chat yang menghadirkan layanan dan resource Anda langsung ke dalam Google Chat, yang memungkinkan pengguna mendapatkan informasi dan mengambil tindakan tanpa keluar dari percakapan.

Google Chat mendukung kolaborasi tim dengan menyediakan hal-hal berikut:

  • Pesan langsung antar-pengguna.
  • Percakapan berangkai dalam ruang.
  • Ruang Chat yang memungkinkan Anda mendedikasikan ruang diskusi pada per proyek, per tim, atau dasar lainnya.
  • Aplikasi Chat yang dapat berpartisipasi dalam ruang atau merespons permintaan membuat pesan teks.

Pesan dan ruang

Interaksi antara Google Chat dan aplikasi Chat berlangsung menggunakan pesan dalam konteks ruang tertentu. Sebagai contoh, 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 tersedia untuk pesan dan ruang:

  • Pesan antara Google Chat dan aplikasi Chat mengikuti aturan yang telah ditentukan format pesan, dengan setiap pesan terdiri dari objek JSON yang komponennya menentukan ID pengguna, gaya, konten, dan aspek-aspek lain dari pesan tersebut. Aplikasi Chat dapat mengirimkan jenis pesan:

    • SMS berisi konten teks biasa dengan pemformatan teks terbatas.

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

      Gunakan Card Builder untuk mendesain dan melihat pratinjau pesan kartu JSON untuk aplikasi Chat:

      Membuka Card Builder

  • 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, bertindak sebagai perantara sistem tersebut.

Kemampuan ini untuk memberikan akses ke berbagai sumber daya dan alat, sementara mempertahankan pengalaman kognitif terpadu, dapat memberikan kerangka kerja bagi banyak jenis aplikasi ini, termasuk berikut ini:

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

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

  • Mencari informasi — Aplikasi Chat dapat mengambil informasi berdasarkan kueri teks terstruktur atau bebas yang dimasukkan oleh pengguna.
  • Mengajukan tiket — Aplikasi Chat dapat menghasilkan insiden laporan atau artefak lain, menggunakan informasi yang diberikan oleh pengguna.
  • Mengoordinasikan upaya — Aplikasi Chat dapat meningkatkan proses bagaimana anggota tim berinteraksi satu sama lain, seperti menyediakan "memori tim" atau penjadwalan sumber daya.

Membangun aplikasi Chat

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

Untuk setiap aplikasi Chat yang dibangun, Anda harus membuat project Google Cloud terpisah di Konsol Google Cloud. Untuk men-deploy dan membagikan Aplikasi chat dengan pengguna Google Chat lain, Anda memublikasikan dan cantumkan di Google Workspace Marketplace. Untuk mengetahui detailnya, lihat Membuat dan mengelola deployment untuk aplikasi Chat.

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 mengirim pesan langsung dengan pesan teks atau pesan melalui kartu.
  • Buka dialog untuk membantu pengguna menyelesaikan proses multi-langkah, seperti mengisi data formulir.
  • Pratinjau link dengan melampirkan kartu yang berisi informasi berguna agar pengguna dapat mengambil tindakan langsung dari percakapan.

Untuk berinteraksi dengan pengguna, aplikasi Chat Anda harus dapat menerima dan merespons peristiwa interaksi. Untuk membuat aplikasi Chat, lihat Menerima dan merespons peristiwa interaksi aplikasi Google Chat.

Aplikasi Chat noninteraktif

Aplikasi Google Chat juga bisa menjadi 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 dalam ruang tetapi pengguna tidak dapat merespons aplikasi Chat. Jenis Arsitektur aplikasi Chat berguna untuk berbagai hal seperti alarm pelaporan. Untuk informasi selengkapnya, lihat Ringkasan Google Chat API.

Aplikasi Chat berbasis peristiwa

Aplikasi Chat dapat berlangganan ke peristiwa tentang Referensi chat menggunakan Google Workspace Events API. Langganan memungkinkan aplikasi Chat Anda menerima informasi tentang peristiwa, yang mewakili perubahan pada resource Google Workspace yang berlangganan. Sebagai misalnya, aplikasi Chat dapat merespons perubahan pada ruang yang menjadi langganan aplikasi Chat, seperti mengirimkan pesan selamat datang kepada anggota baru yang ditambahkan ke ruang. Untuk informasi selengkapnya, lihat Berlangganan acara Google Chat.

Memilih arsitektur aplikasi Chat

Chat API menyediakan sejumlah cara untuk mengintegrasikan aplikasi ke dalam ruang Chat, tetapi tidak menyediakan atau mendikte cara tertentu untuk mengimplementasikan logika aplikasi Chat. Anda dapat membuat aplikasi Chat berbasis perintah atau menggunakan segala jenis layanan atau modul AI dan pemrosesan bahasa 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 informasi selengkapnya, lihat Pilih arsitektur aplikasi Chat.

Akses aplikasi ke data pengguna

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

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

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

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

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