Creare un'app Google Chat con Google Apps Script

Questa pagina spiega come creare un componente aggiuntivo di Google Workspace che funzioni in Google Chat utilizzando Google Apps Script. In Google Chat, i componenti aggiuntivi vengono visualizzati dagli utenti come app Google Chat. Per saperne di più, consulta la panoramica di Estensione di Google Chat.

L'app Chat ti consente di inviare messaggi direttamente e di rispondere ripetendo i 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.
  • Configura un componente aggiuntivo di Google Workspace per 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, 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 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, crea una copia del progetto di avvio rapido e imposta il progetto Cloud in Apps Script.

Crea una copia del progetto di avvio rapido

  1. Fai clic sul pulsante seguente per aprire il progetto Apps Script Componente aggiuntivo in Google Chat.
    Apri il progetto
  2. Fai clic su Panoramica.
  3. Nella pagina Panoramica, fai clic su L'icona per creare una copia Crea una copia.
  4. Assegna un nome alla copia del progetto Apps Script:

    1. Fai clic su Copia dell'app Chat del componente aggiuntivo.

    2. In Titolo del progetto, digita Add-on Chat app

    3. 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 progetto 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.

Configurare il componente aggiuntivo

Utilizzando il deployment di Apps Script, segui questi passaggi per creare un plug-in e implementare l'app Google Chat:

  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 Add-on Chat app.
    2. Nel campo URL avatar, inserisci https://developers.google.com/chat/images/quickstart-app-avatar.png.
    3. Nel campo Descrizione, inserisci Add-on Chat 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 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.