Creare un'app Google Chat con Google Apps Script

Crea un'app Google Chat a cui puoi inviare messaggi e che risponda facendo 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, presente in Google Cloud, riceve il messaggio ed elabora il messaggio.
3. Facoltativamente, la logica dell'app Chat può integrarsi con i servizi di 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.
• Pubblica l'app Chat.
• Prova 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

Tutte le app che utilizzano OAuth 2.0 richiedono una configurazione della schermata per il consenso. La configurazione della schermata per il consenso OAuth dell'app definisce ciò che viene mostrato agli utenti e ai revisori dell'app e registra la tua app in modo che tu possa pubblicarla in un secondo momento.

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

   Vai alla schermata per il consenso OAuth

2. Seleziona il tipo di utente per l'app, poi fai clic su Crea.
3. Completa 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 aggiungere e verificare gli ambiti di autorizzazione richiesti dall'app.

5. Se hai selezionato Esterno come tipo di utente, aggiungi gli utenti di test:
   1. In Utenti di test, fai clic su Aggiungi utenti.
   2. Inserisci il tuo indirizzo email e tutti gli altri utenti di test autorizzati, quindi fai clic su Salva e continua.
6. 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.

Creare lo script dal modello

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

Copia il numero del progetto Cloud

1. Vai al tuo progetto Cloud nella console Google Cloud.
2. Fai clic su Impostazioni e utilità > Impostazioni progetto.
3. Copia il Numero di progetto.

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 del progetto Google Cloud.
4. Fai clic su Imposta progetto.

Ora disponi di un codice dell'app funzionante che puoi provare (come descritto nei passaggi seguenti) e quindi personalizzare in base ai tuoi requisiti.

Quando apri il modello Apps Script, assicurati di aver eseguito l'accesso all'Account Google corretto. A volte l'account corrente può passare al tuo account predefinito senza che te ne accorga.

Crea un deployment di prova

Devi avere 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 i deployment.
2. Copia l'ID deployment head per utilizzarlo in un passaggio successivo e fai clic su Fine.

Pubblicare l'app Chat

Pubblica 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 e incolla l'ID deployment nel campo.
   6. In Autorizzazioni, seleziona Persone e gruppi specifici nel tuo dominio e inserisci il tuo indirizzo email.

4. Fai clic su Salva e aggiorna la pagina.

5. Nella pagina di configurazione, in Stato app, imposta lo stato su Pubblicata - disponibile per gli utenti.

6. Fai clic su Salva.

L'app Chat è pronta per rispondere ai messaggi.

Testare l'app Chat

1. Apri Chat.
2. Inviare un nuovo messaggio diretto all'app facendo clic su Avvia una chat > Trova app.
3. Nella pagina Trova app, cerca Quickstart App.
4. Accanto ad App rapida, fai clic su Chat.
5. Nel nuovo messaggio diretto con l'app, digita Hello e premi enter.

L'app ti ringrazia per l'aggiunta ed eco al messaggio.

Passaggi successivi

• Crea schede interattive: i messaggi delle schede supportano un layout definito, elementi di 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 nel passaggio successivo.
• Supporto dei comandi slash: i comandi slash ti consentono di registrare e pubblicizzare comandi specifici che gli utenti possono usare nella tua app digitando un comando che inizia con una barra (/), ad esempio /help.
• Finestre di dialogo di avvio: sono interfacce a schede che l'app può aprire per interagire con un utente. Più schede possono essere unite in sequenza, il che aiuta gli utenti a completare procedure in più passaggi, come la compilazione dei dati dei moduli.