Menerima dan merespons interaksi pengguna

Halaman ini menjelaskan cara aplikasi Google Chat Anda dapat menerima dan merespons interaksi pengguna, yang juga dikenal sebagai peristiwa interaksi aplikasi Google Chat.

Peristiwa interaksi aplikasi Google Chat mewakili setiap tindakan yang dilakukan pengguna untuk memanggil atau berinteraksi dengan aplikasi Chat, seperti @menyebut aplikasi Chat atau menambahkannya ke ruang. Saat pengguna berinteraksi dengan aplikasi Chat, Google Chat akan mengirimkan peristiwa interaksi ke aplikasi Chat. Aplikasi Chat dapat menggunakan peristiwa untuk memproses interaksi dan membuat respons.

Misalnya, aplikasi Chat menggunakan peristiwa interaksi untuk melakukan salah satu hal berikut:

Contoh peristiwa interaksi Respons umum dari aplikasi Chat
Pengguna memanggil aplikasi Chat dengan @menyebutnya atau menggunakan perintah garis miring. Aplikasi Chat memproses isi pesan untuk membuat pesan. Misalnya, aplikasi Chat membalas perintah /about dengan pesan yang menjelaskan tugas yang dapat dilakukan aplikasi Chat.
Pengguna menambahkan aplikasi Chat ke ruang. Aplikasi Chat mengirim pesan aktivasi yang menjelaskan fungsinya dan cara pengguna dalam ruang berinteraksi dengannya.
Pengguna menghapus aplikasi Chat dari ruang. Aplikasi Chat menghapus semua notifikasi masuk yang dikonfigurasi untuk ruang (seperti menghapus webhook) dan mengosongkan semua penyimpanan internal.
Pengguna mengklik tombol pada kartu atau dialog yang dikirimkan oleh aplikasi Chat. Aplikasi Chat memproses dan menyimpan semua data yang dikirimkan pengguna, atau menampilkan kartu atau dialog lain.

Untuk setiap jenis interaksi pengguna, Google Chat mengirimkan jenis peristiwa interaksi berbeda yang membantu aplikasi Chat Anda menangani setiap jenis peristiwa dengan sesuai. Misalnya, Google Chat menggunakan jenis peristiwa ADDED_TO_SPACE untuk setiap interaksi ketika pengguna menambahkan aplikasi Chat ke ruang, sehingga aplikasi Chat dapat menangani respons, seperti memposting pesan selamat datang ke ruang tersebut. Untuk melihat semua peristiwa interaksi yang didukung, lihat dokumentasi referensi EventType.

Halaman ini menjelaskan cara melakukan tindakan berikut:

  • Konfigurasi aplikasi Chat Anda untuk menerima peristiwa.
  • Memproses peristiwa interaksi di infrastruktur Anda.
  • Jika memungkinkan, respons peristiwa interaksi.

Menerima peristiwa interaksi aplikasi Chat

Bagian ini menjelaskan cara menerima dan memproses peristiwa interaksi untuk aplikasi Chat Anda.

Mengonfigurasi aplikasi Chat Anda untuk menerima peristiwa interaksi

Tidak semua aplikasi Chat bersifat interaktif. Misalnya, webhook masuk hanya dapat mengirim pesan keluar dan tidak dapat merespons pengguna. Jika mem-build aplikasi Chat interaktif, Anda harus memilih endpoint yang memungkinkan aplikasi Chat menerima, memproses, dan merespons peristiwa interaksi. Untuk mempelajari lebih lanjut cara mendesain aplikasi Chat, lihat Arsitektur penerapan aplikasi Chat.

Jika telah membangun aplikasi Chat interaktif, Anda harus mengonfigurasi Google Chat API agar Google Chat dapat mengirimkan peristiwa interaksi:

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

    Buka halaman Google Chat API

  2. Klik tab Configuration.
  3. Di bagian Interactive features, klik tombol Enableinteractive features ke posisi aktif.
  4. Di Functionality, pilih salah satu atau kedua kotak centang berikut:
    1. Menerima pesan 1:1: Memungkinkan pengguna berinteraksi dengan aplikasi Chat Anda di ruang pesan langsung (DM). Aplikasi Chat Anda menerima peristiwa interaksi setiap kali pengguna mengirim pesan di ruang DM.
    2. Bergabung ke ruang dan percakapan grup: Memungkinkan pengguna menambahkan dan menghapus aplikasi Chat Anda ke ruang yang berisi lebih dari satu orang. Aplikasi Chat Anda menerima peristiwa interaksi setiap kali ditambahkan atau dihapus dari ruang, dan setiap kali pengguna memasukkan @sebutan atau menggunakan perintah garis miring di ruang.
  5. Di Setelan koneksi, tentukan ke mana Google Chat mengirim peristiwa interaksi aplikasi Chat.
  6. Opsional: Di Perintah garis miring, tambahkan dan konfigurasikan satu atau beberapa perintah garis miring. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan perintah garis miring.
  7. Opsional: Di Pratinjau link, tambahkan dan konfigurasi satu atau beberapa pola URL yang dipratinjau aplikasi Chat Anda. Untuk informasi selengkapnya, lihat Pratinjau link.
  8. Klik Save.

Aplikasi Chat Anda sekarang dikonfigurasi untuk menerima peristiwa interaksi dari Google Chat.

Menangani percobaan ulang panggilan HTTP ke layanan

Jika permintaan HTTPS ke layanan Anda gagal (seperti waktu tunggu habis, kegagalan jaringan sementara, atau kode status HTTPS non-2xx), Google Chat mungkin mencoba mengirimkan kembali beberapa kali dalam beberapa menit (tetapi ini tidak dijamin). Akibatnya, aplikasi Chat mungkin menerima pesan yang sama beberapa kali dalam situasi tertentu. Jika permintaan berhasil diselesaikan, tetapi menampilkan payload pesan yang tidak valid, Google Chat tidak akan mencoba lagi permintaan tersebut.

Memproses atau merespons peristiwa interaksi

Bagian ini menjelaskan cara aplikasi Google Chat dapat memproses dan merespons peristiwa interaksi.

Setelah aplikasi Chat Anda menerima peristiwa interaksi dari Google Chat, aplikasi tersebut dapat merespons dengan berbagai cara. Umumnya, aplikasi Chat interaktif akan membalas pengguna dengan pesan. Aplikasi Google Chat juga dapat mencari beberapa informasi dari sumber data, merekam informasi peristiwa interaksi, atau apa pun lainnya. Perilaku pemrosesan ini pada dasarnya adalah hal yang menentukan aplikasi Google Chat.

Untuk setiap peristiwa interaksi, aplikasi Chat menerima isi permintaan, yang merupakan payload JSON yang merepresentasikan peristiwa tersebut. Anda dapat menggunakan informasi tersebut untuk memproses respons. Untuk mengetahui contoh payload peristiwa, lihat Jenis peristiwa interaksi aplikasi Chat.

Diagram berikut menunjukkan cara aplikasi Google Chat biasanya memproses atau merespons berbagai jenis peristiwa interaksi:

Arsitektur cara aplikasi Google Chat memproses peristiwa interaksi.

Tampilkan respons secara real time

Peristiwa interaksi memungkinkan aplikasi Chat merespons secara real time atau secara sinkron. Respons sinkron tidak memerlukan autentikasi.

Untuk membuat respons sinkron terhadap peristiwa interaksi, lihat panduan berikut:

Untuk merespons secara sinkron, aplikasi Chat harus merespons dalam waktu 30 detik, dan respons tersebut harus diposting di ruang tempat interaksi terjadi. Jika tidak, aplikasi Chat dapat merespons secara asinkron.

Berikan respons secara asinkron

Terkadang aplikasi Chat harus merespons peristiwa interaksi setelah 30 detik atau melakukan tugas di luar ruang tempat peristiwa interaksi dibuat. Misalnya, aplikasi Chat mungkin perlu merespons pengguna setelah menyelesaikan tugas yang berjalan lama. Dalam hal ini, aplikasi Chat dapat merespons secara asinkron dengan memanggil Google Chat API.

Untuk membuat pesan menggunakan Chat API, lihat Membuat pesan. Untuk panduan penggunaan metode Chat API tambahan, lihat Ringkasan Chat API.