Creare un'app Google Chat con Google Apps Script

Crea un'app Google Chat a cui puoi inviare messaggi direttamente e che risponda con un'eco ai tuoi messaggi.

Il seguente diagramma mostra l'architettura e il pattern di messaggistica:

Nel diagramma precedente, un utente che interagisce con un'app di chat di Apps Script ha il seguente flusso di informazioni:

1. Un utente invia un messaggio a un'app di Chat, in un messaggio diretto o in uno spazio di Chat.
2. La logica dell'app Chat implementata in Apps Script e presente in Google Cloud riceve ed elabora il messaggio.
3. Facoltativamente, la logica dell'app Chat può integrarsi con i servizi Google Workspace, come Calendar o Fogli, oppure con altri servizi Google, come Google Maps o YouTube.
4. La logica dell'app Chat invia una risposta al servizio dell'app Chat in Chat.
5. La risposta viene recapitata all'utente.

Obiettivi

• Configurare l'ambiente.
• Configura lo script.
• Pubblicare l'app Chat.
• Testa l'app Chat.

Prerequisiti

• Un account Google Workspace con accesso a Chat.
• Un progetto Google Cloud.

configura l'ambiente

Apri il progetto Cloud nella console Google Cloud

Se non è già aperto, apri il progetto Cloud che intendi utilizzare per questo esempio:

1. Nella console Google Cloud, vai alla pagina Seleziona un progetto.

   Seleziona un progetto Cloud

2. Seleziona il progetto Google Cloud che vuoi utilizzare. In alternativa, fai clic su Crea progetto e segui le istruzioni sullo schermo. Se crei un progetto Google Cloud, potresti dover attivare la fatturazione per il progetto.

Attivare l'API Chat

Prima di utilizzare le API di Google, devi attivarle in un progetto Google Cloud. Puoi attivare una o più API in un singolo progetto Google Cloud.

• Nella console Google Cloud, abilita l'API Google Chat.

  Abilita l'API

Configurare la schermata per il consenso OAuth

Per tutte le app che utilizzano OAuth 2.0 è necessaria una configurazione della schermata per il consenso. La configurazione della schermata per il consenso OAuth dell'app definisce cosa viene mostrato agli utenti e ai revisori dell'app e registra la tua app per poterla pubblicare in un secondo momento.

1. Nella console Google Cloud, vai a Menu > API e servizi > Schermata consenso OAuth.

   Vai alla schermata per il consenso OAuth

2. In Tipo di utente, seleziona Interno e poi fai clic su Crea.
3. Compila il modulo di registrazione dell'app, poi fai clic su Salva e continua.

4. Per il momento, puoi saltare l'aggiunta di ambiti e fare clic su Salva e continua. In futuro, quando creerai un'app da utilizzare al di fuori della tua organizzazione Google Workspace, dovrai cambiare Tipo di utente in Esterno e poi aggiungere gli ambiti di autorizzazione richiesti dalla tua app.

5. Rivedi il riepilogo della registrazione dell'app. Per apportare modifiche, fai clic su Modifica. Se la registrazione dell'app è corretta, fai clic su Torna alla dashboard.

Configura lo script

Per configurare lo script, utilizza un modello e imposta il progetto Cloud in Apps Script.

Crea lo script dal modello

1. Vai alla pagina Guida introduttiva di Apps Script.
2. Fai clic sul modello App Chat. Potresti dover scorrere verso il basso per vedere il modello.
3. Fai clic su Progetto senza titolo, digita Quickstart app e fai clic su Rinomina.

Copia il numero di progetto Cloud

1. Nella console Google Cloud, vai a Menu > IAM e amministrazione > Impostazioni.

   Vai a Impostazioni IAM e amministrazione

2. Nel campo Numero progetto, copia il valore.

Imposta il progetto Cloud del progetto Apps Script

1. Nel progetto Apps Script dell'app Chat, fai clic su Impostazioni progetto .
2. In Progetto Google Cloud Platform (GCP), fai clic su Cambia progetto.
3. In Numero di progetto Google Cloud, incolla il numero di progetto Google Cloud.
4. Fai clic su Imposta progetto.

Ora hai a disposizione un codice dell'app funzionante che puoi provare (come descritto nei passaggi seguenti) e personalizzarlo in base ai tuoi requisiti.

Assicurati di aver eseguito l'accesso all'Account Google corretto quando apri il modello di Apps Script. L'account corrente a volte può passare al tuo account predefinito senza che tu te ne accorga.

Crea un deployment di test

Occorre un ID deployment per questo progetto Apps Script, in modo da poterlo utilizzare nel passaggio successivo.

Per ottenere l'ID deployment head:

1. Nel progetto Apps Script dell'app Chat, fai clic su Esegui il deployment > Testa deployment.
2. Copia l'ID deployment Head da utilizzare in un passaggio successivo e fai clic su Fine.

Pubblicare l'app Chat

Pubblicare l'app Chat dalla console Google Cloud.

1. Nella console Google Cloud, cerca Google Chat API e fai clic su API Google Chat.
2. Fai clic su Gestisci.

3. Fai clic su Configurazione e configura l'app Chat:

   1. Nel campo Nome app, inserisci Quickstart app.
   2. Nel campo URL avatar, inserisci https://developers.google.com/chat/images/quickstart-app-avatar.png.
   3. Nel campo Descrizione, inserisci Quickstart app.
   4. In Funzionalità, seleziona Ricevi messaggi 1:1 e Partecipa a spazi e conversazioni di gruppo.
   5. In Impostazioni di connessione, seleziona Progetto Apps Script.
   6. Nel campo ID deployment, incolla l'ID deployment Head che hai copiato in precedenza.
   7. In Visibilità, seleziona Persone e gruppi specifici nel tuo dominio e inserisci il tuo indirizzo email.

4. Fai clic su Salva.

L'app Chat è pronta per rispondere ai messaggi.

Testare l'app Chat

Per testare la tua app Chat, apri uno spazio per i messaggi diretti con l'app Chat e invia un messaggio:

1. Apri Google Chat utilizzando l'account Google Workspace che hai fornito quando ti sei aggiunto come trusted tester.

   Vai a Google Chat

2. Fai clic su Nuova chat.
3. Nel campo Aggiungi una o più persone, digita il nome della tua app di Chat.

4. Seleziona l'app di chat dai risultati. Si apre un messaggio diretto.

   Nota: se non vedi la tua app Chat nell'elenco dei risultati, assicurati di aver incluso il tuo account Google Workspace nelle impostazioni di Visibilità della pagina Configurazione dell'API Chat nella console Google Cloud.

5. Nel nuovo messaggio diretto con l'app, digita Hello e premi enter.

   L'app Chat ti ringrazia per l'aggiunta e attiva l'eco del tuo messaggio.

Per aggiungere trusted tester e scoprire di più sui test delle funzionalità interattive, consulta Testare le funzionalità interattive per le app Google Chat.

Risolvi il problema

Quando un'app o una scheda Google Chat restituisce un errore, nell'interfaccia di Chat viene visualizzato il messaggio "Si è verificato un problema". o "Impossibile elaborare la richiesta". A volte nella UI di Chat non vengono visualizzati messaggi di errore, ma l'app o la scheda di Chat produce un risultato imprevisto; ad esempio, un messaggio di scheda potrebbe non essere visualizzato.

Anche se un messaggio di errore potrebbe non essere visualizzato nell'interfaccia utente di Chat, sono disponibili messaggi di errore descrittivi e dati di log per aiutarti a correggere gli errori quando il logging degli errori per le app di Chat è attivato. Per assistenza su visualizzazione, debug e correzione degli errori, consulta l'articolo Risolvere gli errori di Google Chat.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo tutorial, ti consigliamo di eliminare il progetto Cloud.

Attenzione:l'eliminazione di un progetto ha i seguenti effetti:

• L'intero contenuto del progetto viene eliminato. Se hai utilizzato un progetto esistente per questo tutorial, quando lo elimini, elimini anche qualsiasi altro lavoro svolto nel progetto.
• Gli ID progetto personalizzati non sono più disponibili. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un URL su appspot.com, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.

Se prevedi di esplorare più tutorial e guide rapide, puoi riutilizzare i progetti per evitare di superare i limiti di quota.

1. Nella console Google Cloud, vai alla pagina Gestisci risorse. Fai clic su Menu > IAM e amministrazione > Gestisci risorse.

   Vai a Resource Manager

2. Nell'elenco dei progetti, seleziona quello da eliminare e fai clic su Elimina .
3. Nella finestra di dialogo, digita l'ID progetto e fai clic su Arresta per eliminare il progetto.

Passaggi successivi

• Crea schede interattive: i messaggi delle schede supportano un layout definito, elementi interattivi dell'interfaccia utente come pulsanti e rich media come le immagini. Utilizza i messaggi delle schede per presentare informazioni dettagliate, raccogliere informazioni dagli utenti e guidarli a un passo successivo.
• Supporto dei comandi slash: i comandi slash ti consentono di registrare e pubblicizzare comandi specifici che gli utenti possono impartire nella tua app digitando un comando che inizia con una barra (/), ad esempio /help.
• Finestre di dialogo di avvio. Le finestre di dialogo sono interfacce a schede che l'app può aprire per interagire con un utente. È possibile unire più schede in sequenza, consentendo agli utenti di completare procedure in più passaggi, come la compilazione dei dati dei moduli.