Mengonfigurasi aplikasi Google Chat

Halaman ini menjelaskan cara mengonfigurasi dan men-deploy aplikasi Google Chat sebagai add-on Google Workspace.

Untuk men-deploy dan menguji add-on Google Workspace yang memperluas Chat, Anda harus mengaktifkan dan mengonfigurasi aplikasi Chat menggunakan Google Chat API. Setelan konfigurasi Chat API adalah tempat Anda menentukan semua detail tentang aplikasi Chat, termasuk nama, avatar, deployment, dan fitur interaktif yang ingin Anda gunakan.

Prasyarat

HTTP

Apps Script

Memilih nama tampilan, avatar, dan deskripsi untuk aplikasi Chat Anda

Nama, avatar, dan deskripsi aplikasi Chat ditampilkan kepada pengguna di UI Chat. Untuk berinteraksi dengan aplikasi Chat, pengguna melihat atau menggunakan informasi ini dengan cara berikut:

  • @menyebut aplikasi Chat untuk menambahkannya ke ruang atau mengirimnya.
  • Temukan dan mulai pesan langsung dengan aplikasi Chat. Pada menu Aplikasi, pesan langsung menampilkan nama dan avatar aplikasi Chat.
  • Dari kolom tulis, pengguna dapat menjelajahi aplikasi Chat serta melihat nama, avatar, dan deskripsinya.

Sebelum mengonfigurasi aplikasi Chat, Anda harus menyiapkan informasi berikut:

Kolom Deskripsi Format
Nama aplikasi Nama tampilan untuk aplikasi Chat. Hingga 25 karakter alfanumerik
URL avatar Gambar yang ditampilkan sebagai avatar aplikasi Chat Anda. URL HTTPS yang mengarah ke gambar grafis persegi (PNG atau JPEG). Ukuran yang direkomendasikan adalah 256 x 256 piksel atau lebih.
Deskripsi Deskripsi singkat tentang tujuan aplikasi Chat. Hingga 40 karakter alfanumerik

Di bagian berikut, Anda akan menetapkan informasi ini di setelan konfigurasi di Chat API.

Mengonfigurasi aplikasi Chat Anda di Konsol Google Cloud

Setelah Anda memiliki detail aplikasi Chat, buka project Cloud dan konfigurasikan Chat API:

  1. Di konsol Google Cloud, buka halaman Chat API lalu klik halaman Configuration:

    Buka halaman Konfigurasi Chat API

  2. Di bagian Application info, isi kolom App name, Avatar URL, dan Description.

  3. Di bagian Interactive features, klik Enableinteractive features ke posisi aktif dan selesaikan langkah-langkah berikut:

    1. Di bagian Functionality, pilih satu atau beberapa kotak centang agar aplikasi Chat Anda tersedia untuk diinstal dan digunakan:

      • Menerima pesan 1:1: Pengguna dapat menginstal dan mengirim pesan dengan aplikasi Chat di ruang khusus antara pengguna dan aplikasi Chat.

      • Bergabung ke ruang dan percakapan grup: Pengguna dapat menambahkan dan berinteraksi dengan aplikasi Chat di ruang dengan beberapa orang.

    2. Di bagian Connection settings, pilih arsitektur yang ingin Anda gunakan untuk menerima objek peristiwa dari Chat:

      • Untuk menggunakan layanan HTTP, pilih URL endpoint HTTP, lalu masukkan URL.
      • Untuk menggunakan project Google Apps Script, pilih Apps Script dan berikan ID deployment untuk project tersebut.

    3. Opsional: Untuk menerima objek peristiwa ke lebih dari satu endpoint atau fungsi, buka Setelan koneksi > Pemicu dan berikan atau perbarui fungsi callback untuk Pemicu Chat berikut:

      • Ditambahkan ke ruang: Pengguna menambahkan aplikasi Chat ke percakapan grup atau ruang, atau menginstal aplikasi Chat untuk pesan 1:1.
      • Pesan: Pengguna mengirim pesan ke aplikasi Chat. Misalnya, mengirim pesan langsung ke aplikasi Chat atau @menyebut aplikasi Chat di ruang dengan beberapa orang.
      • Dihapus dari ruang: Pengguna meng-uninstal atau menghapus aplikasi Chat dari ruang.
      • Perintah aplikasi: Pengguna menggunakan perintah cepat atau perintah garis miring dari aplikasi Chat.

    4. Opsional: Tambahkan fitur interaktif lainnya seperti perintah cepat, perintah garis miring, atau pratinjau link.

    5. Di bagian Visibility, tentukan email sehingga Anda dapat menginstal dan menguji aplikasi Chat sebelum memublikasikan ke Google Workspace Marketplace. Anda dapat menentukan hingga lima individu, atau satu atau beberapa Google Grup dari organisasi Google Workspace Anda.

  4. Opsional: Di bagian Logs, centang kotak Log errors to Logging untuk menggunakan Google Cloud Logging. Untuk mengetahui informasi selengkapnya, lihat Mengkueri log error untuk aplikasi Chat di dokumentasi Chat API.

  5. Klik Simpan.

Setelah Anda menyimpan konfigurasi, siapa pun yang Anda tentukan di setelan Visibility Chat API dapat menginstal, menguji, atau menggunakan aplikasi Chat. Untuk mulai menguji dan men-debug aplikasi Chat, baca artikel Menguji fitur interaktif untuk aplikasi Google Chat dalam dokumentasi Chat API.

Pertimbangan untuk add-on Google Workspace yang ada

Aplikasi chat memerlukan konfigurasi yang berbeda dibandingkan add-on Google Workspace yang memperluas aplikasi Google Workspace lainnya. Jika add-on Anda memperluas aplikasi Google Workspace lainnya, pertimbangkan persyaratan berikut untuk mengonfigurasi aplikasi Chat:

  • Baik individu maupun administrator Google Workspace harus dapat menginstal add-on Anda dari Marketplace. Konfigurasi setelan penginstalan ini di Google Workspace Marketplace SDK.
  • Aplikasi Chat tidak menggunakan nama dan logo yang Anda konfigurasi untuk aplikasi Google Workspace lainnya di objek addons.common manifes.
  • Untuk add-on yang dipublikasikan ke Google Workspace Marketplace, Anda tidak dapat menyimpan draf perubahan apa pun pada setelan konfigurasi Google Chat API. Setelah memperbarui dan menyimpan setelan konfigurasi Chat API, aplikasi Chat yang diupdate akan tersedia untuk semua pengguna yang sudah ada. Untuk memperbarui listingan Marketplace, Anda dapat membuat draf sebelum mengirimkan perubahan apa pun.

  • Jika Anda membuat add-on menggunakan Apps Script:

    • Anda harus menggunakan ID deployment Apps Script yang sama dengan yang digunakan untuk konfigurasi add-on lainnya.
    • Anda tidak dapat menggunakan editor Apps Script untuk menginstal deployment pengujian di Chat. Sebagai gantinya, Anda harus menginstalnya langsung dari UI Chat.

  • Jika Anda membuat add-on menggunakan layanan HTTP, hapus detail konfigurasi aplikasi Chat di manifes dan deployment yang Anda buat menggunakan API add-on Google Workspace. Deployment HTTP yang Anda tentukan di Google Workspace Marketplace SDK hanya digunakan untuk aplikasi Google Workspace lainnya.