Google Chat

  # Google Chat voor Botpress

Met deze integratie kun je je Botpress chatbot verbinden met Google Chat , waardoor naadloze communicatie tussen je bot en Google Chat mogelijk is.

## Kenmerken

- Berichten verzenden en ontvangen in Google Chat 
- Automatische berichtenafhandeling en antwoorden
- Ondersteuning voor meerdere Google Chat 
- Veilige verificatie met behulp van Google Service Account

## Vereisten

1. Een Google Cloud Platform (GCP)-account
2. Een Google Chat waar u uw bot wilt inzetten
3. Botpress met de Google Chat geïnstalleerd

## Setup-instructies

### 1. Google Chat API inschakelen

1. Ga naar de [Google Cloud Console] (https://console.cloud.google.com)
2. Navigeer naar "API's & Services" > "Bibliotheek".
3. Zoek naar "Google Chat API".
4. Klik op de Google Chat API
5. Klik op "Inschakelen" om de API voor uw project te activeren

### 2. Maak een Google Service-account

1. Ga naar de [Google Cloud Console] (https://console.cloud.google.com)
2. Maak een nieuw project of selecteer een bestaand project
3. Navigeer naar "IAM & Admin" > "Service Accounts".
4. Klik op "Serviceaccount aanmaken".
5. Vul de gegevens van de serviceaccount in en klik op "Aanmaken".
6. Maak een nieuwe sleutel voor de serviceaccount:
   - Klik op de serviceaccount
   - Ga naar het tabblad "Sleutels
   - Klik op "Sleutel toevoegen" > "Nieuwe sleutel maken".
   - Kies JSON-indeling
   - Download het sleutelbestand

### 3. Instellingen Google Chat configureren

1. Ga naar de [Google Cloud Console] (https://console.cloud.google.com)
2. Navigeer naar "API's & Services" > "Google Chat API".
3. Klik op "Configuratie".
4. Stel je app in met de volgende instellingen:
   - **App Naam**: Kies een naam voor je bot
   - **Beschrijving**: Voeg een beschrijving toe van de functionaliteit van je bot
   - **Avatar URL**: Voeg een URL toe voor de avatarafbeelding van uw bot
   - **Features**:
     - Schakel interactieve functies in
     - 1-1 berichten ontvangen inschakelen
     - Aansluiten bij ruimtes en groepsgesprekken inschakelen
   - **HTTP Endpoint URL**: Stel dit in op de Botpress webhook URL die je kunt vinden in de Google Chat Integration Configuration.

### 4. Configureer de integratie in Botpress

1. Ga in je Botpress naar de sectie Integraties
2. Zoek en selecteer de Google Chat integratie
3. Configureer de volgende instellingen:
   - **Service Account JSON**: Plak de volledige inhoud van uw gedownloade serviceaccountsleutelbestand
   - **Default Space**: Voer de ID van uw standaard Google Chat in (optioneel)

### 5. De Bot toevoegen aan uw Google Chat 

1. Open uw Google Chat 
2. Klik op de naam van de ruimte om de details van de ruimte te openen
3. Ga naar "Apps & integraties".
4. Klik op "Apps toevoegen".
5. Zoek naar uw bot met behulp van de e-mail van het serviceaccount
6. Voeg de bot toe aan uw ruimte

## Gebruik

### Berichten verzenden

De bot kan berichten sturen naar elke Google Chat waaraan hij is toegevoegd. Berichten kunnen worden verzonden:
- Als reactie op gebruikersberichten
- Proactief via de Botpress flow editor
- Via API-oproepen vanuit uw aangepaste code

### Berichten ontvangen

De bot ontvangt en verwerkt automatisch berichten die zijn verzonden in de Google Chat . Het zal:
- Inkomende berichten parseren
- Ze verwerken via uw Botpress 
- De juiste antwoorden terugsturen naar de ruimte

### Berichtformaat

De integratie ondersteunt tekstberichten in Google Chat . Berichten kunnen bevatten:
- Platte tekst
- Basisopmaak
- Koppelingen
- Vermeldingen

## Beveiligingsoverwegingen

- Bewaar uw serviceaccountsleutel veilig en deel deze nooit publiekelijk
- Draai uw serviceaccountsleutels regelmatig
- Gebruik het principe van de minste privileges bij het toewijzen van rollen aan uw service account
- Monitor de activiteit van uw bot en stel de juiste logging in

## Problemen oplossen

### Veelvoorkomende problemen

1. **Bot reageert niet**
   - Controleer of de serviceaccount de juiste rechten heeft
   - Controleer of de bot correct is toegevoegd aan de ruimte
   - Controleer of de integratie correct is geconfigureerd in Botpress

2. **Verificatie fouten**
   - Controleer of de serviceaccount JSON correct is geformatteerd
   - Controleer of de sleutel van de serviceaccount geldig is en niet is verlopen
   - Controleer of de serviceaccount de benodigde API-scopes heeft ingeschakeld

3. **Problemen met de berichtaflevering**
   - Controleer of het ruimte-ID correct is
   - Controleer of de bot toestemming heeft om in de ruimte te posten
   - Controleer of het berichtformaat geldig is

## API referentie

Raadpleeg de [officiële documentatie](https://developers.google.com/chat/api/reference/rest) voor meer informatie over de Google Chat API.