Bagian ini menjelaskan masalah umum yang dapat Anda alami saat mem-build dan menguji aplikasi Chat.
Pesan kartu, dialog, atau pratinjau link tidak dirender atau berfungsi seperti yang diharapkan
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 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 Live - tersedia untuk pengguna.
Di bagian Fitur interaktif, pastikan setelan sesuai untuk fungsi aplikasi Anda. Jika aplikasi Chat berinteraksi dengan pengguna, pastikan Anda mengaktifkan Aktifkan fitur interaktif:
- Jika aplikasi Anda merespons pesan, pastikan Anda memilih Receive 1:1 messages.
- Pada Setelan koneksi, pastikan URL Aplikasi, ID Deployment project Apps Script, Nama Topik Cloud Pub/Sub, atau agen Dialogflow ditetapkan dengan benar dan sudah di-deploy.
- Di bagian Visibilitas, pastikan pengguna yang tepat 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
menunjukkan bahwa Akun Google yang Anda gunakan untuk mengonfigurasi
Chat API bukan bagian dari organisasi Google Workspace. Untuk mem-build
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 Memublikasikan aplikasi Google Chat.
Pengguna dapat dikecualikan dari ruang
Jika administrator Google Workspace tidak mengizinkan pengguna mengaktifkan atau menonaktifkan histori Chat, mungkin ada kalanya pengguna tidak dapat bergabung atau tetap berada di ruang karena adanya konflik antara setelan tingkat pengguna yang otomatis mengaktifkan atau menonaktifkan histori chat dan ruang yang mewarisi setelan otomatis tingkat organisasi.
Misalnya, jika pengguna memiliki setelan histori Chat yang otomatis "aktif" dan ruang memiliki setelan histori Chat "nonaktif", pengguna tersebut mungkin tidak dapat bergabung ke ruang. Selain itu, pengguna tersebut mungkin dihapus dari ruang jika bergabung sebelum konflik, lalu memposting pesan dalam ruang setelah konflik.
Dalam skenario ini, dan skenario lain saat 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 Advanced Chat Service.
Pengguna tidak dapat menambahkan aplikasi Chat ke ruang
Jika pengguna mendapatkan 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 khusus ini ke daftar yang diizinkan organisasi.
Jika pengguna mendapatkan 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 menyelesaikan masalah ini, lihat Mengizinkan pengguna menginstal aplikasi Chat.
Memecahkan masalah error Cloud Function
Jika aplikasi Chat diimplementasikan dengan Cloud Functions dan tidak berfungsi, bagian berikut akan membantu memecahkan dan memperbaiki masalah tersebut.
Memeriksa log Cloud Function
Sebagai langkah pertama, periksa log Cloud Functions untuk menemukan 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 ke dalam log tidak cukup untuk men-debug aplikasi, Anda dapat menambahkan logging tambahan dari kode Cloud Function. Baca bagian Melihat dan menulis log Cloud Function.
Memeriksa error Cloud Function
Selain log, Cloud Function juga mungkin 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 tercantum di bagian Error.
Untuk memecahkan masalah error lebih lanjut, klik error tersebut.
Memperbaiki error umum Cloud Function
Error berikut terkadang terjadi saat mem-build aplikasi Chat dengan Cloud Functions.
Fungsi 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 yang Anda deploy. Ubah nama, dan
deploy kembali fungsi tersebut. Pastikan aplikasi Chat menggunakan URL Pemicu untuk Cloud Function Anda, bukan URL Pemicu dari 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 mendapatkan error ini lalu mengirim pesan ke aplikasi Chat, Anda mendapatkan pesan 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.
Memberikan peran "Cloud Functions Invoker" kepada "allUsers" berarti Cloud Functions yang mendukung aplikasi akan tersedia untuk publik dan dapat diakses tanpa autentikasi. Untuk mempelajari cara menetapkan peran, lihat Memberikan satu peran.
Error ini mungkin berarti bahwa project Google Cloud dibatasi domain. Untuk informasi selengkapnya tentang batasan pembatasan domain, lihat Membatasi identitas menurut domain.
Untuk mengatasi masalah ini, pastikan bahwa Cloud Function Anda mengizinkan pemanggilan yang tidak diautentikasi. Untuk mempelajari cara mengizinkan pemanggilan yang tidak diautentikasi untuk Cloud Function yang ada, lihat Mengizinkan akses publik (tidak diautentikasi).