Creare un'app Google Chat con Google Apps Script

Crea un'app Google Chat a cui puoi inviare messaggi direttamente e che risponde ripetendo i tuoi messaggi.

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

Nel diagramma precedente, un utente che interagisce con un'app Chat 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, che si trova in Google Cloud, riceve ed elabora il messaggio.
3. Se vuoi, la logica dell'app Chat può integrarsi con i servizi Google Workspace, come Calendar o Fogli, o 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 restituita all'utente.

Obiettivi

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

Prerequisiti

• Un account Google Workspace Business o Enterprise con accesso a Google Chat.
• Un progetto Google Cloud. Per crearne uno, consulta la pagina Creare 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

Configura la schermata per il consenso OAuth

Tutte le app che utilizzano OAuth 2.0 richiedono una configurazione della schermata per il consenso. La configurazione della schermata per il consenso OAuth della tua app definisce cosa viene visualizzato dagli utenti e dai revisori dell'app e registra la tua app in modo che tu possa pubblicarla in un secondo momento.

1. Nella console Google Cloud, vai a Menu > > Branding.

   Vai a Branding

2. Se hai già configurato , puoi configurare le seguenti impostazioni della schermata per il consenso OAuth in Branding, Pubblico e Accesso ai dati. Se viene visualizzato il messaggio non ancora configurata, fai clic su Inizia:
1. In Informazioni sull'app, nel campo Nome app, inserisci un nome per l'app.
2. In Email dell'assistenza utente, scegli un indirizzo email dell'assistenza a cui gli utenti possono contattarti in caso di domande sul loro consenso.
3. Fai clic su Avanti.
4. Nella sezione Pubblico, seleziona Interno.
5. Fai clic su Avanti.
6. In Informazioni di contatto, inserisci un indirizzo email a cui ricevere notifiche in caso di modifiche al tuo progetto.
7. Fai clic su Avanti.
8. In Fine, esamina le Norme relative ai dati utente dei servizi API di Google e, se le accetti, seleziona Accetto le Norme relative ai dati utente dei servizi API di Google.
9. Fai clic su Continua.
10. Fai clic su Crea.
3. Per ora puoi saltare l'aggiunta degli ambiti. In futuro, quando crei un'app da utilizzare al di fuori della tua organizzazione Google Workspace, devi modificare il Tipo di utente in Esterno. Poi aggiungi gli ambiti di autorizzazione richiesti dalla tua app. Per saperne di più, consulta la guida completa Configurare il consenso OAuth.

Configurare lo script

Per configurare lo script, utilizzi un modello e poi imposti il tuo 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 di chat nella parte superiore della pagina.
3. Fai clic su Progetto senza titolo, digita Quickstart app e fai clic su Rinomina.

Copia il numero del progetto cloud

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

   Vai a IAM e amministrazione > Impostazioni

2. Nel campo Numero di 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 (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 un codice dell'app funzionante che puoi provare (come descritto nei passaggi successivi) e poi personalizzare in base alle tue esigenze.

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

Creare un deployment di test

Per questo progetto Apps Script è necessario un ID deployment, 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 Deployment > Test dei deployment.
2. Copia l'ID deployment head da utilizzare in un passaggio successivo e fai clic su Fine.

Pubblicare l'app Chat

Pubblica l'app Chat dalla console.

1. Nella console, 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 Partecipa a spazi e conversazioni di gruppo.
   5. Nella sezione Impostazioni di connessione, seleziona Apps Script.
   6. Nel campo ID deployment, incolla l'ID deployment principale 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 a rispondere ai messaggi.

Testare l'app Chat

Per testare l'app Chat, apri uno spazio di 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 tester attendibile.

   Vai a Google Chat

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

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

   Nota:se non vedi la tua app di chat nell'elenco dei risultati, assicurati di aver incluso il tuo account Google Workspace nelle impostazioni di visibilità della pagina di 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 averla aggiunta e ripete il tuo messaggio.

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

Risoluzione dei problemi

Quando un'app Google Chat o una scheda restituisce un errore, l'interfaccia di Chat mostra il messaggio "Si è verificato un problema". o "Impossibile elaborare la tua richiesta". A volte l'interfaccia utente di Chat non mostra alcun messaggio di errore, ma l'app o la scheda Chat produce un risultato imprevisto; ad esempio, un messaggio della scheda potrebbe non essere visualizzato.

Anche se nell'interfaccia utente di Chat potrebbe non essere visualizzato un messaggio di errore, sono disponibili messaggi di errore descrittivi e dati di log per aiutarti a correggere gli errori quando la registrazione degli errori per le app di chat è attivata. Per assistenza nella visualizzazione, nel debug e nella correzione degli errori, consulta Risolvere e correggere 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 tutto il lavoro effettuato 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 del progetto, ad esempio un URL su appspot.com, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.

Se intendi esplorare più tutorial e guide rapide, il riuso dei progetti ti aiuta a non 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 che vuoi eliminare, quindi fai clic su Elimina .
3. Nella finestra di dialogo, digita l'ID progetto, quindi fai clic su Chiudi per eliminare il progetto.

Passaggi successivi

• Crea schede interattive: i messaggi delle schede supportano un layout definito, elementi dell'interfaccia utente interattivi come pulsanti e contenuti multimediali avanzati come immagini. Utilizza i messaggi delle schede per presentare informazioni dettagliate, raccogliere informazioni dagli utenti e guidarli al passaggio successivo.
• Rispondere ai comandi: i comandi aiutano gli utenti a scoprire e utilizzare le funzionalità chiave della tua app di chat.
• Avviare finestre di dialogo: le finestre di dialogo sono interfacce basate su schede che la tua app può aprire per interagire con un utente. È possibile concatenare più schede in sequenza, il che aiuta gli utenti a completare processi in più passaggi, come l'inserimento dei dati del modulo.
• Codelab: vuoi creare un'app di chat più avanzata? Visualizza il feedback App di chat del codelab Crea app per Google Chat con Gemini.