Configurare un'app Google Chat

Questa pagina spiega come configurare ed eseguire il deployment di un'app Google Chat come componente aggiuntivo di Google Workspace.

Per eseguire il deployment e testare un componente aggiuntivo di Google Workspace che estende Chat, devi abilitare e configurare un'app Chat utilizzando l'API Google Chat. Le impostazioni di configurazione dell'API Chat sono il punto in cui specifichi tutti i dettagli dell'app Chat, inclusi nome, avatar, deployment e funzionalità interattive che vuoi utilizzare.

Prerequisiti

Scegliere un nome visualizzato, un avatar e una descrizione per l'app Chat

Il nome, l'avatar e la descrizione dell'app Chat vengono mostrati agli utenti nell'interfaccia utente di Chat. Per interagire con le app Chat, gli utenti visualizzano o utilizzano queste informazioni nei seguenti modi:

  • Menzionano l'app Chat con @ per aggiungerla a uno spazio o inviarle un messaggio.
  • Trovano e avviano un messaggio diretto con l'app Chat. Nel menu App, i messaggi diretti mostrano il nome e l'avatar dell'app Chat.
  • Dalla barra di scrittura, gli utenti possono sfogliare le app Chat e visualizzarne il nome, l'avatar e la descrizione.

Prima di configurare un'app Chat, devi preparare le seguenti informazioni:

Campo Descrizione Formato
Nome dell'app Il nome visualizzato dell'app Chat. Fino a 25 caratteri alfanumerici
URL avatar L'immagine che viene visualizzata come avatar dell'app Chat avatar. Un URL HTTPS che rimanda a un'immagine grafica quadrata (PNG o JPEG). La dimensione consigliata è di almeno 256 x 256 pixel.
Descrizione Una breve descrizione dello scopo dell' app Chat. Fino a 40 caratteri alfanumerici

Nella sezione seguente, specifichi queste informazioni nelle impostazioni di configurazione dell'API Chat.

Configurare l'app Chat nella console Google Cloud

Nella console Google Cloud, configuri i dettagli dell'app Chat che vengono mostrati agli utenti in Chat, inclusi nome visualizzato, avatar e descrizione. Questi dettagli vengono visualizzati solo in Chat. Per pubblicare l'app Chat su Marketplace, devi anche specificare i dettagli che vengono visualizzati nella scheda di Google Workspace Marketplace dell'app Chat .

Quando hai i dettagli dell'app Chat, apri il progetto Cloud e configura l'API Chat:

  1. Nella console Google Cloud, vai alla pagina dell'API Chat e fai clic sulla pagina Configurazione:

    Vai alla pagina di configurazione dell'API Chat

  2. In Informazioni sull'applicazione, compila i campi Nome dell'app, URL avatar, e Descrizione.

  3. In Funzionalità interattive, imposta Attiva funzionalità interattive su On e completa i seguenti passaggi:

    1. In Funzionalità, seleziona Unisciti a spazi e conversazioni di gruppo per rendere disponibile l'app Chat per l'installazione e l'utilizzo.

      Per impostazione predefinita, gli utenti possono installare l'app Chat e inviarle messaggi in uno spazio dedicato tra l'utente e l'app Chat. Gli utenti possono anche aggiungere l'app Chat e interagire con essa in spazi con più persone.

    2. In Impostazioni di connessione, seleziona l'architettura che vuoi utilizzare per ricevere oggetti evento da Chat:

      • Per utilizzare un servizio HTTP, seleziona URL endpoint HTTP e fornisci un URL.
      • Per utilizzare un progetto Google Apps Script, seleziona Apps Script e fornisci un ID deployment per il progetto.
      • Per utilizzare un agente Dialogflow, seleziona Dialogflow, seleziona Dialogflow CX o Dialogflow ES e fornisci il nome della risorsa dell'agente.
      • Per utilizzare Pub/Sub, seleziona Cloud Pub/Sub e inserisci il nome dell'argomento.

    3. (Facoltativo) Per ricevere oggetti evento in più endpoint o funzioni, vai a Impostazioni di connessione > Trigger e fornisci o aggiorna le funzioni di callback per i seguenti trigger di Chat:

      • Aggiunta allo spazio: un utente aggiunge l'app Chat a una conversazione di gruppo o a uno spazio oppure installa l' app Chat per i messaggi 1:1.
      • Messaggio: un utente invia un messaggio all' app Chat. Ad esempio, invia un messaggio diretto all'app Chat o la menziona con @nell' app Chat in uno spazio con più persone.
      • Rimozione dallo spazio: un utente disinstalla o rimuove l' app Chat da uno spazio.
      • Comando dell'app: un utente utilizza un comando rapido o un comando slash dall' app Chat.

    4. (Facoltativo) Aggiungi altre funzionalità interattive, come comandi rapidi, comandi slash, o anteprime dei link.

    5. In Visibilità, specifica la tua email in modo da poter installare e testare l'app Chat prima di pubblicarla su Google Workspace Marketplace. Puoi specificare fino a cinque persone o uno o più Gruppi Google della tua organizzazione Google Workspace.

  4. (Facoltativo) In Log, seleziona la casella di controllo Registra errori in Logging per utilizzare Google Cloud Logging. Per maggiori informazioni, consulta Eseguire query sui log degli errori per le app Chat nella documentazione dell'API Chat.

  5. Fai clic su Salva.

Dopo aver salvato la configurazione, chiunque tu abbia specificato nell' impostazione Visibilità dell'API Chat può installare, testare o utilizzare l' app Chat. Per iniziare a testare ed eseguire il debug della tua app Chat, consulta Testare le funzionalità interattive per le app Google Chat nella documentazione dell'API Chat.

Considerazioni per i componenti aggiuntivi di Google Workspace esistenti

Le app Chat richiedono una configurazione diversa rispetto ai componenti aggiuntivi di Google Workspace che estendono altre applicazioni di Google Workspace. Se il componente aggiuntivo estende altre applicazioni di Google Workspace, tieni presente i seguenti requisiti per la configurazione dell'app Chat:

  • Sia le persone che gli amministratori di Google Workspace devono essere in grado di installare il componente aggiuntivo da Marketplace. Configura queste impostazioni di installazione nell'SDK di Google Workspace Marketplace.
  • Le app Chat non utilizzano il nome e il logo che configuri per altre applicazioni di Google Workspace nell'oggetto addons.common del manifest.
  • Per i componenti aggiuntivi pubblicati su Google Workspace Marketplace, non puoi salvare una bozza delle modifiche alle impostazioni di configurazione dell'API Google Chat. Dopo aver aggiornato e salvato le impostazioni di configurazione dell'API Chat, l'app Chat aggiornata è disponibile per tutti gli utenti esistenti. Per aggiornare la scheda di Marketplace, puoi creare una bozza prima di inviare le modifiche.

  • Se hai creato il componente aggiuntivo utilizzando Apps Script:

  • Se hai creato il componente aggiuntivo utilizzando un servizio HTTP, ometti tutti i dettagli di configurazione dell'app Chat nel manifest e nei deployment che crei utilizzando l'API dei componenti aggiuntivi di Google Workspace. I deployment HTTP che specifichi nell'SDK di Google Workspace Marketplace vengono utilizzati solo per altre applicazioni di Google Workspace.