# 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
- Bir Google Cloud Platform (GCP) hesabı
- Botunuzu dağıtmak istediğiniz bir Google Chat alanı
- Google Chat entegrasyonu yüklü Botpress örneği
Kurulum Talimatları
1. Google Chat API'sini etkinleştirin
- Google Cloud Console]'a gidin (https://console.cloud.google.com)
- "API'ler ve Hizmetler" > "Kütüphane" bölümüne gidin
- "Google Chat API" için arama yapın
- Google Chat API'sine tıklayın
- Projeniz için API'yi etkinleştirmek için "Etkinleştir "e tıklayın
2. Bir Google Hizmet Hesabı Oluşturun
- Google Cloud Console]'a gidin (https://console.cloud.google.com)
- Yeni bir proje oluşturun veya mevcut bir projeyi seçin
- "IAM & Admin" > "Hizmet Hesapları" bölümüne gidin
- "Hizmet Hesabı Oluştur "a tıklayın
- Hizmet hesabı ayrıntılarını doldurun ve "Oluştur "a tıklayın
- 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
- Google Cloud Console]'a gidin (https://console.cloud.google.com)
- "API'ler ve Hizmetler" > "Google Chat API'si "ne gidin
- "Yapılandırma" üzerine tıklayın
- 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
- Botpress örneğinizde, Entegrasyonlar bölümüne gidin
- Google Chat entegrasyonunu bulun ve seçin
- 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
- Google Chat alanınızı açın
- Alan ayrıntılarını açmak için alan adına tıklayın
- "Uygulamalar ve entegrasyonlar "a gidin
- "Uygulama ekle "ye tıklayın
- Hizmet hesabı e-postasını kullanarak botunuzu arayın
- 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. Bu 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
- 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
- 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
- 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 bakın.