Cette page explique comment créer une page d'accueil pour les messages privés avec votre application Google Chat. Une page d'accueil, appelée accueil de l'application dans l'API Google Chat, est une interface de fiche personnalisable qui s'affiche dans l'onglet Accueil des espaces de messages privés entre un utilisateur et une application Chat.
Contrairement aux autres applications hôtes Google Workspace, les modules complémentaires qui étendent Chat n'affichent pas de page d'accueil dans le panneau d'accès rapide de droite et n'utilisent pas addOns.common.homepageTrigger dans le fichier manifeste.
En revanche, Chat affiche votre page d'accueil sous forme de fiche dans l'onglet Accueil d'un message privé (1:1) avec l'application Chat. Elle est configurée dans la console Google Cloud.
Vous pouvez utiliser l'accueil de l'application pour partager des conseils sur l'interaction avec l'application Chat, afficher un tableau de bord utilisateur personnalisé ou permettre aux utilisateurs d'accéder à un service ou outil externe et de le configurer depuis Chat.
Utilisez Card Builder pour concevoir et prévisualiser les messages et les interfaces utilisateur des applications Chat :
Ouvrez le générateur de cartes.Prérequis
HTTP
Application Google Chat qui reçoit les interactions utilisateur et y répond. Pour en créer un, suivez le guide de démarrage rapide HTTP.
Apps Script
Application Google Chat qui reçoit les interactions utilisateur et y répond. Pour en créer un, suivez le guide de démarrage rapide Apps Script.
Configurer l'accueil de l'application pour votre application Chat
Pour prendre en charge la page d'accueil de l'application, activez l'option Support App Home (Prendre en charge la page d'accueil de l'application) et configurez le déclencheur App home (Page d'accueil de l'application) dans la console Google Cloud. Votre application Chat reçoit un événement de déclenchement Accueil de l'application chaque fois qu'un utilisateur ouvre l'onglet Accueil dans un message privé avec l'application Chat.
Pour configurer la page d'accueil de l'application dans la console Google Cloud :
Dans la console Google Cloud, accédez à Menu > API et services > API et services activés > API Google Chat > Configuration.
Sous Fonctionnalités interactives, assurez-vous que l'option Activer les fonctionnalités interactives est activée, puis sous Fonctionnalité, cochez la case Accueil de l'application d'assistance.
Sous Paramètres de connexion > Déclencheurs, spécifiez votre gestionnaire App Home dans le champ App Home en fonction de l'architecture de votre application de chat :
- HTTP : saisissez l'URL du point de terminaison HTTPS qui gère les requêtes de la page d'accueil de l'application (ou sélectionnez Utiliser une URL de point de terminaison HTTP commune pour tous les déclencheurs afin que votre URL de point de terminaison HTTP commune reçoive tous les événements).
- Google Apps Script : saisissez le nom de la fonction de rappel Google Apps Script qui crée et renvoie la fiche de votre page d'accueil (la valeur par défaut est
onAppHome).
Cliquez sur Enregistrer.
Gérer l'objet d'événement App Home
Lorsqu'un utilisateur ouvre l'onglet Accueil d'un message privé avec votre application Chat, Chat envoie un objet d'événement à votre point de terminaison ou fonction de rappel de l'accueil de l'application.
Contrairement aux événements d'interaction avec un espace ou un message, l'objet d'événement initial de l'accueil de l'application n'inclut pas de charge utile d'interaction d'union (telle que messagePayload). Il contient les champs suivants :
commonEventObject: inclutclientPlatform,hostApp("CHAT"),userLocaleetuserTimezone.chat.user: utilisateur Chat ayant ouvert l'onglet Accueil.chat.eventTime: code temporel indiquant le moment où l'utilisateur a ouvert l'onglet Accueil.
Créer une carte App Home
Lorsqu'un utilisateur ouvre l'onglet Accueil, gérez l'événement de déclenchement Accueil de l'application en renvoyant un objet RenderActions avec une action de navigation pushCard et un Card. Pour créer une expérience interactive, la fiche peut contenir des widgets interactifs tels que des boutons ou des champs de saisie de texte.
HTTP
{
"action": {
"navigations": [
{
"pushCard": {
"header": {
"title": "Welcome to App Home"
},
"sections": [
{
"widgets": [
{
"textParagraph": {
"text": "Manage your settings and view your dashboard here."
}
},
{
"buttonList": {
"buttons": [
{
"text": "Refresh",
"onClick": {
"action": {
"function": "https://example.com/updateAppHome"
}
}
}
]
}
}
]
}
]
}
}
]
}
}
Apps Script
/**
* Builds and returns the App Home card when a user opens the Home tab.
*
* @param {Object} event The event object from Google Chat.
* @return {ActionResponse} The RenderActions response pushing the homepage card.
*/
function onAppHome(event) {
const card = CardService.newCardBuilder()
.setHeader(
CardService.newCardHeader().setTitle('Welcome to App Home'))
.addSection(
CardService.newCardSection()
.addWidget(
CardService.newTextParagraph().setText(
'Manage your settings and view your dashboard here.'))
.addWidget(
CardService.newButtonSet().addButton(
CardService.newTextButton()
.setText('Refresh')
.setOnClickAction(
CardService.newAction().setFunctionName(
'updateAppHome')))))
.build();
return CardService.newActionResponseBuilder()
.setNavigation(CardService.newNavigation().pushCard(card))
.build();
}
Répondre aux interactions avec l'accueil de l'application
Si la carte de votre application contient des widgets interactifs, tels que des boutons ou des champs de formulaire, un clic sur un bouton envoie un objet d'événement contenant chat.buttonClickedPayload (ainsi que commonEventObject.parameters et commonEventObject.formInputs) à la fonction ou au point de terminaison d'action configurés du bouton.
Pour mettre à jour la fiche "Accueil de l'application" en réponse à une interaction de l'utilisateur, renvoyez un objet RenderActions avec une action de navigation updateCard. Pour en savoir plus sur la lecture des entrées de formulaire à partir de widgets interactifs, consultez Lire les données de formulaire saisies par les utilisateurs sur les fiches.
HTTP
{
"action": {
"navigations": [
{
"updateCard": {
"header": {
"title": "Welcome to App Home"
},
"sections": [
{
"widgets": [
{
"textParagraph": {
"text": "Last updated: 2026-10-02T23:00:00Z"
}
}
]
}
]
}
}
]
}
}
Apps Script
/**
* Updates the App Home card when a user clicks the Refresh button.
*
* @param {Object} event The event object from Google Chat.
* @return {ActionResponse} The RenderActions response updating the homepage card.
*/
function updateAppHome(event) {
const updatedCard = CardService.newCardBuilder()
.setHeader(
CardService.newCardHeader().setTitle('Welcome to App Home'))
.addSection(
CardService.newCardSection().addWidget(
CardService.newTextParagraph().setText(
'Last updated: ' + new Date().toTimeString())))
.build();
return CardService.newActionResponseBuilder()
.setNavigation(CardService.newNavigation().updateCard(updatedCard))
.build();
}
Ouvrir des boîtes de dialogue depuis l'accueil de l'application
Votre application Chat peut également répondre aux interactions dans l'accueil de l'application en ouvrant des boîtes de dialogue.
Pour savoir comment ouvrir, mettre à jour et fermer des boîtes de dialogue à l'aide de RenderActions (pushCard, updateCard et endNavigation: "CLOSE_DIALOG"), consultez Ouvrir des boîtes de dialogue interactives.
Articles associés
- Recevoir des interactions utilisateur et y répondre
- Ouvrir des boîtes de dialogue interactives
- Lire les données de formulaire saisies par les utilisateurs sur les cartes
- Afficher des exemples d'applications Chat
Applications Chat qui ne sont pas des modules complémentaires : créer une page d'accueil pour une application Chat
Si vous gérez une application Chat qui n'est pas un module complémentaire Google Workspace, Chat envoie un événement d'interaction APP_HOME lorsqu'un utilisateur ouvre l'onglet Accueil, et envoie des événements d'interaction CARD_CLICKED ou SUBMIT_FORM lorsqu'un utilisateur interagit avec des widgets sur la fiche "Accueil de l'application".
Pour migrer une application Chat qui n'est pas un module complémentaire vers le framework de modules complémentaires Google Workspace, consultez Convertir une application Google Chat en module complémentaire Google Workspace.
Créer une fiche "Accueil de l'application" dans une application Chat qui n'est pas un module complémentaire
Dans une application Chat qui n'est pas un module complémentaire, gérez l'événement d'interaction APP_HOME en renvoyant une réponse contenant un champ renderActions de premier niveau avec la navigation pushCard :
Node.js
Python
Java
Apps Script
Cet exemple envoie un message de carte en renvoyant le code JSON de la carte. Vous pouvez également utiliser le service de cartes Apps Script.
Répondre aux interactions avec la page d'accueil de l'application dans une application Chat qui n'est pas un module complémentaire
Dans une application Chat qui n'est pas un module complémentaire, gérez les événements d'interaction CARD_CLICKED ou SUBMIT_FORM à partir d'une fiche d'accueil de l'application en renvoyant une réponse contenant un champ renderActions de premier niveau avec la navigation updateCard :
Node.js
Python
Java
Apps Script
Cet exemple envoie un message de carte en renvoyant le code JSON de la carte. Vous pouvez également utiliser le service de cartes Apps Script.