Creare un'app Google Chat con Google Apps Script

Nota: questa guida spiega come creare un'app di chat interattiva utilizzando gli eventi di interazione dell'API Chat. Puoi anche creare la tua app di Chat come componente aggiuntivo di Google Workspace. Per scoprire quale framework utilizzare, consulta Creare un'app Google Chat interattiva.

Crea un'app Google Chat a cui puoi inviare messaggi diretti 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 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 di chat implementata in Apps Script, che risiede in Google Cloud, riceve ed elabora il messaggio.
3. Facoltativamente, la logica dell'app di chat può integrarsi con i servizi Google Workspace, come Calendar o Fogli, o altri servizi Google, come Google Maps o YouTube.
4. La logica dell'app di chat invia una risposta al servizio dell'app di chat in Chat.
5. La risposta viene inviata all'utente.

Obiettivi

• Configurare l'ambiente.
• Configurare lo script.
• Configurare l'app di chat.
• Testare l'app di chat.

Prerequisiti

• Un account Google Workspace Business o Enterprise con accesso a Google Chat.
• Un progetto Google Cloud. Per crearne uno, consulta Creare un progetto Google Cloud.

Configurare l'ambiente

Aprire 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 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

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 ciò che viene mostrato agli utenti e ai revisori dell'app e registra l'app in modo che tu possa pubblicarla in un secondo momento.

1. Nella console API di Google, vai a Menu > Piattaforma Google Auth > Branding.

   Vai a Branding

2. Se hai già configurato la piattaforma Google Auth, puoi configurare le seguenti impostazioni della schermata per il consenso OAuth in Branding, Pubblico e Accesso ai dati. Se visualizzi il messaggio Google Auth Platform 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 di assistenza utente, scegli un indirizzo email di assistenza a cui gli utenti possono contattarti in caso di domande sul consenso.
3. Fai clic su Avanti.
4. In Pubblico, seleziona Interno.
5. Fai clic su Avanti.
6. In Dati di contatto, inserisci un indirizzo email a cui ricevere notifiche in caso di modifiche al 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: servizi API di Google.
9. Fai clic su Continua.
10. Fai clic su Crea.
3. Per ora, puoi saltare l'aggiunta di ambiti. In futuro, quando crei un'app da utilizzare al di fuori della tua organizzazione Google Workspace, devi impostare il Tipo di utente su Esterno. Aggiungi poi gli ambiti di autorizzazione richiesti dall'app. Per saperne di più, consulta la guida completa Configurare il consenso OAuth guide.

Configurare lo script

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

Creare lo script dal modello

1. Vai alla pagina Inizia 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.

In futuro, se vuoi utilizzare determinate API di Google o pubblicare la tua app, devi associare il progetto Cloud al progetto Apps Script. Per questa guida, non è necessario farlo. Per saperne di più, consulta la guida ai progetti Google Cloud.

Creare un deployment di test

Hai bisogno di 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 di chat, fai clic su Esegui il deployment > Deployment di test.
2. Copia l'ID deployment head da utilizzare in un passaggio successivo e fai clic su Fine.

Configurare l'app di chat

Configura l'app di chat dalla console API.

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

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

   1. Deseleziona Crea questa app di chat come componente aggiuntivo di Google Workspace. Si apre una finestra di dialogo in cui ti viene chiesto di confermare. Nella finestra di dialogo, fai clic su Disattiva.
   2. Nel campo Nome app, inserisci Quickstart app.
   3. Nel campo URL avatar, inserisci https://developers.google.com/chat/images/quickstart-app-avatar.png.
   4. Nel campo Descrizione, inserisci Quickstart app.
   5. In Funzionalità, seleziona Partecipa a spazi e conversazioni di gruppo.
   6. In Impostazioni di connessione, seleziona Apps Script.
   7. Nel campo ID deployment, incolla l'ID deployment head che hai copiato in precedenza.
   8. In Visibilità, seleziona Persone e gruppi specifici nel tuo dominio e inserisci la tua email.

4. Fai clic su Salva.

L'app di chat è pronta a rispondere ai messaggi.

Testare l'app di chat

Per testare l'app di chat, apri uno spazio di messaggi diretti con l'app di chat e invia un messaggio:

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

   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 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 API di Google.

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

   L'app di chat ti ringrazia per averla aggiunta e ripete il tuo messaggio.

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

Risoluzione dei problemi

Quando un'app o scheda di Google Chat restituisce un errore, l' interfaccia di Chat mostra il messaggio "Si è verificato un problema". o "Impossibile elaborare la richiesta". A volte l'interfaccia utente di Chat non mostra alcun messaggio di errore, ma l'app o la scheda di 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 è attiva. Per assistenza nella visualizzazione, nel debug e nella correzione degli errori, consulta Risolvere e correggere gli errori di Google Chat.

Libera spazio

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 eliminerai, eliminerai 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 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, puoi riutilizzare i progetti ed evitare così di superare i limiti di quota.

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

   Vai a Resource Manager

2. Nell'elenco dei progetti, seleziona il progetto che vuoi eliminare e poi 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 i pulsanti e rich media come le immagini. Utilizza i messaggi delle schede per presentare informazioni dettagliate, raccogliere informazioni dagli utenti e guidarli a eseguire un passaggio successivo.
• Rispondi ai comandi: i comandi aiutano gli utenti a scoprire e utilizzare le funzionalità chiave della tua app di chat.
• Avvia le finestre di dialogo: le finestre di dialogo sono interfacce basate su schede che l'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 la compilazione dei dati dei moduli.
• Codelab: vuoi creare un'app di chat più avanzata ? Consulta l'app di chat per il feedback del codelab Crea app per Google Chat con Gemini.