Google Chat Alanları

  # Botpress
için Google Chat Entegrasyonu Botpress

Bu entegrasyon, Botpress sohbet botunuzu Google Chat alanlarına bağlamanıza olanak tanıyarak botunuz ve Google Chat kullanıcıları arasında sorunsuz iletişim sağlar.

## Özellikler

- Google Chat alanlarında mesaj gönderme ve alma
- Otomatik mesaj işleme ve yanıtlar
- Birden fazla Google Chat alanı için destek
- Google Hizmet Hesabı kullanarak güvenli kimlik doğrulama

## Önkoşullar

1. Bir Google Cloud Platform (GCP) hesabı
2. Botunuzu dağıtmak istediğiniz bir Google Chat alanı
3. Google Chat entegrasyonu yüklü Botpress örneği

## Kurulum Talimatları

### 1. Google Chat API'sini etkinleştirin

1. Google Cloud Console]'a gidin (https://console.cloud.google.com)
2. "API'ler ve Hizmetler" > "Kütüphane" bölümüne gidin
3. "Google Chat API" için arama yapın
4. Google Chat API'sine tıklayın
5. Projeniz için API'yi etkinleştirmek için "Etkinleştir "e tıklayın

### 2. Bir Google Hizmet Hesabı Oluşturun

1. Google Cloud Console]'a gidin (https://console.cloud.google.com)
2. Yeni bir proje oluşturun veya mevcut bir projeyi seçin
3. "IAM & Admin" > "Hizmet Hesapları" bölümüne gidin
4. "Hizmet Hesabı Oluştur "a tıklayın
5. Hizmet hesabı ayrıntılarını doldurun ve "Oluştur "a tıklayın
6. Hizmet hesabı için yeni bir anahtar oluşturun:
   - Hizmet hesabına tıklayın
   - "Anahtarlar" sekmesine gidin
   - "Anahtar Ekle" > "Yeni anahtar oluştur "a tıklayın
   - JSON biçimini seçin
   - Anahtar dosyasını indirin

### 3. Google Chat Uygulaması Ayarlarını Yapılandırma

1. Google Cloud Console]'a gidin (https://console.cloud.google.com)
2. "API'ler ve Hizmetler" > "Google Chat API'si "ne gidin
3. "Yapılandırma" üzerine tıklayın
4. Uygulamanızı aşağıdaki ayarlarla kurun:
   - **Uygulama Adı**: Botunuz için bir ad seçin
   - **Açıklama**: Botunuzun işlevselliği hakkında bir açıklama ekleyin
   - **Avatar URL**: Botunuzun avatar resmi için bir URL ekleyin
   - Özellikler**:
     - Etkileşimli özellikleri etkinleştirin
     - 1-1 mesajları almayı etkinleştirin
     - Alanlara ve grup konuşmalarına katılmayı etkinleştirin
   - **HTTP Bitiş Noktası URL'si**: Bunu, Google Chat Entegrasyonu Yapılandırması'nda bulunan Botpress webhook URL'nize ayarlayın.

### 4. Botpress
'te Entegrasyonu Yapılandırma Botpress

1. Botpress örneğinizde, Entegrasyonlar bölümüne gidin
2. Google Chat entegrasyonunu bulun ve seçin
3. Aşağıdaki ayarları yapılandırın:
   - **Hizmet Hesabı JSON**: İndirdiğiniz hizmet hesabı anahtar dosyasının tüm içeriğini yapıştırın
   - **Varsayılan Alan**: Varsayılan Google Chat alanınızın kimliğini girin (isteğe bağlı)

### 5. Botu Google Chat Alanınıza Ekleme

1. Google Chat alanınızı açın
2. Alan ayrıntılarını açmak için alan adına tıklayın
3. "Uygulamalar ve entegrasyonlar "a gidin
4. "Uygulama ekle "ye tıklayın
5. Hizmet hesabı e-postasını kullanarak botunuzu arayın
6. Botu alanınıza ekleyin

## Kullanım

### Mesaj Gönderme

Bot, eklendiği herhangi bir Google Chat alanına mesaj gönderebilir. Mesajlar gönderilebilir:

- Kullanıcı mesajlarına yanıt olarak
- Botpress akış editörü aracılığıyla proaktif olarak
- Özel kodunuzdan API çağrıları aracılığıyla

### Mesaj Alma

Bot, Google Chat alanında gönderilen mesajları otomatik olarak alır ve işler. Olacak:

- Gelen mesajları ayrıştırma
- Botpress akışlarınız aracılığıyla işleyin
- Uygun yanıtları alana geri gönderin

### Mesaj Formatı

Entegrasyon, Google Chat alanlarındaki metin mesajlarını destekler. Mesajlar şunları içerebilir:

- Düz metin
- Temel biçimlendirme
- Bağlantılar
- Mansiyonlar

## Güvenlik Hususları

- Hizmet hesabı anahtarınızı güvende tutun ve asla herkese açık olarak paylaşmayın
- Hizmet hesabı anahtarlarınızı düzenli olarak döndürün
- Hizmet hesabınıza roller atarken en az ayrıcalık ilkesini kullanın
- Botunuzun etkinliğini izleyin ve uygun günlük kaydı ayarlayın

## Sorun Giderme

### Yaygın Sorunlar

1. **Bot yanıt vermiyor**
   - Hizmet hesabının doğru izinlere sahip olduğunu doğrulayın
   - Botun alana düzgün bir şekilde eklenip eklenmediğini kontrol edin
   - Entegrasyonun Botpress
'te doğru şekilde yapılandırıldığından emin olun Botpress

2. **Kimlik doğrulama hataları**
   - Hizmet hesabı JSON'unun doğru biçimlendirildiğini doğrulayın
   - Hizmet hesabı anahtarının geçerli olup olmadığını ve süresinin dolup dolmadığını kontrol edin
   - Hizmet hesabının gerekli API kapsamlarını etkinleştirdiğinden emin olun

3. **Mesaj teslim sorunları**
   - Alan kimliğinin doğru olduğunu doğrulayın
   - Botun alanda gönderi yapma iznine sahip olup olmadığını kontrol edin
   - Mesaj formatının geçerli olduğundan emin olun

## API Referansı

Google Chat API'si hakkında daha fazla bilgi için [resmi belgelere] (https://developers.google.com/chat/api/reference/rest) bakın.