Questa pagina fornisce una panoramica su come creare un'app Google Chat interattiva. Le app di Chat interattive vengono create come componenti aggiuntivi di Google Workspace che estendono Google Chat.
Le app di chat interattive consentono agli utenti di:
- Aggiungere app di Chat a spazi di Chat o messaggi diretti.
- Invia o ricevi messaggi da app di chat che contengono testo, schede ed elementi dell'interfaccia utente interattivi.
- Visualizza e interagisci con una scheda Home app nella scheda Home dei messaggi diretti 1:1 con l'app Chat.
- Chiedi alle app di chat di utilizzare comandi slash, comandi rapidi o azioni dei messaggi.
- Visualizza l'anteprima dei link dei messaggi di Chat e intraprendi azioni senza abbandonare la conversazione.
- Invia informazioni alle app di chat, ad esempio inserendo testo in una finestra di dialogo o in un messaggio di scheda.
- Automatizza o esegui attività nelle applicazioni Google Workspace e connettiti a strumenti o servizi esterni.
Come gli utenti scoprono e utilizzano le app di chat interattive
In Chat, i componenti aggiuntivi che estendono Chat vengono visualizzati dagli utenti come app Google Chat. Gli utenti possono scoprire e utilizzare le app di chat pubblicate sul Marketplace in molti modi, tra cui:
- Cerca e installa app di chat da Google Chat o dal Marketplace.
- Interagire con un'app di Chat aggiunta a uno spazio di Chat.
- Scoprire l'app di chat nel riquadro dei messaggi diretti dopo che un amministratore di Google Workspace l'ha installata per suo conto.
Per iniziare a utilizzare un'app di chat, gli utenti di Google Chat possono avviare un messaggio diretto con l'app di chat o aggiungerla a uno spazio. Gli utenti possono anche aggiungere l'app Chat menzionandola con @. Per saperne di più, vedi Utilizzare le app di chat.
L'esempio seguente mostra come un utente menziona un'app di chat per aggiungerla a uno spazio:
Inizia
Per iniziare a creare un'app Chat interattiva, consulta la seguente documentazione:
- Configura l'API Google Chat e attiva le funzionalità interattive per la tua app di chat.
- Scopri come ricevere e rispondere alle interazioni degli utenti utilizzando attivatori, oggetti evento e azioni.
- Prova una guida rapida per creare un'app di Chat di base per l'architettura dell'app Google Chat che preferisci.
Configura e crea un'app di chat di base
La tabella seguente elenca la documentazione per la configurazione dell'API Chat e la creazione di un'app di chat interattiva di base per ogni architettura dell'app Google Chat:
| Architettura o attività | Guida |
|---|---|
| Configurare l'API Chat | Configurare l'API Google Chat |
| Guide rapide | |
| Apps Script | Creare un'app di Chat con Apps Script |
| Servizio HTTP (Cloud Run Functions) | Creare un'app di chat HTTP |
| Pub/Sub | Creare un'app di chat con Pub/Sub |
| Dialogflow CX | Creare un'app di chat Dialogflow CX |
| Dialogflow ES | Creare un'app di chat Dialogflow ES |
| Agente AI Agent Development Kit (ADK) | Creare un'app di chat con un agente AI ADK |
| Agente AI Agent2Agent (A2A) | Creare un'app di chat con un agente AI A2A |
| Agente AI A2UI | Creare un'app di chat con agente AI A2UI |
| Agente AI Gemini Enterprise | Creare un'app di chat con un agente AI Gemini Enterprise |
Creare funzionalità interattive
La tabella seguente mostra la documentazione per la creazione di funzionalità interattive dell'app di chat:
| Funzionalità | Guida |
|---|---|
| Ricevere e rispondere alle interazioni degli utenti | Ricevere e rispondere alle interazioni degli utenti |
| Inviare messaggi (rispondere alle interazioni o inviarli in modo proattivo) | Rispondi con un messaggio o Invia un messaggio utilizzando l'API Chat |
| Rispondere a comandi slash, comandi rapidi e azioni sui messaggi | Rispondere ai comandi |
| Creare dialoghi interattivi | Aprire finestre di dialogo interattive |
| Raccogliere ed elaborare le informazioni da schede e finestre di dialogo | Leggere i dati inseriti dagli utenti nei moduli sulle schede |
| Visualizzare l'anteprima dei link nei messaggi di Chat | Link di anteprima |
| Creare una home page (Home app) nei messaggi diretti 1:1 | Creare una home page per un'app di chat |
| Connettersi a sistemi e strumenti esterni | Collegare un'app di chat ad altri servizi e strumenti |
Limitazioni e considerazioni per i componenti aggiuntivi di Google Workspace
Poiché le app di Chat sono create come componenti aggiuntivi di Google Workspace che estendono Chat, tieni presente le seguenti limitazioni delle funzionalità:
- AppSheet L'architettura dell'app di Chat non è disponibile quando la crei come componente aggiuntivo di Google Workspace. Crea invece l'app di chat utilizzando un servizio HTTP, Apps Script, Dialogflow ES, Dialogflow CX o Pub/Sub.
- Le schede di autorizzazione personalizzate non sono supportate in Chat. Per autenticare e concedere l'autorizzazione al tuo servizio da Chat, l'app di Chat deve restituire una scheda di autorizzazione di base.
- Le home page dei componenti aggiuntivi
nella barra laterale di Chat non sono supportate. Se hai configurato un
trigger della home page nel
manifest (
addons.common.homepageTrigger), la home page viene visualizzata solo nella barra laterale delle altre applicazioni Google Workspace che il componente aggiuntivo estende. In alternativa, puoi creare una home page per un'app di chat che viene visualizzata nella scheda Home dei messaggi diretti 1:1 con l'app di chat.
Se stai estendendo un componente aggiuntivo di Google Workspace esistente per farlo funzionare in Chat, 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.
- Eventuali impostazioni di configurazione comuni nel
manifest (
addons.common) del componente aggiuntivo vengono ignorate in Chat. Per configurare il componente aggiuntivo in modo che funzioni in Chat, devi attivare e configurare l'API Chat. Per una descrizione dei passaggi, vedi Configurare l'API Google Chat. - Per eseguire il deployment e testare un componente aggiuntivo in Chat, devi utilizzare l'impostazione Visibilità dell'API Chat. Qualsiasi impostazione di visibilità o di test configurata nell'SDK di Google Workspace Marketplace viene ignorata. Per eseguire il deployment di una versione di test del componente aggiuntivo in Chat, vedi Testare le funzionalità interattive per le app Google 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 di Chat aggiornata è immediatamente disponibile per tutti gli utenti esistenti. Per aggiornare la scheda del marketplace, puoi creare una bozza prima di inviare le modifiche.
Argomenti correlati
- Panoramica della documentazione dell'API Google Chat
- Ricevere e rispondere alle interazioni degli utenti
- Scegliere un'architettura dell'app Google Chat
- Prova un esempio:
- Pianificare riunioni da Google Chat
- Integrare concetti di base dell'AI nelle app di chat
- Pianificare i viaggi con un agente AI accessibile in Google Workspace
- Crea agenti Gemini Enterprise strettamente integrati con i datastore, le API e le app di chat di Workspace
- Crea agenti Vertex AI strettamente integrati con datastore, API e app di chat di Workspace
App di chat che non sono componenti aggiuntivi: crea un'app Google Chat interattiva
Le app di chat che non sono componenti aggiuntivi di Google Workspace vengono create come
app solo chat che ricevono
eventi di interazione dell'API Chat (Event)
anziché
oggetti evento dei componenti aggiuntivi di Google Workspace (EventObject)
e azioni.
Se gestisci un'app Chat che non è un componente aggiuntivo, puoi:
- Converti la tua app di Chat che non è un componente aggiuntivo in un componente aggiuntivo di Google Workspace che estende Google Chat. Consulta la sezione Convertire un'app di Google Chat in un componente aggiuntivo di Google Workspace.
- Per i formati di richiesta e risposta, consulta le sezioni espandibili App di chat che non sono componenti aggiuntivi nella parte inferiore di ogni guida alle funzionalità interattive in questo set di documentazione.