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 > Produk lainnya > Google Workspace > Product Library > Google Chat API > Manage > Configuration.
Di bagian Status aplikasi, pastikan Anda memilih Live - available to users.
Di bagian Fitur interaktif, pastikan setelan sesuai dengan fungsi aplikasi Anda. Jika aplikasi Chat berinteraksi dengan pengguna, pastikan Anda mengaktifkan Aktifkan fitur interaktif:
- Jika aplikasi merespons pesan, pastikan Anda memilih Receive 1:1 messages.
- Di bagian Connection settings, pastikan URL endpoint HTTP, Deployment ID project Apps Script, Topic Name Cloud Pub/Sub, atau agen Dialogflow ditetapkan 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 lagi ke aplikasi.
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 bahwa Akun Google yang telah Anda gunakan untuk mengonfigurasi Chat API
bukan bagian dari organisasi Google Workspace. Untuk membangun
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 mengaktifkan atau menonaktifkan histori chat secara otomatis dan ruang yang mewarisi setelan otomatis tingkat organisasi.
Misalnya, jika pengguna memiliki setelan Histori chat yang diaktifkan secara otomatis "aktif" dan ruang memiliki setelan Histori chat yang diaktifkan secara otomatis "nonaktif", pengguna tersebut mungkin tidak dapat bergabung ke ruang. Selain itu, pengguna tersebut dapat dihapus dari ruang jika ia bergabung sebelum konflik terjadi, lalu memposting pesan di ruang setelah konflik.
Dalam skenario ini, dan skenario lain yang menimbulkan 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 melihat 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 melihat pesan error ini saat mencoba berinteraksi dengan aplikasi Chat, hal tersebut 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 melakukan autentikasi 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 bahwa administrator Google Workspace belum
memberikan persetujuan satu kali kepada 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, mungkin:
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, sebaiknya gunakan metode tersebut. Untuk memeriksa cakupan otorisasi mana yang didukung metode, lihat Mengautentikasi serta mengizinkan aplikasi Google Chat dan permintaan Google Chat API.
Memecahkan masalah error Cloud Function
Jika aplikasi Chat diimplementasikan dengan Cloud Functions dan tidak berfungsi, bagian berikut akan membantu memecahkan dan memperbaiki masalah.
Memeriksa log Cloud Function
Sebagai langkah pertama, periksa log Cloud Functions untuk mengetahui 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 membuka 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. Lihat Melihat dan menulis log Cloud Function.
Memeriksa error Cloud Function
Selain log, Cloud Function mungkin juga 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 Cloud Function umum
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, lalu deploy fungsi lagi. 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 Functions, 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 akan mendapatkan error yang menyatakan bahwa aplikasi tidak merespons karena Google Chat tidak dapat menjangkau server yang menghosting Cloud Functions. 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 tersedia secara publik dan dapat diakses tanpa autentikasi. Untuk mempelajari cara menetapkan peran, lihat
Memberikan satu peran.
Error ini dapat berarti bahwa project Google Cloud dibatasi domain. Untuk mengetahui informasi lebih lanjut tentang batasan pembatasan domain, lihat Membatasi identitas berdasarkan domain.
Untuk mengatasi masalah ini, pastikan 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).