Ruang Chat Google

  Integrasi Google Chat untuk Botpress
# Integrasi Google Chat untuk Botpress

Integrasi ini memungkinkan Anda untuk menghubungkan chatbot Botpress Anda dengan ruang Google Chat , memungkinkan komunikasi yang lancar antara bot Anda dan pengguna Google Chat .

## Fitur

- Mengirim dan menerima pesan di ruang Google Chat 
- Penanganan dan tanggapan pesan otomatis
- Dukungan untuk beberapa ruang Google Chat 
- Autentikasi aman menggunakan Akun Layanan Google

## Prasyarat

1. Akun Google Cloud Platform (GCP)
2. Ruang Google Chat tempat Anda ingin menerapkan bot Anda
3. Instance Botpress dengan integrasi Google Chat yang sudah terpasang

## Petunjuk Penyiapan

### 1. Aktifkan Google Chat API

1. Buka [Google Cloud Console](https://console.cloud.google.com)
2. Buka "API & Layanan"> "Perpustakaan"
3. Cari "Google Chat API"
4. Klik pada Google Chat API
5. Klik "Aktifkan" untuk mengaktifkan API untuk proyek Anda

### 2. Membuat Akun Layanan Google

1. Buka [Google Cloud Console](https://console.cloud.google.com)
2. Buat proyek baru atau pilih proyek yang sudah ada
3. Arahkan ke "IAM & Admin"> "Akun Layanan"
4. Klik "Buat Akun Layanan"
5. Isi detail akun layanan dan klik "Buat"
6. Buat kunci baru untuk akun layanan:
   - Klik pada akun layanan
   - Buka tab "Kunci"
   - Klik "Tambah Kunci" > "Buat kunci baru"
   - Pilih format JSON
   - Unduh file kunci

### 3. Mengonfigurasi Pengaturan Aplikasi Google Chat 

1. Buka [Google Cloud Console](https://console.cloud.google.com)
2. Buka "API & Layanan" > "Google Chat API"
3. Klik "Konfigurasi"
4. Siapkan aplikasi Anda dengan pengaturan berikut:
   - **Nama Aplikasi**: Pilih nama untuk bot Anda
   - **Description**: Tambahkan deskripsi fungsionalitas bot Anda
   - URL Avatar**: Menambahkan URL untuk gambar avatar bot Anda
   - **Fitur**:
     - Mengaktifkan fitur interaktif
     - Mengaktifkan penerimaan 1-1 pesan
     - Mengaktifkan ruang bergabung dan percakapan grup
   - URL Titik Akhir HTTP**: Atur ini ke URLwebhook  Botpress  Anda yang ditemukan di Konfigurasi Integrasi Google Chat .

### 4. Konfigurasi Integrasi di Botpress

1. Di instans Botpress Anda, buka bagian Integrasi
2. Temukan dan pilih integrasi Google Chat 
3. Konfigurasikan pengaturan berikut ini:
   - JSON Akun Layanan**: Rekatkan seluruh isi file kunci akun layanan yang telah diunduh
   - **Ruang Default**: Masukkan ID ruang default Google Chat Anda (opsional)

### 5. Tambahkan Bot ke Ruang Chat Google Anda

1. Buka ruang Chat Google Anda
2. Klik nama ruang untuk membuka detail ruang
3. Buka "Aplikasi & integrasi"
4. Klik "Tambahkan aplikasi"
5. Cari bot Anda menggunakan email akun layanan
6. Tambahkan bot ke ruang Anda

## Penggunaan

### Mengirim Pesan

Bot dapat mengirim pesan ke ruang Google Chat mana pun yang telah ditambahkan. Pesan dapat dikirim:
- Menanggapi pesan pengguna
- Secara proaktif melalui editor alur Botpress 
- Melalui panggilan API dari kode kustom Anda

### Menerima Pesan

Bot secara otomatis menerima dan memproses pesan yang dikirim di ruang Google Chat . Ini akan dilakukan:
- Mengurai pesan yang masuk
- Memprosesnya melalui alur Botpress Anda
- Mengirim tanggapan yang sesuai kembali ke ruang tersebut

### Format Pesan

Integrasi ini mendukung pesan teks di ruang Google Chat . Pesan dapat mencakup:
- Teks biasa
- Pemformatan dasar
- Tautan
- Sebutan

## Pertimbangan Keamanan

- Jaga keamanan kunci akun layanan Anda dan jangan pernah membagikannya secara publik
- Putar kunci akun layanan Anda secara teratur
- Gunakan prinsip hak istimewa paling sedikit saat menetapkan peran ke akun layanan Anda
- Pantau aktivitas bot Anda dan siapkan pencatatan yang sesuai

## Pemecahan masalah

### Masalah Umum

1. Bot tidak merespons **Bot tidak merespons**
   - Verifikasi akun layanan memiliki izin yang benar
   - Periksa apakah bot telah ditambahkan dengan benar ke ruang tersebut
   - Pastikan integrasi dikonfigurasi dengan benar di Botpress

2. Kesalahan autentikasi ** **Kesalahan autentikasi**
   - Verifikasi JSON akun layanan diformat dengan benar
   - Periksa apakah kunci akun layanan valid dan tidak kedaluwarsa
   - Pastikan akun layanan telah mengaktifkan cakupan API yang diperlukan

3. Masalah pengiriman pesan **Masalah pengiriman pesan**
   - Verifikasi ID ruang sudah benar
   - Periksa apakah bot memiliki izin untuk mengirim di ruang tersebut
   - Pastikan format pesan sudah valid

## Referensi API

Untuk detail lebih lanjut tentang API Google Chat , lihat [dokumentasi resmi] (https://developers.google.com/chat/api/reference/rest).