Google Chat Spaces

  # Integracja Google Chat dla Botpress

Ta integracja pozwala połączyć chatbota Botpress z przestrzeniami Google Chat , umożliwiając płynną komunikację między botem a użytkownikami Google Chat .

## Cechy

- Wysyłanie i odbieranie wiadomości w przestrzeniach Google Chat 
- Automatyczna obsługa wiadomości i odpowiedzi
- Obsługa wielu przestrzeni Google Chat 
- Bezpieczne uwierzytelnianie przy użyciu konta usługi Google

## Wymagania wstępne

1. Konto Google Cloud Platform (GCP)
2. Przestrzeń Google Chat , w której chcesz wdrożyć swojego bota
3. Instancja Botpress z zainstalowaną integracją Google Chat 

## Instrukcje konfiguracji

### 1. Włącz Google Chat API

1. Przejdź do [Google Cloud Console] (https://console.cloud.google.com).
2. Przejdź do "API i usługi" > "Biblioteka"
3. Wyszukaj "Google Chat API"
4. Kliknij Google Chat API
5. Kliknij "Enable", aby aktywować API dla swojego projektu.

### 2. Utwórz konto usługi Google

1. Przejdź do [Google Cloud Console] (https://console.cloud.google.com).
2. Utwórz nowy projekt lub wybierz istniejący
3. Przejdź do "IAM & Admin" > "Konta usług"
4. Kliknij "Utwórz konto usługi"
5. Wypełnij dane konta usługi i kliknij "Utwórz".
6. Utwórz nowy klucz dla konta usługi:
   - Kliknij konto usługi
   - Przejdź do zakładki "Klucze"
   - Kliknij "Dodaj klucz" > "Utwórz nowy klucz".
   - Wybierz format JSON
   - Pobierz plik klucza

### 3. Skonfiguruj ustawienia aplikacji Google Chat 

1. Przejdź do [Google Cloud Console] (https://console.cloud.google.com).
2. Przejdź do "APIs & Services" > "Google Chat API".
3. Kliknij "Konfiguracja"
4. Skonfiguruj swoją aplikację z następującymi ustawieniami:
   - **App Name**: Wybierz nazwę dla swojego bota
   - Opis**: Dodaj opis funkcjonalności swojego bota
   - Adres URL awatara**: Dodaj adres URL dla obrazu awatara twojego bota
   - Funkcje**:
     - Włącz funkcje interaktywne
     - Włącz odbieranie wiadomości 1-1
     - Włączanie dołączania do przestrzeni i konwersacji grupowych
   - Adres URL punktu końcowego HTTP**: Ustaw to na adres URLwebhook  Botpress  znajdujący się w konfiguracji integracji Google Chat .

### 4. Skonfiguruj integrację w Botpress

1. W swojej instancji Botpress przejdź do sekcji Integracje
2. Znajdź i wybierz integrację Google Chat 
3. Skonfiguruj następujące ustawienia:
   - **Konto usługi JSON**: Wklej całą zawartość pobranego pliku klucza konta usługi
   - **Default Space**: Wprowadź identyfikator domyślnej przestrzeni Google Chat (opcjonalnie)

### 5. Dodaj bota do swojej przestrzeni Google Chat 

1. Otwórz swoją przestrzeń Google Chat 
2. Kliknij nazwę przestrzeni, aby otworzyć jej szczegóły
3. Przejdź do "Aplikacje i integracje"
4. Kliknij "Dodaj aplikacje"
5. Wyszukaj swojego bota za pomocą adresu e-mail konta usługi
6. Dodaj bota do swojej przestrzeni

## Użycie

### Wysyłanie wiadomości

Bot może wysyłać wiadomości do dowolnej przestrzeni Google Chat , do której został dodany. Wiadomości mogą być wysyłane:
- W odpowiedzi na wiadomości użytkownika
- Proaktywnie poprzez edytor przepływu Botpress 
- Poprzez wywołania API z niestandardowego kodu

### Odbieranie wiadomości

Bot automatycznie odbiera i przetwarza wiadomości wysyłane w przestrzeni Google Chat . Będzie on
- analizuje przychodzące wiadomości
- Przetworzy je przez przepływy Botpress 
- Wysyła odpowiednie odpowiedzi z powrotem do przestrzeni

### Format wiadomości

Integracja obsługuje wiadomości tekstowe w przestrzeniach Google Chat . Wiadomości mogą zawierać:
- Zwykły tekst
- Podstawowe formatowanie
- Łącza
- Wzmianki

## Względy bezpieczeństwa

- Klucz konta usługi należy przechowywać w bezpiecznym miejscu i nigdy nie udostępniać go publicznie.
- Regularnie zmieniaj klucze konta usługi.
- Podczas przypisywania ról do konta usługi należy stosować zasadę najmniejszych uprawnień.
- Monitoruj aktywność bota i skonfiguruj odpowiednie rejestrowanie.

## Rozwiązywanie problemów

### Najczęstsze problemy

1. **Bot nie odpowiada**
   - Sprawdź, czy konto usługi ma prawidłowe uprawnienia.
   - Sprawdź, czy bot został prawidłowo dodany do przestrzeni.
   - Upewnij się, że integracja jest poprawnie skonfigurowana w Botpress
. Botpress

2. **Błędy uwierzytelniania**
   - Sprawdź, czy JSON konta usługi jest poprawnie sformatowany.
   - Sprawdź, czy klucz konta usługi jest ważny i nie wygasł.
   - Upewnij się, że konto usługi ma włączone niezbędne zakresy API.

3. **Problemy z dostarczaniem wiadomości**
   - Sprawdź, czy identyfikator przestrzeni jest prawidłowy
   - Sprawdź, czy bot ma uprawnienia do publikowania w przestrzeni.
   - Upewnij się, że format wiadomości jest prawidłowy

## API Reference

Więcej informacji na temat interfejsu API Google Chat można znaleźć w [oficjalnej dokumentacji] (https://developers.google.com/chat/api/reference/rest).