Bagian ini menjelaskan masalah umum yang dapat Anda temui saat membangun 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 aplikasi tersebut 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 Interactive Features, pastikan setelan sesuai dengan fungsi aplikasi Anda. Jika aplikasi Chat berinteraksi dengan pengguna, pastikan Anda mengaktifkan Aktifkan fitur interaktif:
- Jika aplikasi Anda merespons pesan, pastikan Anda memilih Menerima pesan 1:1.
- Di bagian Connection settings, pastikan URL endpoint HTTP, 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 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 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
Google Workspace
menggunakan akun layanan.
Perlu diperhatikan bahwa pengguna Google Chat dapat menggunakan aplikasi Chat tanpa Akun Google Workspace Anda. Untuk mempelajari lebih lanjut cara pengguna menemukan dan menginstal Aplikasi Chat, lihat Memublikasikan aplikasi Aplikasi Google Chat.
Pengguna dapat dikecualikan dari ruang
Jika administrator Google Workspace melarang pengguna untuk mengaktifkan atau menonaktifkan histori Chat, terkadang pengguna tidak dapat bergabung atau tetap berada di ruang karena adanya perbedaan antara setelan tingkat pengguna yang memaksa histori chat diaktifkan atau dinonaktifkan dan ruang yang mewarisi setelan otomatis tingkat organisasi.
Misalnya, jika pengguna memiliki setelan histori Chat yang "aktif" secara otomatis dan ruang memiliki setelan histori Chat yang "dinonaktifkan" secara otomatis, pengguna tersebut mungkin tidak dapat bergabung ke ruang tersebut. Selain itu, pengguna tersebut dapat dihapus dari ruang jika mereka bergabung sebelum konflik, lalu memposting pesan dalam ruang setelah konflik tersebut.
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 menerima pesan {i>error<i} ini saat mencoba berinteraksi dengan Aplikasi Chat, mungkin disebabkan oleh organisasi memberikan akses ke sub-unit organisasi, tanpa mengaktifkannya untuk di unit organisasi induk.
Untuk mengetahui informasi tentang cara mengatasi masalah ini, lihat Mengizinkan pengguna menginstal aplikasi Chat.
Administrator harus memberi aplikasi cakupan otorisasi OAuth yang diperlukan untuk tindakan ini
Kapan mengautentikasi sebagai aplikasi Chat, Anda mungkin menerima pesan 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
belum memberikan persetujuan satu kali ke aplikasi Chat untuk digunakan
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,
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
https://www.googleapis.com/auth/chat.botcakupan otorisasi, yang tidak memerlukan persetujuan administrator, pertimbangkan untuk menggunakannya. Untuk memeriksa cakupan otorisasi yang didukung 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 itu tidak berfungsi, bagian berikut 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 membuka dan menjalankan kueri yang menampilkan log Cloud Function, termasuk yang sama.
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 Cloud Log fungsi.
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 Function, error tercantum di bagian Errors.
Untuk memecahkan masalah error lebih lanjut, klik error tersebut.
Memperbaiki error Cloud Function umum
Error berikut terkadang ditemui saat membuat 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 "allUsers" "Invoker Cloud Functions" peran ini berarti bahwa Cloud
Fungsi yang mendukung aplikasi tersedia untuk 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 selengkapnya tentang batasan pembatasan domain, lihat Membatasi identitas berdasarkan domain.
Untuk mengatasi masalah ini, pastikan Cloud Function Anda mengizinkan autentikasi yang tidak diautentikasi pemanggilan. Untuk mempelajari cara mengizinkan pemanggilan yang tidak diautentikasi untuk Cloud Function yang ada, lihat Mengizinkan akses publik (tidak diautentikasi).