Questa pagina è stata tradotta dall'API Cloud Translation.

Estendi Google Chat

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 le seguenti operazioni:

Visualizza in anteprima i link dai messaggi della chat ed esegui azioni senza uscire dalla conversazione.
Automatizza o esegui attività nelle applicazioni Google Workspace.
Ricevi avvisi o notifiche su strumenti o servizi 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 fare quanto segue:

Invia messaggi contenenti testo, schede ed elementi interattivi dell'interfaccia utente.
Rispondi ai comandi rapidi.
Rispondere ai comandi slash.
Apri finestre di dialogo per aiutare gli utenti a completare processi in più fasi, come la compilazione di dati nei moduli.
Link di anteprima nei messaggi allegando schede con informazioni utili che consentono agli utenti di intraprendere azioni direttamente dalla conversazione.

Per iniziare a creare componenti aggiuntivi di Google Workspace che funzionino in Chat, consulta la seguente documentazione:

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 come puoi creare interfacce di chat utilizzando trigger aggiuntivi, azioni e oggetti evento.

Le seguenti funzionalità di chat e dei componenti aggiuntivi non sono disponibili:

Le architetture dell'app Chat Dialogflow, Pub/Sub e AppSheet non sono disponibili. In alternativa, è necessario creare l'app Chat utilizzando Apps Script o un servizio HTTP.
Servizio Card di Apps Script. Per utilizzare le azioni di chat e creare schede, restituisci invece oggetti JSON. Per alcuni esempi, vedere Aprire finestre di dialogo interattive e 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 componente aggiuntivo, la home page verrà visualizzata solo nella barra laterale delle altre applicazioni Google Workspace estese dal componente aggiuntivo.
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 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. Tutte le impostazioni di visibilità o di test configurate nell'SDK di Google Workspace Marketplace verranno ignorate. Per distribuire una versione di prova del componente aggiuntivo in Chat, consulta Testare le funzionalità interattive per le app di Google Chat nella documentazione dell'API di Chat.
Se i tuoi componenti aggiuntivi sono pubblicati su Google Workspace Marketplace, non puoi salvare una bozza delle modifiche apportate alle impostazioni di configurazione dell'API di 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.