Spazi Chat di Google

  # Integrazione della Chat di Google per Botpress

Questa integrazione consente di collegare il vostro chatbot Botpress con gli spazi di Google Chat , consentendo una comunicazione continua tra il vostro bot e gli utenti di Google Chat .

## Caratteristiche

- Invio e ricezione di messaggi negli spazi Google Chat 
- Gestione automatica dei messaggi e delle risposte
- Supporto per più spazi Google Chat 
- Autenticazione sicura tramite l'account di servizio Google

## Prerequisiti

1. Un account Google Cloud Platform (GCP)
2. Uno spazio Google Chat in cui si desidera distribuire il bot.
3. Un'istanza di Botpress con l'integrazione di Google Chat installata

## Istruzioni per l'installazione

### 1. Abilitare l'API di Google Chat 

1. Accedere a [Google Cloud Console] (https://console.cloud.google.com).
2. Andare su "API e servizi" > "Libreria".
3. Cercare "Google Chat API".
4. Fare clic sull'API di Google Chat 
5. Fare clic su "Abilita" per attivare l'API per il progetto.

### 2. Creare un account di servizio Google

1. Accedere a [Google Cloud Console] (https://console.cloud.google.com).
2. Creare un nuovo progetto o selezionarne uno esistente
3. Andare su "IAM e amministrazione" > "Account di servizio".
4. Fare clic su "Crea account di servizio".
5. Compilare i dettagli dell'account di servizio e fare clic su "Crea".
6. Creare una nuova chiave per l'account di servizio:
   - Fare clic sull'account di servizio
   - Andare alla scheda "Chiavi".
   - Fare clic su "Aggiungi chiave" > "Crea nuova chiave".
   - Scegliere il formato JSON
   - Scaricare il file della chiave

### 3. Configurare le impostazioni dell'app Google Chat 

1. Accedere a [Google Cloud Console] (https://console.cloud.google.com).
2. Andare su "API e servizi" > "Google Chat API".
3. Cliccare su "Configurazione".
4. Configurate la vostra applicazione con le seguenti impostazioni:
   - **Nome app**: Scegliere un nome per il bot
   - **Descrizione**: Aggiungere una descrizione della funzionalità del bot
   - URL avatar**: Aggiungere un URL per l'immagine dell'avatar del bot.
   - **Caratteristiche**:
     - Abilita le funzioni interattive
     - Abilita la ricezione di messaggi 1-1
     - Abilita la partecipazione a spazi e conversazioni di gruppo
   - URL dell'endpoint HTTP**: Impostare l'URL delwebhook di Botpress  trovato nella configurazione dell'integrazione di Google Chat .

### 4. Configurare l'integrazione in Botpress

1. Nella vostra istanza di Botpress , andate nella sezione Integrazioni.
2. Trovare e selezionare l'integrazione Google Chat 
3. Configurare le seguenti impostazioni:
   - **Conto di servizio JSON**: Incollare l'intero contenuto del file chiave dell'account di servizio scaricato.
   - **Spazio predefinito**: Inserire l'ID dello spazio Google Chat predefinito (facoltativo).

### 5. Aggiungere il bot allo spazio Google Chat 

1. Aprite il vostro spazio Google Chat 
2. Fare clic sul nome dello spazio per aprire i dettagli dello spazio
3. Andare su "Applicazioni e integrazioni".
4. Fare clic su "Aggiungi app".
5. Cercate il vostro bot utilizzando l'e-mail dell'account del servizio
6. Aggiungete il bot al vostro spazio

## Utilizzo

### Invio di messaggi

Il bot può inviare messaggi a qualsiasi spazio Google Chat a cui è stato aggiunto. I messaggi possono essere inviati:
- In risposta ai messaggi degli utenti
- In modo proattivo attraverso l'editor di flusso di Botpress 
- Tramite chiamate API dal vostro codice personalizzato

### Ricevere messaggi

Il bot riceve ed elabora automaticamente i messaggi inviati nello spazio Google Chat . Esso
- Analizza i messaggi in arrivo
- Li elabora attraverso i flussi di Botpress 
- Invia le risposte appropriate allo spazio

### Formato del messaggio

L'integrazione supporta i messaggi di testo negli spazi Google Chat . I messaggi possono includere:
- Testo normale
- Formattazione di base
- Collegamenti
- Menzioni

## Considerazioni sulla sicurezza

- Mantenere la chiave dell'account di servizio al sicuro e non condividerla mai pubblicamente.
- Ruotare regolarmente le chiavi dell'account di servizio
- Utilizzare il principio del minimo privilegio quando si assegnano ruoli all'account di servizio.
- Monitorare l'attività del bot e impostare una registrazione appropriata.

## Risoluzione dei problemi

### Problemi comuni

1. **Il bot non risponde**
   - Verificare che l'account del servizio abbia le autorizzazioni corrette.
   - Verificare se il bot è stato aggiunto correttamente allo spazio
   - Assicurarsi che l'integrazione sia configurata correttamente in Botpress

2. **Errori di autenticazione**
   - Verificare che il JSON dell'account di servizio sia formattato correttamente
   - Verificare che la chiave dell'account di servizio sia valida e non scaduta
   - Assicurarsi che l'account di servizio abbia gli ambiti API necessari abilitati

3. **Problemi di consegna dei messaggi**
   - Verificare che l'ID dello spazio sia corretto
   - Verificare se il bot ha l'autorizzazione a pubblicare nello spazio
   - Assicurarsi che il formato del messaggio sia valido

## Riferimento API

Per maggiori dettagli sull'API di Google Chat , consultare la [documentazione ufficiale](https://developers.google.com/chat/api/reference/rest).