# Google Chat Integrasi untuk Botpress Penyepaduan ini membolehkan anda menyambungkan anda Botpress chatbot dengan Google Chat spaces, membolehkan komunikasi lancar antara bot anda dan Google Chat pengguna. ## Ciri - Hantar dan terima mesej dalam Google Chat spaces - Pengendalian dan respons mesej automatik - Sokongan untuk berbilang Google Chat spaces - Pengesahan selamat menggunakan Akaun Perkhidmatan Google ## Prasyarat 1. Akaun Google Cloud Platform (GCP) 2. Google Chat ruang di mana anda ingin menggunakan bot 3 anda. Botpress contoh dengan Google Chat integrasi dipasang ## Arahan Persediaan ### 1. Dayakan Google Chat API 1. Pergi ke [Google Cloud Console](https://console.cloud.google.com) 2. Navigasi ke "API & Services" > "Library" 3. Cari "Google Chat API" 4. Klik pada Google Chat API 5. Klik "Dayakan" untuk mengaktifkan API untuk projek anda ### 2. Buat Akaun Perkhidmatan Google 1. Pergi ke [Google Cloud Console](https://console.cloud.google.com) 2. Buat projek baharu atau pilih yang sedia ada 3. Navigasi ke "IAM & Pentadbir" > "Akaun Perkhidmatan" 4. Klik "Buat Akaun Perkhidmatan dan Isi Perkhidmatan C5" dalam klik "Buat Akaun Perkhidmatan C5. 6. Buat kunci baharu untuk akaun perkhidmatan: - Klik pada akaun perkhidmatan - Pergi ke tab "Kunci" - Klik "Tambah Kunci" > "Buat kunci baharu" - Pilih format JSON - Muat turun fail kunci ### 3. Konfigurasikan Google Chat Tetapan Apl 1. Pergi ke [Google Cloud Console](https://console.cloud.google.com) 2. Navigasi ke "API & Services" > "Google Chat API" 3. Klik pada "Konfigurasi" 4. Sediakan apl anda dengan tetapan berikut: - **Nama Apl**: Pilih nama untuk bot anda - **Penerangan**: Tambah penerangan tentang kefungsian bot anda - **URL Avatar**: Tambah URL untuk imej avatar bot anda - **Ciri**: - Dayakan ciri interaktif - Dayakan menerima 1-1 ruang perbualan kumpulan**** Tetapkan ini kepada anda Botpress webhook URL ditemui dalam Google Chat Konfigurasi Integrasi. ### 4. Konfigurasikan Integrasi dalam Botpress 1. Dalam anda Botpress contohnya, pergi ke bahagian Integrasi 2. Cari dan pilih Google Chat penyepaduan 3. Konfigurasikan tetapan berikut: - **Akaun Perkhidmatan JSON**: Tampalkan keseluruhan kandungan fail kunci akaun perkhidmatan anda yang dimuat turun - **Ruang Lalai**: Masukkan ID Google lalai anda Chat ruang (pilihan) ### 5. Tambahkan Bot pada Google Anda Chat Ruang 1. Buka Google anda Chat ruang 2. Klik pada nama ruang untuk membuka butiran ruang 3. Pergi ke "Apl & integrasi" 4. Klik "Tambah aplikasi" 5. Cari bot anda menggunakan e-mel akaun perkhidmatan 6. Tambah bot ke ruang anda ## Penggunaan ### Menghantar Mesej Bot boleh menghantar mesej kepada mana-mana Google Chat ruang yang telah ditambah kepadanya. Mesej boleh dihantar: - Sebagai tindak balas kepada mesej pengguna - Secara proaktif melalui Botpress editor aliran - Melalui panggilan API daripada kod tersuai anda ### Menerima Mesej Bot secara automatik menerima dan memproses mesej yang dihantar dalam Google Chat angkasa lepas. Ia akan: - Menghuraikan mesej masuk - Memprosesnya melalui anda Botpress flows - Hantar balasan yang sesuai kembali ke ruang ### Format Mesej Penyepaduan menyokong mesej teks dalam Google Chat ruang. Mesej boleh termasuk: - Teks biasa - Pemformatan asas - Pautan - Sebutan ## Pertimbangan Keselamatan - Pastikan kunci akaun perkhidmatan anda selamat dan jangan sekali-kali berkongsinya secara terbuka - Sentiasa gilirkan kunci akaun perkhidmatan anda - Gunakan prinsip keistimewaan yang paling sedikit apabila memberikan peranan kepada akaun perkhidmatan anda - Pantau aktiviti bot anda dan sediakan pengelogan yang sesuai ## Penyelesaian masalah tidak membetulkan perkhidmatan ## **Menyelesaikan masalah tidak membetulkan akaun ##**Menyelesaikan masalah ##1**Menyelesaikan masalah. kebenaran - Semak sama ada bot ditambah dengan betul pada ruang - Pastikan penyepaduan dikonfigurasikan dengan betul Botpress 2. **Ralat pengesahan** - Sahkan akaun perkhidmatan JSON diformat dengan betul - Semak sama ada kunci akaun perkhidmatan adalah sah dan tidak tamat tempoh - Pastikan akaun perkhidmatan mempunyai skop API yang diperlukan didayakan 3. **Isu penghantaran mesej** - Sahkan ID ruang adalah betul - Semak sama ada bot mempunyai kebenaran untuk menyiarkan dalam ruang - Pastikan format mesej adalah sah ## butiran API tentang Rujukan Untuk Google Chat API, rujuk [dokumentasi rasmi](https://developers.google.com/chat/api/reference/rest).
