Google Chat Spaces

  # Intégration de Google Chat pour Botpress

Cette intégration vous permet de connecter votre chatbot Botpress avec les espaces Google Chat , permettant une communication transparente entre votre bot et les utilisateurs de Google Chat 

## Caractéristiques

- Envoyer et recevoir des messages dans les espaces Google Chat 
- Gestion automatique des messages et des réponses
- Prise en charge de plusieurs espaces Google Chat 
- Authentification sécurisée à l'aide du compte de service Google

## Conditions préalables

1. Un compte Google Cloud Platform (GCP)
2. Un espace Google Chat dans lequel vous souhaitez déployer votre robot.
3. Une instance de Botpress avec l'intégration Google Chat installée

## Instructions d'installation

### 1. Activer l'API Google Chat 

1. Allez sur [Google Cloud Console] (https://console.cloud.google.com)
2. Naviguez vers "APIs & Services" > "Library"
3. Recherchez "Google Chat API"
4. Cliquez sur l'API Google Chat 
5. Cliquez sur "Enable" pour activer l'API pour votre projet.

### 2. Créez un compte de service Google

1. Allez sur [Google Cloud Console] (https://console.cloud.google.com)
2. Créez un nouveau projet ou sélectionnez un projet existant
3. Naviguez vers "IAM & Admin" > "Service Accounts"
4. Cliquez sur "Créer un compte de service"
5. Remplissez les détails du compte de service et cliquez sur "Créer"
6. Créez une nouvelle clé pour le compte de service :
   - Cliquez sur le compte de service
   - Allez dans l'onglet "Clés
   - Cliquez sur "Ajouter une clé" > "Créer une nouvelle clé".
   - Choisissez le format JSON
   - Télécharger le fichier de clé

### 3. Configurer les paramètres de l'application Google Chat 

1. Allez sur [Google Cloud Console] (https://console.cloud.google.com)
2. Naviguez vers "APIs & Services" > "Google Chat API"
3. Cliquez sur "Configuration"
4. Configurez votre application avec les paramètres suivants :
   - **Nom de l'application** : Choisissez un nom pour votre bot
   - Description** : Ajoutez une description de la fonctionnalité de votre robot
   - URL de l'avatar** : Ajoutez une URL pour l'image de l'avatar de votre robot.
   - Fonctionnalités** :
     - Activer les fonctions interactives
     - Permettre la réception de messages 1-1
     - Permettre de rejoindre des espaces et des conversations de groupe
   - URL du point de terminaison HTTP** : Définissez ceci comme l'URL de votrewebhook  Botpress  qui se trouve dans la configuration de l'intégration de Google Chat .

### 4. Configurer l'intégration dans Botpress

1. Dans votre instance de Botpress , allez dans la section Intégrations
2. Trouvez et sélectionnez l'intégration Google Chat 
3. Configurez les paramètres suivants :
   - **Compte de service JSON** : Collez le contenu complet du fichier clé du compte de service que vous avez téléchargé.
   - Espace par défaut** : Saisissez l'ID de votre espace Google Chat par défaut (facultatif).

### 5. Ajoutez le robot à votre espace Google Chat 

1. Ouvrez votre espace Google Chat 
2. Cliquez sur le nom de l'espace pour ouvrir les détails de l'espace
3. Allez dans "Apps & intégrations"
4. Cliquez sur "Ajouter des applications"
5. Recherchez votre robot à l'aide de l'adresse électronique du compte de service
6. Ajoutez le robot à votre espace

## Utilisation

### Envoi de messages

Le robot peut envoyer des messages à tout espace Google Chat auquel il a été ajouté. Les messages peuvent être envoyés :
- En réponse à des messages d'utilisateurs
- De manière proactive via l'éditeur de flux Botpress 
- Via des appels API depuis votre code personnalisé

### Réception de messages

Le bot reçoit et traite automatiquement les messages envoyés dans l'espace Google Chat . Il va :
- Analyser les messages entrants
- Les traiter à travers vos flux Botpress 
- Envoyer les réponses appropriées à l'espace

### Format du message

L'intégration supporte les messages texte dans les espaces Google Chat . Les messages peuvent inclure
- du texte brut
- Formatage de base
- des liens
- des mentions

## Considérations de sécurité

- Conservez votre clé de compte de service en toute sécurité et ne la partagez jamais publiquement.
- Effectuez une rotation régulière des clés de votre compte de service
- Utilisez le principe du moindre privilège lorsque vous attribuez des rôles à votre compte de service.
- Surveillez l'activité de votre robot et mettez en place un système de journalisation approprié.

## Dépannage

### Problèmes courants

1. **Le robot ne répond pas**
   - Vérifier que le compte de service dispose des autorisations correctes.
   - Vérifier que le bot est correctement ajouté à l'espace
   - Vérifier que l'intégration est correctement configurée dans Botpress

2. **Erreurs d'authentification
   - Vérifier que le JSON du compte de service est correctement formaté
   - Vérifier que la clé du compte de service est valide et n'a pas expiré
   - S'assurer que le compte de service dispose des champs d'application API nécessaires.

3. **Problèmes de livraison de messages
   - Vérifier que l'identifiant de l'espace est correct
   - Vérifier que le bot a l'autorisation de poster dans l'espace.
   - Vérifier que le format du message est valide

## Référence API

Pour plus de détails sur l'API Google Chat , consultez la [documentation officielle] (https://developers.google.com/chat/api/reference/rest).