Crea un'app Google Chat a cui inviare messaggi diretti e risponde ribadendo i tuoi messaggi.
Il seguente diagramma mostra l'architettura e il modello di messaggistica:
Nel diagramma precedente, un utente interagisce con uno script di Google Apps L'app Chat prevede il seguente flusso di informazioni:
- Un utente invia un messaggio a un'app di Chat in un un messaggio diretto o in uno spazio di Chat.
- La logica dell'app di Chat implementata Apps Script, che risiede in Google Cloud, riceve ed elabora il messaggio.
- Facoltativamente, la logica dell'app di Chat può integrarsi con ai servizi Google Workspace, ad esempio Calendar o Fogli o altri servizi Google, ad esempio Google Maps o su YouTube.
- La logica dell'app Chat invia una risposta all' Servizio app di Chat in Chat.
- La risposta viene consegnata all'utente.
Obiettivi
- Configurare l'ambiente.
- Configura lo script.
- Pubblica l'app Chat.
- Prova l'app Chat.
Prerequisiti
- Un'azienda o un'impresa Google Workspace con accesso a Google Chat.
- Un progetto Google Cloud. Per crearne uno, consulta Creare un progetto Google Cloud.
Configura l'ambiente
Apri il tuo progetto Cloud nella console Google Cloud
Se non è già aperto, apri il progetto Cloud che intendi utilizzare per questo esempio:
- Nella console Google Cloud, vai alla pagina Seleziona un progetto.
- 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, potrebbe essere necessario attivare la fatturazione per il progetto.
Attiva 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.
Configurare la schermata per il consenso OAuth
Tutte le app che utilizzano OAuth 2.0 richiedono una configurazione della schermata per il consenso. Configurazione in corso... la schermata per il consenso OAuth dell'app definisce cosa viene mostrato agli utenti e all'app revisori e registra la tua app per permetterti di pubblicarla in un secondo momento.
- Nella console Google Cloud, vai al Menu > API e Servizi > Schermata consenso OAuth.
- In Tipo di utente, seleziona Interno, quindi fai clic su Crea.
- Compila il modulo di registrazione dell'app, quindi fai clic su Salva e continua.
Per ora, puoi saltare l'aggiunta di ambiti e fare clic su Salva e continua. In futuro, quando creerai un'app da utilizzare al di fuori del tuo Nell'organizzazione Google Workspace, devi modificare il Tipo di utente in Esterno e poi aggiungi gli ambiti di autorizzazione richiesti dalla tua app.
- Esamina il riepilogo della registrazione dell'app. Per apportare modifiche, fai clic su Modifica. Se l'app la registrazione sembra a posto, fai clic su Torna alla Dashboard.
Configurare lo script
Per configurare lo script, utilizza un modello, quindi imposti progetto Cloud in Apps Script.
Crea lo script dal modello
- Vai alla sezione Pagina Guida introduttiva di Apps Script.
- Fai clic sul modello App Chat. Potresti dover scorrere verso il basso per vedere questo modello.
- Fai clic su Progetto senza titolo, digita
Quickstart app
e fai clic su Rinomina.
Copia il numero del progetto Cloud
- Nella console Google Cloud, vai al Menu > IAM e Amministratore > Impostazioni.
- Copia il valore nel campo Numero progetto.
Impostare il progetto Cloud del progetto Apps Script
- Nel progetto Apps Script dell'app Chat,
fai clic su Impostazioni progetto
.
- In Progetto Google Cloud Platform (Google Cloud), fai clic su Cambia progetto.
- In Numero di progetto Google Cloud, incolla il numero di progetto Google Cloud.
- Fai clic su Imposta progetto.
Ora disponi di un codice dell'app funzionante che puoi provare (come descritto nella passaggi successivi) e poi personalizzarla in base alle tue esigenze.
Assicurati di aver eseguito l'accesso all'Account Google corretto quando apri la il modello Apps Script. L'account corrente a volte può passare a sul tuo account predefinito senza che tu te ne accorga.
Crea un deployment di test
È necessario un ID deployment per questo progetto Apps Script, potrai utilizzarlo nel prossimo passaggio.
Per ottenere l'ID deployment head, segui questi passaggi:
- Nel progetto Apps Script dell'app Chat, fai clic su Esegui il deployment. > Testa i deployment.
- Copia l'ID deployment principale per utilizzarlo in un passaggio successivo e fai clic su Fine.
Pubblicare l'app Chat
Pubblica l'app Chat dalla console Google Cloud.
- Nella
Console Google Cloud,
cerca
Google Chat API
e fai clic su API Google Chat. - Fai clic su Gestisci.
Fai clic su Configurazione e configura l'app Chat:
- Nel campo Nome app, inserisci
Quickstart app
. - Nel campo URL avatar, inserisci
https://developers.google.com/chat/images/quickstart-app-avatar.png
. - Nel campo Description (Descrizione), inserisci
Quickstart app
. - In Funzionalità, seleziona Ricevi messaggi 1:1 e Partecipare a spazi e conversazioni di gruppo.
- In Impostazioni di connessione, seleziona Progetto Apps Script.
- Nel campo ID deployment, incolla l'ID deployment Head che hai precedentemente copiati.
- In Visibilità, seleziona Persone e gruppi specifici nei tuoi dominio e inserisci il tuo indirizzo email.
- Nel campo Nome app, inserisci
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:
Apri Google Chat usando l'account Google Workspace che hai indicato quando ti sei aggiunto come trusted tester.
- Fai clic su Nuova chat.
- Nel campo Aggiungi una o più persone, digita il nome del tuo Chat.
Seleziona la tua app Chat dai risultati. Un annuncio diretto si apre il messaggio.
Nel nuovo messaggio diretto con l'app, digita
Hello
e premienter
.L'app Chat ti ringrazia per l'aggiunta ed echi il tuo messaggio.
Per aggiungere trusted tester e scoprire di più sui test delle funzionalità interattive, vedi Testa le funzionalità interattive per App Google Chat.
Risoluzione dei problemi
Quando un'app Google Chat o card restituisce un errore, L'interfaccia di Chat mostra il messaggio "Si è verificato un problema". o "Impossibile elaborare la richiesta". A volte, l'UI di Chat non mostra alcun messaggio di errore, ma l'app Chat o la scheda restituisce un risultato inaspettato; Ad esempio, il messaggio di una scheda potrebbe non vengono visualizzate.
Anche se un messaggio di errore potrebbe non essere visualizzato nella UI di Chat, messaggi di errore descrittivi e dati di log che ti aiuteranno a correggere gli errori quando il logging degli errori per le app di chat è attivo. Per assistenza con la visualizzazione, il debug e la correzione degli errori, consulta Risolvere i problemi e correggere gli errori di Google Chat.
Esegui la pulizia
Per evitare che al tuo account Google Cloud vengano addebitati costi per utilizzate in questo tutorial, ti consigliamo di eliminare progetto cloud.
- Nella console Google Cloud, vai alla pagina Gestisci risorse. Clic Menu > IAM e Amministratore > Gestisci risorse.
- Nell'elenco dei progetti, seleziona il progetto che vuoi eliminare e fai clic su Elimina .
- Nella finestra di dialogo, digita l'ID progetto e fai clic su Chiudi per eliminarlo. del progetto.
Passaggi successivi
- Crea schede interattive: scheda supportano un layout definito, elementi UI interattivi come pulsanti e rich media come immagini. Usa i messaggi delle schede per presentare informazioni dettagliate, raccogliere informazioni dagli utenti e guidarli nel passaggio successivo.
- Supporta i comandi slash: i comandi slash consentono
registri e pubblicizzi comandi specifici che gli utenti possono dare alla tua app
digitando un comando che inizia con una barra (
/
), ad esempio/help
. - Finestra di dialogo di avvio: le finestre di dialogo sono basate su schede e vengono visualizzate con finestre che la tua app può aprire per interagire con un utente. Più carte possono essere combinati in sequenza, consentendo agli utenti di completare come la compilazione dei dati dei moduli.
- Creare app per Google Chat con Gemini. Codelab: pronto per creare una build più avanzata app Chat? Leggi il feedback App Chat del codelab