Bagian ini menjelaskan masalah umum yang dapat Anda alami saat membuat dan menguji aplikasi Chat.
Pesan kartu, dialog, atau pratinjau link tidak dirender atau berfungsi sebagaimana mestinya
Untuk mendapatkan bantuan dalam memecahkan masalah error kartu, lihat Memecahkan masalah dan memperbaiki kartu.
Aplikasi tidak merespons
Jika Anda mengirim pesan ke aplikasi Chat dan aplikasi merespons "Aplikasi tidak merespons", verifikasi konfigurasi aplikasi Chat:
Di konsol Google Cloud, klik Menu > More products > Google Workspace > Product Library > Google Chat API > Manage > Configuration.
Di bagian Status aplikasi, pastikan Anda memilih Aktif - tersedia untuk pengguna.
Di bagian Fitur interaktif, pastikan setelan sesuai untuk fungsi aplikasi Anda. Jika aplikasi Chat Anda berinteraksi dengan pengguna, pastikan Anda mengaktifkan Aktifkan fitur interaktif:
- Secara default, aplikasi dapat merespons pesan langsung dari pengguna.
- Jika aplikasi Anda merespons pesan di ruang dan chat grup, pilih Join spaces and group conversations.
- Di bagian Connection settings, pastikan HTTP endpoint URL, Deployment ID project Apps Script, Topic Name Cloud Pub/Sub, atau agen Dialogflow disetel dengan benar dan di-deploy.
- Di bagian Visibilitas, pastikan pengguna yang sesuai memiliki akses ke aplikasi dengan alamat email atau grup di domain Google Workspace. Jika aplikasi di-deploy dengan Google Workspace Marketplace SDK, setelan visibilitas tidak diperlukan karena setelan Google Workspace Marketplace lebih diutamakan.
Jika aplikasi dipublikasikan dengan Google Workspace Marketplace SDK, tinjau setelan Google Workspace Marketplace.
Klik Simpan.
Coba kirim pesan ke aplikasi lagi.
Google Chat API hanya tersedia untuk pengguna Google Workspace
Saat mengonfigurasi aplikasi Chat, Anda mungkin menerima error Google Chat API is only available to Google Workspace users. Pesan ini berarti Akun Google yang Anda gunakan untuk mengonfigurasi Chat API bukan bagian dari organisasi Google Workspace. Untuk membuat aplikasi Chat atau menggunakan Chat API, Anda harus menggunakan akun Google Workspace.
Perhatikan bahwa pengguna Google Chat dapat menggunakan aplikasi Chat tanpa akun Google Workspace. Untuk mempelajari lebih lanjut cara pengguna menemukan dan menginstal aplikasi Chat, lihat Membangun aplikasi Google Chat interaktif.
Pengguna dapat dikecualikan dari ruang
Jika administrator Google Workspace melarang pengguna mengaktifkan atau menonaktifkan Histori chat, mungkin ada saat ketika pengguna tidak dapat bergabung atau tetap berada di ruang karena konflik antara setelan tingkat pengguna yang mengaktifkan atau menonaktifkan histori chat secara otomatis dan ruang yang mewarisi setelan otomatis tingkat organisasi.
Misalnya, jika pengguna memiliki setelan Histori chat yang otomatis "diaktifkan" dan ruang memiliki setelan Histori chat yang otomatis "dinonaktifkan", pengguna tersebut mungkin tidak dapat bergabung ke ruang. Selain itu, pengguna tersebut mungkin dikeluarkan dari ruang jika dia bergabung sebelum konflik dan kemudian memposting pesan di ruang setelah konflik.
Dalam skenario ini, dan skenario lain yang terdapat konflik antara setelan histori, Chat API mungkin tidak dapat membuat keanggotaan, atau membuat pesan dengan autentikasi pengguna dapat menghapus pengguna yang diautentikasi dengan setelan histori Chat yang bertentangan dari ruang.
Untuk mempelajari lebih lanjut, lihat Pengguna dapat dikecualikan dari ruang di Pusat Bantuan Admin Google Workspace.
Memecahkan masalah layanan Chat Lanjutan di Google Apps Script
Lihat halaman Apps Script tentang Layanan Chat Lanjutan.
Pengguna tidak dapat menambahkan aplikasi Chat ke ruang
Jika pengguna mengalami pesan error
This organization's administrator must allow users to install this Chat app
saat mencoba menambahkan aplikasi Chat ke ruang, error ini
mungkin disebabkan oleh salah satu alasan berikut:
- Organisasi telah menonaktifkan aplikasi Chat.
- Organisasi belum menambahkan aplikasi Chat tertentu ini ke daftar yang diizinkan organisasi.
Jika pengguna mengalami pesan error ini saat mencoba berinteraksi dengan aplikasi Chat, hal ini mungkin disebabkan oleh organisasi yang memberikan akses ke sub-unit organisasi, tanpa mengaktifkannya untuk unit organisasi induk.
Untuk mengetahui informasi tentang cara mengatasi masalah ini, lihat Mengizinkan pengguna menginstal aplikasi Chat.
Administrator harus memberikan cakupan otorisasi OAuth yang diperlukan untuk tindakan ini kepada aplikasi
Saat mengautentikasi sebagai aplikasi Chat, Anda mungkin menerima error berikut:
<HttpError 403 when requesting https://chat.googleapis.com/v1/spaces/{space}?alt=json returned "The administrator must grant the app the required OAuth authorization scope for this action.". Details: "The administrator must grant the app the required OAuth authorization scope for this action.">
Pesan error ini berarti administrator Google Workspace belum memberikan persetujuan satu kali ke aplikasi Chat untuk menggunakan cakupan otorisasi yang dimulai dengan nama https://www.googleapis.com/auth/chat.app.*.
Untuk mengatasi error:
- Minta administrator Google Workspace untuk
memberikan persetujuan ke aplikasi Chat Anda.
Saat menangani error ini dalam logika aplikasi Chat Anda,
pertimbangkan untuk mengirim pesan yang mengumumkan bahwa
aplikasi Chat memerlukan persetujuan administrator untuk melakukan
tindakan yang diminta, misalnya:
To perform this action, I need approval. <https://support.google.com/a?p=chat-app-auth|Learn more>. - Jika metode Chat API mendukung cakupan otorisasi
https://www.googleapis.com/auth/chat.bot, yang tidak memerlukan persetujuan administrator, pertimbangkan untuk menggunakannya. Untuk memeriksa cakupan otorisasi yang didukung suatu metode, lihat Mengautentikasi serta mengizinkan aplikasi Google Chat dan permintaan API Google Chat.
Memecahkan masalah error Cloud Function
Jika aplikasi Chat diimplementasikan dengan Cloud Functions dan tidak berfungsi, bagian berikut akan membantu memecahkan masalah dan memperbaikinya.
Memeriksa log Cloud Function
Sebagai langkah pertama, periksa log Cloud Functions untuk mengetahui apakah ada error.
Di konsol Google Cloud, buka halaman Cloud Functions:
Untuk membuka log, temukan Cloud Function aplikasi Chat Anda, lalu klik Show actions > View logs.
Logs Explorer akan terbuka dan menjalankan kueri yang menampilkan log Cloud Function, termasuk error.
Jika informasi default yang dicatat tidak cukup untuk men-debug aplikasi, Anda dapat menambahkan logging tambahan dari kode Cloud Function. Lihat Melihat dan menulis log Cloud Function.
Memeriksa error Cloud Function
Selain log, Cloud Function juga dapat melaporkan error yang terjadi saat berjalan.
Di konsol Google Cloud, buka halaman Cloud Functions:
Klik Cloud Function aplikasi Chat Anda.
Di halaman Detail fungsi, error dicantumkan di bagian Error.
Untuk memecahkan masalah error lebih lanjut, klik error tersebut.
Memperbaiki error umum Cloud Function
Error berikut terkadang terjadi saat membangun aplikasi Chat dengan Cloud Functions.
Function ChatApp di region REGION_NAME dalam project PROJECT_NAME sudah ada
Saat men-deploy Cloud Function, Anda mungkin menerima error Function
ChatApp in region REGION_NAME in project PROJECT_NAME already
exists. Pesan ini berarti bahwa Cloud Function lain memiliki nama yang sama dengan Cloud Function yang Anda deploy. Ubah nama, lalu deploy ulang fungsi. Pastikan aplikasi Chat menggunakan URL Pemicu untuk
Cloud Function Anda, bukan URL Pemicu Cloud Function yang sudah ada.
Satu atau beberapa pengguna yang disebutkan dalam kebijakan bukan milik pelanggan yang diizinkan
Saat men-deploy Cloud Function, Anda mungkin menerima error The operation
cannot be completed on the function: "One or more users named in the policy do
not belong to a permitted customer." Jika Anda mendapatkan error ini, lalu mengirim pesan ke aplikasi Chat, Anda akan mendapatkan error yang menyatakan bahwa aplikasi tidak merespons karena Google Chat tidak dapat menjangkau server yang menghosting Cloud Function. Pesan ini berarti bahwa
pengguna bernama "allUsers" tidak memiliki izin untuk memanggil Cloud Function.
Memberi "allUsers" peran "Cloud Functions Invoker" berarti Cloud Function yang mendukung aplikasi tersedia secara publik dan dapat diakses tanpa autentikasi. Untuk mempelajari cara menetapkan peran, lihat bagian Memberikan satu peran.
Error ini mungkin berarti bahwa project Google Cloud dibatasi domainnya. Untuk mengetahui informasi selengkapnya tentang batasan pembatasan domain, lihat Membatasi identitas berdasarkan domain.
Untuk mengatasi masalah ini, verifikasi bahwa Cloud Function Anda mengizinkan pemanggilan yang tidak diautentikasi. Untuk mempelajari cara mengizinkan pemanggilan tanpa autentikasi untuk Cloud Function yang sudah ada, lihat Mengizinkan akses publik (tanpa autentikasi).