Questa pagina spiega come creare una home page per i messaggi diretti con la tua app Google Chat. Una home page, indicata come home page dell'app nell'API Google Chat, è un'interfaccia di schede personalizzabile visualizzata nella scheda Home degli spazi dei messaggi diretti tra un utente e un'app di Chat.
Puoi utilizzare la home page dell'app per condividere suggerimenti sull'interazione con o consentire agli utenti di accedere a un'app servizio o strumento esterno da Chatta.
Utilizza lo strumento per la creazione di schede per progettare e visualizzare l'anteprima di interfacce utente e messaggistica per le app di chat:
Apri il generatore di schedePrerequisiti
Node.js
Un'app di Google Chat abilitata per le funzionalità interattive. Per creare un app di Chat interattiva utilizzando un servizio HTTP, completa questa guida rapida.
Python
Un'app di Google Chat abilitata per le funzionalità interattive. Per creare un'app Chat interattiva utilizzando un servizio HTTP, completa questa guida rapida.
Java
Un'app di Google Chat abilitata per le funzionalità interattive. Per creare un'app Chat interattiva utilizzando un servizio HTTP, completa questa guida rapida.
Apps Script
Un'app Google Chat per cui sono abilitate le funzionalità interattive. Per creare un'app Chat interattiva in Apps Script, completa questa guida rapida.
Configurare la home page dell'app per l'app Chat
Per supportare la home page dell'app, devi configurare l'app Chat
per ricevere
APP_HOME
eventi di interazione,
L'app Chat riceve questo evento ogni volta che un utente
fa clic sulla scheda Home da un messaggio diretto con
App Chat.
Per aggiornare le impostazioni di configurazione nella console Google Cloud, segui questi passaggi:
Nella console Google Cloud, vai a Menu > Altri prodotti > Google Workspace > Libreria di prodotti > API Google Chat.
Fai clic su Gestisci, quindi sulla scheda Configurazione.
In Funzionalità interattive, vai alla sezione Funzionalità per configura la home page dell'app:
- Seleziona la casella di controllo Ricevi messaggi 1:1.
- Seleziona la casella di controllo Support App Home.
Se l'app Chat utilizza un servizio HTTP, vai a Impostazioni di connessione e specifica un endpoint per Campo URL della home page dell'app. Puoi utilizzare lo stesso URL specificato nel campo URL endpoint HTTP.
Fai clic su Salva.
Crea una scheda Home dell'app
Quando un utente apre la home page dell'app, la tua app Chat deve gestire
l'evento di interazione APP_HOME
restituendo un'istanza di
RenderActions
con la navigazione pushCard
e un
Card
. Per creare un
un'esperienza interattiva, la scheda può contenere widget interattivi, come pulsanti
o input di testo che l'app di chat è in grado di elaborare
rispondi con altre schede o una finestra di dialogo.
Nell'esempio seguente, l'app Chat mostra una scheda iniziale della home page dell'app che mostra l'ora di creazione della scheda e un pulsante. Quando un utente fa clic sul pulsante, l'app Chat restituisce una scheda aggiornata che mostra l'ora in cui è stata creata.
Node.js
Python
Java
Apps Script
Implementa la funzione onAppHome
che viene chiamata dopo tutti gli eventi di interazione APP_HOME
:
Questo esempio invia un messaggio di una scheda restituendo JSON card. Puoi utilizzare anche Servizio di schede Apps Script.
Rispondere alle interazioni con la home page dell'app
Se la scheda iniziale dell'app contiene widget interattivi, come pulsanti o input di selezione, l'app di chat deve gestire gli eventi di interazione correlati restituendo un'istanza di RenderActions
con la navigazione updateCard
. Per scoprire di più sulla gestione dei widget interattivi, consulta la sezione Elaborare le informazioni inserite dagli utenti.
Nell'esempio precedente, la scheda Home dell'app iniziale includeva un pulsante. Ogni volta che un utente fa clic sul pulsante, un evento di interazione CARD_CLICKED
attiva la funzione updateAppHome
per aggiornare la scheda della casa dell'app, come mostrato nel codice seguente:
Node.js
Python
Java
Apps Script
Questo esempio invia un messaggio di una scheda restituendo JSON card. Puoi anche utilizzare il servizio di schede di Apps Script.
Aprire finestre di dialogo
L'app Chat può anche rispondere alle interazioni nella home page dell'app aprendo le finestre di dialogo.
Per aprire una finestra di dialogo dalla home page dell'app, elabora l'evento di interazione correlato restituendo renderActions
con la navigazione updateCard
contenente un oggetto Card
. Nel seguente esempio, un'app di Chat risponde a un clic sul pulsante di una scheda della home page dell'app elaborando l'evento di interazione CARD_CLICKED
e aprendo una finestra di dialogo:
{ renderActions: { action: { navigations: [{ updateCard: { sections: [{
header: "Add new contact",
widgets: [{ "textInput": {
label: "Name",
type: "SINGLE_LINE",
name: "contactName"
}}, { textInput: {
label: "Address",
type: "MULTIPLE_LINE",
name: "address"
}}, { decoratedText: {
text: "Add to favorites",
switchControl: {
controlType: "SWITCH",
name: "saveFavorite"
}
}}, { decoratedText: {
text: "Merge with existing contacts",
switchControl: {
controlType: "SWITCH",
name: "mergeContact",
selected: true
}
}}, { buttonList: { buttons: [{
text: "Next",
onClick: { action: { function: "openSequentialDialog" }}
}]}}]
}]}}]}}}
Per chiudere una finestra di dialogo, elabora i seguenti eventi di interazione:
CLOSE_DIALOG
: chiude la finestra di dialogo e torna alla scheda iniziale della casa dell'app Chat.CLOSE_DIALOG_AND_EXECUTE
: chiude la finestra di dialogo e aggiorna la home page dell'app .
Il seguente esempio di codice utilizza CLOSE_DIALOG
per chiudere una finestra di dialogo e tornare a
scheda della home page dell'app:
{ renderActions: { action: {
navigations: [{ endNavigation: { action: "CLOSE_DIALOG" }}]
}}}
Per raccogliere informazioni dagli utenti, puoi anche creare dialoghi sequenziali. A per imparare a creare finestre di dialogo sequenziali, consulta Apri e rispondi alle finestre di dialogo.
Argomenti correlati
- Visualizza esempi di app di Chat che utilizzano la home page dell'app.
- Aprire e rispondere alle finestre di dialogo.