Scegliere un'architettura per l'app Google Chat

Questa pagina descrive gli approcci comuni all'architettura dei servizi utilizzati per creare app Google Chat. Se hai un'app esistente che vuoi integrare in Google Chat, puoi utilizzare o adattare l'implementazione esistente. Se stai creando una nuova app di Chat, questa pagina presenta informazioni simili in diversi modi per aiutarti a scegliere l'architettura più adatta al tuo caso d'uso:

Panoramica per funzionalità e caratteristiche

La tabella seguente evidenzia le funzionalità chiave delle app di Chat e lo stile di architettura del servizio consigliato (). In alcuni casi, potrebbe essere possibile sviluppare un altro stile di architettura con queste funzionalità, ma non è adatto al caso d'uso quanto altri stili ().

Caratteristiche e funzionalità

Servizio web o HTTP

Pub/Sub

Webhook

Apps Script

AppSheet

Dialogflow

Script

Pubblico di destinazione

Il tuo team

La tua organizzazione

Il pubblico

Interattività utente

Utilizza l'elaborazione del linguaggio naturale

Pattern di messaggi

Inviare e ricevere messaggi sincroni

Invia e ricevi messaggi sincroni e asincroni

Invia solo messaggi asincroni

Inviare messaggi da un sistema esterno a un singolo spazio di Chat

Accedere ad altri servizi e sistemi

Integrazione con altri servizi Google

Comunicare dietro un firewall

Abbonati agli eventi di Google Workspace

Stili di programmazione e deployment

Sviluppo senza codice

Sviluppo con poco codice

Sviluppo in un linguaggio di programmazione a tua scelta

DevOps semplificati

Gestione completa di DevOps e CI/CD

Stili di architettura dei servizi

Questa sezione descrive alcuni degli approcci architetturali più comuni utilizzati per creare app di Chat.

Servizio web o HTTP

Un servizio web o HTTP è l'architettura di cui viene eseguito il deployment più spesso, perché offre agli sviluppatori la massima flessibilità per creare app di Chat pubbliche. Questa architettura è consigliata per i seguenti casi d'uso:

  • Il deployment dell'app di Chat è disponibile pubblicamente su Google Workspace Marketplace.
  • L'app Chat può inviare e ricevere tutti i pattern di messaggistica: inviare e ricevere messaggi sincroni, inviare messaggi asincroni e inviare messaggi da un sistema esterno.
  • L'app Chat è sviluppata in qualsiasi linguaggio di programmazione.
  • L'app Chat richiede una gestione completa di DevOps e CI/CD.
  • Il servizio app Chat è implementato in server cloud o on-premise.

In questa progettazione, configurerai Chat per l'integrazione con un servizio remoto utilizzando HTTP, come mostrato nel seguente diagramma:

Architettura di un'app di Chat che utilizza un servizio web in un server on-premise.

Nel diagramma precedente, un utente che interagisce con un'app di Chat HTTP prevede il seguente flusso di informazioni:

  1. Un utente invia un messaggio in uno spazio di Chat a un'app Chat.
  2. Una richiesta HTTP viene inviata a un server web che è un sistema cloud o on-premise che contiene la logica dell'app Chat.
  3. Facoltativamente, la logica dell'app di Chat può interagire con servizi di terze parti esterni, ad esempio un sistema di gestione dei progetti o uno strumento di gestione dei ticket.
  4. Il server web invia una risposta HTTP al servizio app Chat in Chat.
  5. La risposta viene recapitata all'utente.
  6. Facoltativamente, l'app Chat può chiamare l'API Chat per pubblicare i messaggi in modo asincrono o eseguire altre operazioni.

Questa architettura offre la flessibilità di utilizzare librerie e componenti esistenti già presenti nel tuo sistema, poiché queste app di Chat possono essere progettate utilizzando linguaggi di programmazione diversi. Esistono diversi modi per implementare questa architettura. In Google Cloud, puoi utilizzare Cloud Functions, Cloud Run e App Engine. Per iniziare, consulta Creare un'app Google Chat con Cloud Functions.

Pub/Sub

Se l'app Chat è implementata dietro un firewall, Chat non è in grado di effettuare chiamate HTTP all'app. Un approccio è utilizzare Pub/Sub per abilitare l'implementazione dell'app Chat per la sottoscrizione a un argomento che trasporta messaggi da Chat. Pub/Sub è un servizio di messaggistica asincrono che disaccoppia i servizi che producono messaggi dai servizi che elaborano questi messaggi. Questa architettura è consigliata per i seguenti casi d'uso:

  • L'app Chat è protetta da un firewall.
  • L'app Chat riceve gli eventi relativi a uno spazio di Chat.
  • È stato eseguito il deployment dell'app Chat nella tua organizzazione.
  • L'app Chat può inviare e ricevere messaggi sincroni e asincroni.
  • L'app Chat è sviluppata in qualsiasi linguaggio di programmazione.
  • L'app Chat richiede una gestione completa di DevOps e CI/CD.

Il seguente diagramma mostra l'architettura di un'app di Chat creata con Pub/Sub:

Architettura di un'app di chat implementata con Pub/Sub.

Nel diagramma precedente, un utente che interagisce con un'app di chat di Pub/Sub ha il seguente flusso di informazioni:

  1. Un utente invia un messaggio in Chat a un'app Chat, in un messaggio diretto o in uno spazio di Chat, oppure si verifica un evento in uno spazio di Chat per il quale l'app Chat ha un abbonamento attivo.

  2. Chat invia il messaggio a un argomento Pub/Sub.

  3. Un server delle applicazioni, ovvero un sistema cloud o on-premise che contiene la logica dell'app Chat, sottoscrive l'argomento Pub/Sub per ricevere il messaggio attraverso il firewall.

  4. Facoltativamente, l'app Chat può chiamare l'API Chat per pubblicare i messaggi in modo asincrono o eseguire altre operazioni.

Per iniziare, vedi Utilizzare Pub/Sub come endpoint per l'app Chat.

Webhook

Puoi creare un'app di Chat che possa inviare messaggi solo a uno spazio di Chat specifico utilizzando le chiamate a un URL di webhook di Chat. Questa architettura è consigliata per i seguenti casi d'uso:

  • Viene eseguito il deployment dell'app Chat nel team.
  • L'app Chat invia messaggi da un sistema esterno a un singolo spazio di Chat.

Con questa architettura, l'app Chat è limitata a uno spazio di Chat specifico e non consente l'interazione dell'utente, come mostrato nel seguente diagramma:

Architettura per i webhook in arrivo per inviare messaggi asincroni a Chat.

Nel diagramma precedente, un'app di Chat presenta il seguente flusso di informazioni:

  1. La logica dell'app Chat riceve informazioni da servizi di terze parti esterni, ad esempio un sistema di gestione dei progetti o uno strumento di gestione dei ticket.
  2. La logica dell'app Chat è ospitata in un sistema cloud o on-premise che può inviare messaggi utilizzando un URL webhook a uno spazio di Chat specifico.
  3. Gli utenti possono ricevere messaggi dall'app Chat nello spazio di Chat specifico, ma non possono interagire con l'app Chat.

Questo tipo di app di chat non può essere condivisa in altri spazi di Chat o con altri team e non può essere pubblicata in Google Workspace Marketplace. I webhook in arrivo sono consigliati per consentire alle app di Chat di segnalare avvisi o stato o per alcuni tipi di prototipazione delle app Chat.

Per iniziare, consulta Inviare messaggi a Chat con i webhook.

Apps Script

Puoi creare la logica dell'app di Chat interamente in JavaScript. Google Apps Script è una piattaforma di sviluppo low code per le app di Chat. Apps Script gestisce il flusso di autorizzazione e i token OAuth 2.0 per l'autenticazione degli utenti. Puoi utilizzare Apps Script per creare app di chat pubbliche, ma è sconsigliato a causa di quote e limiti giornalieri.

Questa architettura è consigliata per i seguenti casi d'uso:

  • Il deployment dell'app Chat viene eseguito nel tuo team o nella tua organizzazione.
  • L'app Chat può inviare e ricevere tutti i pattern di messaggistica: inviare e ricevere messaggi sincroni, inviare messaggi asincroni e inviare messaggi da un sistema esterno.
  • L'app Chat richiede la gestione DevOps semplificata.

Questa architettura è utile per le app di Chat che si integrano anche con altri servizi Google e Workspace, come Fogli Google, Presentazioni Google, Google Calendar, Google Drive, Google Maps e YouTube, come mostrato nel seguente diagramma:

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

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 il messaggio.
  3. Facoltativamente, la logica dell'app Chat può integrarsi con i servizi 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.

Per iniziare, consulta Creare un'app di chat con Apps Script.

AppSheet

Puoi creare un'app di Chat condivisa nel dominio senza codice utilizzando AppSheet. Puoi semplificare il processo di sviluppo utilizzando la modalità di configurazione automatica e i seguenti modelli per creare azioni comuni per l'app Chat. Tuttavia, alcune funzionalità dell'app web di AppSheet non sono disponibili nelle app di chat.

Questa architettura è consigliata per i seguenti casi d'uso:

  • Il deployment dell'app Chat è stato eseguito per te e il tuo team.
  • L'app Chat può inviare e ricevere messaggi sincroni e asincroni.
  • L'app Chat richiede la gestione DevOps semplificata.

Il seguente diagramma mostra l'architettura di un'app di Chat creata con AppSheet:

Architettura di un'app di chat implementata con AppSheet.

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

  1. Un utente invia un messaggio in Chat a un'app Chat, in un messaggio diretto o in uno spazio di Chat.
  2. La logica dell'app di Chat implementata in AppSheet, che risiede in Google Cloud, riceve il messaggio.
  3. Facoltativamente, la logica dell'app Chat può integrarsi con i servizi di Google Workspace, come Apps Script o Fogli Google.
  4. La logica dell'app Chat invia una risposta al servizio dell'app Chat in Chat.
  5. La risposta viene recapitata all'utente.

Per iniziare, consulta Creare un'app di chat con AppSheet.

Dialogflow

Puoi creare un'app di chat con Dialogflow, una piattaforma basata sul linguaggio naturale per conversazioni automatiche e risposte dinamiche. Questa architettura è consigliata per i seguenti casi d'uso:

  • L'app Chat può inviare e ricevere messaggi sincroni.
  • L'app Chat usa l'elaborazione del linguaggio naturale per rispondere e interagire con gli utenti.

Il seguente diagramma mostra l'architettura di un'app Chat creata con Dialogflow:

Architettura di un'app di chat implementata con Dialogflow.

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

  1. Un utente invia un messaggio in Chat a un'app Chat, in un messaggio diretto o in uno spazio di Chat.
  2. Un agente virtuale Dialogflow, che risiede in Google Cloud, riceve ed elabora il messaggio per produrre una risposta.
  3. Facoltativamente, utilizzando un webhook Dialogflow, l'agente Dialogflow può interagire con servizi di terze parti esterni, ad esempio un sistema di gestione dei progetti o uno strumento di gestione dei ticket.
  4. L'agente Dialogflow invia una risposta al servizio app Chat in Chat.
  5. La risposta viene recapitata allo spazio di Chat.

Per iniziare, consulta Creare un'app Dialogflow Google Chat.

Applicazione o script a riga di comando

Puoi creare un'applicazione a riga di comando o uno script che invia messaggi a Chat o esegue altre operazioni, come la creazione di uno spazio o la gestione dei membri di uno spazio, senza consentire agli utenti di chiamare o rispondere direttamente all'app Chat in Chat. Questa architettura è consigliata per i seguenti casi d'uso:

  • L'app Chat è sviluppata in qualsiasi linguaggio di programmazione.
  • L'app Chat può inviare solo messaggi asincroni.

Il seguente diagramma mostra l'architettura:

Architettura di un'app di chat implementata con un'applicazione a riga di comando o uno script.

Nel diagramma precedente, l'app Chat presenta il seguente flusso di informazioni:

  1. L'app Chat chiama l'API Chat per inviare un messaggio o eseguire un'altra operazione.
  2. Chat esegue l'operazione richiesta.
  3. Facoltativamente, l'app Chat stampa una conferma nell'interfaccia a riga di comando.

Implementazione della logica dell'app di chat

Chat non limita il modo in cui implementi la logica dell'app Chat. Puoi creare un analizzatore sintattico di comandi a sintassi fissa, utilizzare librerie o servizi avanzati di elaborazione del linguaggio e IA, sottoscrivere abbonamenti e rispondere agli eventi o qualsiasi altra cosa appropriata per i tuoi obiettivi specifici.

Gestire le interazioni degli utenti

L'app di chat può ricevere e rispondere alle interazioni degli utenti in diversi modi. Un'interazione utente è qualsiasi azione eseguita da un utente per richiamare o interagire con un'app di chat.

Parser di comandi

Le app di Chat basate sui comandi esaminano il payload degli eventi di interazione dell'app Chat e, successivamente, estraggono comandi e parametri da questi contenuti. Ad esempio, consulta Configurare i comandi slash per interagire con gli utenti di Chat.

Un altro approccio consiste nel tokenizzare il messaggio, estrarre il comando e quindi fare riferimento a un dizionario che mappa i comandi alle funzioni di gestore di ciascun comando.

Interfaccia utente basata su finestre di dialogo

Le app basate su finestre di dialogo rispondono agli eventi di interazione dell'app Chat mostrando finestre a schede in cui l'utente può interagire con l'app Chat, ad esempio compilando moduli o richiedendo azioni.

Ogni volta che l'utente esegue un'azione in una finestra di dialogo, viene inviato un nuovo evento di interazione all'app Chat, che può rispondere aggiornando la finestra di dialogo o inviando un messaggio.

Elaborazione del linguaggio naturale

Molte implementazioni di app di Chat utilizzano l'elaborazione del linguaggio naturale (NLP) per determinare le richieste dell'utente. Esistono vari modi per implementare l'NLP, che puoi scegliere come preferisci.

Puoi utilizzare l'elaborazione NLP nell'implementazione dell'app Chat con Dialogflow ES o integrazione di Dialogflow con Dialogflow, che consente di creare agenti virtuali per conversazioni automatiche e risposte dinamiche.

Inviare in modo proattivo le richieste a Chat

Le app di chat possono anche inviare messaggi o altre richieste a Chat, che non vengono attivate dalle interazioni dirette degli utenti in Chat. Queste app di chat possono essere attivate, ad esempio da applicazioni di terze parti o utilizzando una chiamata dalla riga di comando di un utente, ma gli utenti non possono interagire con queste app di Chat direttamente in Chat.

Le app di Chat non interattive utilizzano l'API Chat per inviare messaggi o altri tipi di richieste a Chat.

Pattern di conversazione

Considera in che modo vuoi che l'app Chat interagisca con gli utenti. Le seguenti sezioni descrivono i pattern di conversazione che potrebbero essere implementati dalla tua app di chat.

Chiamata e risposta (sincrona)

In un modello di chiamata e risposta sincrono, l'app Chat risponde ai messaggi degli utenti in modo individuale. Un messaggio all'app Chat di un utente genera una risposta dall'app Chat, come mostrato nel seguente diagramma:

Architettura di un messaggio sincrono.

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

  1. Un utente invia un messaggio sincrono a un'app di Chat, ad esempio "Qual è la mia prossima riunione?".
  2. L'app di chat invia un messaggio sincrono all'utente, ad esempio "Dott. ssa Silva alle 14:30".

Per questo tipo di pattern conversazionale, puoi implementare un'architettura dell'app di Chat utilizzando un servizio web, Pub/Sub, Apps Script, AppSheet o Dialogflow.

Risposte multiple (asincrone)

Il pattern a risposte multiple può includere messaggi sincroni e asincroni. Questo pattern è caratterizzato da una comunicazione bidirezionale tra gli utenti e l'app Chat, in cui l'app Chat genera un numero qualsiasi di messaggi aggiuntivi, come mostrato nel seguente diagramma:

Architettura di un messaggio asincrono.

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

  1. Un utente invia un messaggio sincrono a un'app Chat, ad esempio "Monitora il traffico".
  2. L'app Chat invia un messaggio sincrono all'utente per confermare la richiesta, ad esempio "Monitoraggio attivo".
  3. Successivamente, l'app Chat invia uno o più messaggi asincroni all'utente chiamando l'API REST, ad esempio "Nuovo traffico".
  4. L'utente invia un ulteriore messaggio sincrono all'app Chat, ad esempio "Ignora il traffico".
  5. L'app Chat invia un messaggio sincrono all'utente per confermare la richiesta, ad esempio "Monitoraggio disattivato".

Per questo tipo di pattern conversazionale, puoi implementare un'architettura dell'app di Chat utilizzando un servizio web, Pub/Sub, Apps Script o AppSheet.

Iscriviti agli eventi (asincrona)

In un pattern asincrono basato su eventi, l'app Chat si sottoscrive agli eventi utilizzando l'API Eventi di Google Workspace. Gli eventi rappresentano le modifiche alle risorse di Chat, ad esempio quando viene pubblicato un nuovo messaggio o quando un utente partecipa a uno spazio. Le app di Chat basate su eventi esaminano il payload dell'evento per ottenere dati sulla risorsa Chat modificata e rispondono di conseguenza.

Le app di chat possono iscriversi a molti tipi di eventi. Quando un'app di chat ha un abbonamento attivo, Chat invia un evento quando si verifica qualcosa di pertinente in uno spazio di Chat. L'app Chat può quindi generare un numero qualsiasi di risposte asincrone, che invia di nuovo a Chat utilizzando l'API Chat.

Puoi utilizzare questo tipo di logica per aggiornare i sistemi esterni, ad esempio un sistema di gestione dei ticket, o inviare messaggi a uno spazio di Chat in modo asincrono, ad esempio inviando un messaggio di benvenuto quando un nuovo utente entra in uno spazio di Chat.

Il seguente diagramma mostra il modello di conversazione basata su eventi:

Architettura di un messaggio basato su eventi.

Nel diagramma precedente, l'interazione tra Chat e l'app Chat prevede il seguente flusso di informazioni:

  1. L'app Chat si abbona a uno spazio di Google Chat.
  2. Lo spazio a cui è iscritta l'app Chat cambia.
  3. L'app Chat fornisce un evento in un argomento in Pub/Sub che funge da endpoint di notifica per la sottoscrizione. L'evento contiene dati su cosa è cambiato nella risorsa.
  4. L'app Chat elabora il messaggio Pub/Sub che contiene l'evento e, se necessario, interviene.

Per questo tipo di pattern conversazionale, puoi implementare un'architettura dell'app di Chat utilizzando Pub/Sub, un servizio web o Apps Script.

Per scoprire di più su come ricevere e rispondere agli eventi, vedi Lavorare con gli eventi degli eventi di Google Chat.

Messaggio unidirezionale da un'app di Chat

Un messaggio unidirezionale da un pattern dell'app Chat consente a un'app di Chat di inviare messaggi asincroni in uno spazio di Chat, ma non consente agli utenti di interagire direttamente con l'app Chat. Questo pattern non è conversazionale o interattivo, ma può essere utile per attività come i report sulle sveglie, come mostrato nel diagramma seguente:

Architettura di un messaggio unidirezionale.

Nel diagramma precedente, un utente nello stesso spazio dell'app Chat ha il seguente flusso di informazioni:

  • L'app Chat invia un messaggio asincrono all'utente chiamando l'API Chat o pubblicandolo su un URL webhook, ad esempio "Avviso di overflow della coda".
  • Se vuoi, l'app Chat invia altri messaggi asincroni.

Per questo tipo di pattern conversazionale, puoi implementare un'architettura dell'app di Chat utilizzando un servizio web, un webhook, Apps Script, AppSheet, un'applicazione a riga di comando o uno script.

Messaggio unidirezionale a un'app di Chat

Un messaggio unidirezionale in un pattern dell'app di Chat consente a un utente di inviare messaggi a un'app di Chat senza che l'app Chat risponda durante l'elaborazione della richiesta. Sebbene questa architettura sia tecnicamente possibile, ciò comporta un'esperienza utente scadente e sconsigliamo vivamente di utilizzare questo modello.