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 merespons "Aplikasi tidak merespons", memverifikasi konfigurasi aplikasi Chat:
Di Konsol Google Cloud, klik Menu > Produk lainnya > Google Workspace > Library Produk > Google Chat API > Kelola > Konfigurasi.
Di bagian Status aplikasi, pastikan Anda memilih Live - tersedia untuk pengguna.
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 merespons pesan, pastikan Anda memilih Receive 1:1 messages.
- Di bagian Connection settings, pastikan URL Aplikasi, Deployment ID 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 ke aplikasi lagi.
Google Chat API hanya tersedia untuk pengguna Google Workspace
Saat mengonfigurasi aplikasi Chat, Anda mungkin menerima
kesalahan Google Chat API is only available to Google Workspace users. Pesan ini
berarti 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 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 informasi tentang cara menyelesaikan masalah ini, lihat Izinkan pengguna untuk menginstal aplikasi 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 mengetahui error.
Di konsol Google Cloud, buka halaman Cloud Functions:
Untuk membuka log, temukan aplikasi Cloud Chat Anda Fungsi, lalu klik Tampilkan tindakan > Lihat log.
Logs Explorer akan membuka dan menjalankan kueri yang menampilkan log Cloud Function, termasuk yang sama.
Jika informasi default yang dicatat tidak cukup untuk men-debug aplikasi, Anda bisa menambahkan logging tambahan dari kode Cloud Function Anda. Lihat Melihat dan menulis Cloud Log fungsi.
Memeriksa error Cloud Function
Selain log, Cloud Function juga dapat melaporkan error yang ditemukan sedang 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 akan Anda deploy. Ubah nama, dan
men-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 Anda mendapatkan error ini, lalu kirim pesan ke
Aplikasi Chat, Anda mendapatkan pesan error yang menyatakan bahwa aplikasi tersebut 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 "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
Berikan satu peran.
Error ini dapat berarti bahwa project Google Cloud dibatasi domain. Sebagai informasi selengkapnya tentang batasan batasan domain, lihat Membatasi identitas menurut domain.
Untuk mengatasi masalah ini, pastikan Cloud Function Anda mengizinkan autentikasi yang tidak diautentikasi pemanggilan. Untuk mempelajari cara mengizinkan pemanggilan yang tidak diautentikasi untuk terkait Cloud Function, Mengizinkan akses publik (tidak diautentikasi).