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:

Architettura di un'app di Chat implementata con Apps Script.

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

  1. Un utente invia un messaggio a un'app 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. Facoltativamente, la logica dell'app Chat può essere integrata 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 inviata all'utente.

Obiettivi

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

Prerequisiti

Configura 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.

    Attiva l'API

Tutte le app che utilizzano OAuth 2.0 richiedono la configurazione di una schermata per il consenso. La configurazione della schermata per il consenso OAuth della tua app definisce cosa viene mostrato agli utenti e ai revisori dell'app e registra la tua app in modo da poterla pubblicare in un secondo momento.

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

    Vai alla schermata per il consenso OAuth

  2. In Tipo di utente, seleziona Interno e poi fai clic su Crea.
  3. Completa il modulo di registrazione dell'app, quindi 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 crei un'app da utilizzare al di fuori della tua organizzazione Google Workspace, devi modificare il Tipo di utente in Esterno, quindi 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 sembra corretta, fai clic su Torna alla dashboard.

Configurare 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 Introduzione di Apps Script.
  2. Fai clic sul modello App di chat nella parte inferiore 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 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 L'icona per le impostazioni del progetto.
  2. In Progetto Google Cloud (Google Cloud), fai clic su Cambia progetto.
  3. In Numero progetto Google Cloud, incolla il numero del progetto Google Cloud.
  4. Fai clic su Imposta progetto.

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

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

Creare un deployment di test

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

Per ottenere l'ID deployment principale:

  1. Nel progetto Apps Script dell'app Chat, fai clic su Esegui il deployment > Testa i deployment.
  2. Copia l'ID deployment principale 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 Ricevi messaggi 1:1 e Partecipa a spazi e conversazioni di gruppo.
    5. In Impostazioni di connessione, seleziona Apps Script.
    6. Nel campo Deployment ID (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 per 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 fornito quando hai aggiunto te stesso come tester attendibile.

    Vai a Google Chat

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

  4. Seleziona l'app Chat dai risultati. Viene visualizzato un messaggio diretto.

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

    L'app Chat ti ringrazia per l'aggiunta e ripete il messaggio.

Per aggiungere Trusted Tester e scoprire di più sul test delle funzionalità interattive, consulta Testare le funzionalità interattive per le app Google Chat.

Risoluzione dei problemi

Quando un'app o una scheda di Google Chat 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 Chat o la scheda produce un risultato imprevisto; ad esempio, un messaggio della scheda potrebbe non essere visualizzato.

Sebbene 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 la registrazione degli errori per le app Chat è attivata. Per assistenza su come visualizzare, eseguire il debug e correggere gli errori, consulta la sezione 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.

  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 il progetto che vuoi eliminare e fai clic su Elimina .
  3. Nella finestra di dialogo, digita l'ID progetto e fai clic su Chiudi per eliminare il progetto.

Passaggi successivi

  • Crea schede interattive: i messaggi con schede supportano un layout definito, elementi dell'interfaccia utente interattivi come i pulsanti e contenuti multimediali avanzati come le immagini. Utilizza i messaggi delle schede per presentare informazioni dettagliate, raccogliere informazioni dagli utenti e indirizzarli a un passaggio successivo.
  • Supporta i comandi slash: i comandi slash ti consentono di registrare e pubblicizzare comandi specifici che gli utenti possono dare alla tua app digitando un comando che inizia con una barra (/), ad esempio /help.
  • Avvia finestre di dialogo: le finestre di dialogo sono interfacce basate su schede con finestre che la tua app può aprire per interagire con un utente. È possibile concatenare più schede in sequenza, il che aiuta gli utenti a completare procedure con più passaggi, ad esempio la compilazione dei dati dei moduli.
  • Codelab: vuoi creare un'app di chat più avanzata? Visualizza il feedback dell'app Chat del codelab Crea app per Google Chat con Gemini.