Questa pagina fornisce una panoramica su come creare componenti aggiuntivi di Google Workspace che estendono Google Chat.
I componenti aggiuntivi di Google Workspace che estendono Chat possono aiutare gli utenti a svolgere una delle seguenti operazioni:
- Visualizza l'anteprima dei link dai messaggi di Chat e intraprendi azioni senza uscire dalla conversazione.
- Automatizza o esegui attività nelle applicazioni Google Workspace.
- Ricevere avvisi o notifiche su servizi o strumenti esterni.
Come funzionano i componenti aggiuntivi di Google Workspace in Chat
In Chat, gli utenti vedono i componenti aggiuntivi come app Google Chat. Per interagire con gli utenti, le app di chat possono:
- Inviare messaggi che contengono testo, schede ed elementi dell'interfaccia utente interattivi.
- Rispondere ai comandi rapidi.
- Rispondere ai comandi slash.
- Apri dialoghi per aiutare gli utenti a completare procedure in più passaggi, come la compilazione dei dati del modulo.
- Link di anteprima nei messaggi allegando schede con informazioni utili che consentono agli utenti di intraprendere azioni direttamente dalla conversazione.
Inizia
Per iniziare a creare componenti aggiuntivi di Google Workspace che funzionano in Chat, consulta la documentazione seguente:
- Prova una guida rapida per creare un'app Chat di base utilizzando Google Apps Script o un servizio HTTP.
- Configura un'app di chat e le relative funzionalità interattive utilizzando l'API Chat.
- Scopri i modi in cui puoi creare interfacce di chat utilizzando trigger, azioni e oggetti evento dei componenti aggiuntivi.
Limitazioni e problemi noti
Le seguenti funzionalità di chat e dei componenti aggiuntivi non sono disponibili:
- Le architetture dell'app di chat Dialogflow, Pub/Sub e AppSheet non sono disponibili. Devi invece creare l'app Chat utilizzando Apps Script o un servizio HTTP.
- Servizio schede di Apps Script. Per utilizzare le azioni della chat e creare schede, restituisci invece oggetti JSON. Per esempi, vedi Apri finestre di dialogo interattive e Visualizza l'anteprima dei link.
- Schede di autorizzazione personalizzate. Per autenticare e concedere l'autorizzazione al tuo servizio da Chat, l'app Chat deve restituire una scheda di autorizzazione di base.
- Home page dei componenti aggiuntivi nella barra laterale di Chat. Se hai configurato un trigger della home page per il tuo componente aggiuntivo, la home page viene visualizzata solo nella barra laterale delle altre applicazioni Google Workspace che il tuo componente aggiuntivo estende.
- Home page delle app di chat, che vengono visualizzate nella scheda Home dei messaggi diretti con l'app di chat.
Se stai aggiornando un componente aggiuntivo di Google Workspace esistente, tieni presente i seguenti requisiti di configurazione per le app di chat:
- Le impostazioni di installazione di Google Workspace Marketplace devono consentire sia ai singoli utenti sia agli amministratori di Google Workspace di installare il componente aggiuntivo.
- Tutte le impostazioni di configurazione comuni nel
manifest
del componente aggiuntivo (
addons.common) vengono ignorate in Chat. Per configurare il componente aggiuntivo in modo che funzioni in Chat, devi abilitare e configurare l'API Chat. Per i passaggi, vedi Configurare un'app Google Chat. - Per eseguire il deployment e testare un componente aggiuntivo in Chat, devi utilizzare l'impostazione Visibilità dell'API Chat. Vengono ignorate tutte le impostazioni di visibilità o di test che hai configurato nell'SDK di Google Workspace Marketplace. Per eseguire il deployment di una versione di test del componente aggiuntivo in Chat, consulta Testare le funzionalità interattive per le app Google Chat nella documentazione dell'API Chat.
- Se i tuoi componenti aggiuntivi sono pubblicati su Google Workspace Marketplace, non puoi salvare una bozza delle modifiche alle impostazioni di configurazione dell'API Google Chat. Quando aggiorni le impostazioni di configurazione dell'API Chat, l'app Chat aggiornata è immediatamente disponibile per tutti gli utenti esistenti. Per aggiornare la tua scheda del Marketplace, puoi creare una bozza prima di inviare le modifiche.