Cette page explique comment créer une application Google Chat interactive. Les applications Chat interactives sont créées en tant que modules complémentaires Google Workspace qui étendent Google Chat.
Les applications Chat interactives permettent aux utilisateurs d'effectuer les opérations suivantes :
- Ajouter des applications Chat à des espaces Chat ou à des messages privés.
- Envoyer des messages à des applications Chat contenant du texte, des fiches et des éléments d'interface utilisateur interactifs, ou en recevoir de leur part.
- Afficher une fiche Accueil de l'application et interagir avec dans l'onglet Accueil des messages privés avec l'application Chat.
- Envoyer une commande aux applications de chat à l'aide de commandes à barre oblique, de commandes rapides ou d'actions sur les messages.
- Prévisualisez les liens dans les messages de chat et passez à l'action sans quitter la conversation.
- Envoyer des informations aux applications Chat, par exemple en saisissant du texte dans une boîte de dialogue ou un message de fiche.
- Automatiser ou effectuer des tâches dans les applications Google Workspace et se connecter à des outils ou services externes.
Comment les utilisateurs découvrent et utilisent les applications Chat interactives
Dans Chat, les modules complémentaires qui étendent les fonctionnalités de Chat sont présentés aux utilisateurs en tant qu'applications Google Chat. Les utilisateurs peuvent découvrir et utiliser les applications Chat publiées sur la Marketplace de différentes manières, y compris les suivantes :
- Rechercher et installer des applications Chat depuis Google Chat ou Marketplace.
- Interagissez avec une application Chat ajoutée à un espace Chat.
- Découvrir l'application Chat dans le panneau des messages privés après qu'un administrateur Google Workspace l'a installée pour eux.
Pour commencer à utiliser une application Chat, les utilisateurs de Google Chat peuvent envoyer un message privé à l'application Chat ou l'ajouter à un espace. Les utilisateurs peuvent également ajouter l'application Chat en la mentionnant avec @. Pour en savoir plus, consultez Utiliser des applications Chat.
L'exemple suivant montre comment un utilisateur @mentionne une application Chat pour l'ajouter à un espace :
Commencer
Pour commencer à créer une application Chat interactive, consultez la documentation suivante :
- Configurez l'API Google Chat et activez les fonctionnalités interactives pour votre application Chat.
- Découvrez comment recevoir des interactions utilisateur et y répondre à l'aide de déclencheurs, d'objets d'événement et d'actions.
- Essayez un guide de démarrage rapide pour créer une application Chat de base pour l'architecture d'application Google Chat de votre choix.
Configurer et créer une application Chat de base
Le tableau suivant liste la documentation permettant de configurer l'API Chat et de créer une application Chat interactive de base pour chaque architecture d'application Google Chat :
| Architecture ou tâche | Guide |
|---|---|
| Configurer l'API Chat | Configurer l'API Google Chat |
| Guides de démarrage rapide | |
| Apps Script | Créer une application Chat avec Apps Script |
| Service HTTP (fonctions Cloud Run) | Créer une application Chat HTTP |
| Pub/Sub | Créer une application Chat avec Pub/Sub |
| Dialogflow CX | Créer une application Chat Dialogflow CX |
| Dialogflow ES | Créer une application Chat Dialogflow ES |
| Agent d'IA Agent Development Kit (ADK) | Créer une application Chat d'agent IA ADK |
| Agent d'IA Agent2Agent (A2A) | Créer une application de chat avec un agent IA A2A |
| Agent IA A2UI | Créer une application de chat d'agent d'IA A2UI |
| Agent IA Gemini Enterprise | Créer une application de chat d'agent d'IA Gemini Enterprise |
Créer des fonctionnalités interactives
Le tableau suivant présente la documentation pour créer des fonctionnalités interactives dans les applications Chat :
| Fonctionnalité | Guide |
|---|---|
| Recevoir des interactions utilisateur et y répondre | Recevoir des interactions utilisateur et y répondre |
| Envoyer des messages (répondre à des interactions ou envoyer des messages de manière proactive) | Répondre avec un message ou envoyer un message à l'aide de l'API Chat |
| Répondre aux commandes à barre oblique, aux commandes rapides et aux actions sur les messages | Répondre aux commandes |
| Créer des boîtes de dialogue interactives | Ouvrir des boîtes de dialogue interactives |
| Collecter et traiter des informations à partir de cartes et de boîtes de dialogue | Lire les données de formulaire saisies par les utilisateurs sur les cartes |
| Prévisualiser les liens dans les messages Chat | Liens d'aperçu |
| Créer une page d'accueil (App Home) dans les messages privés | Créer une page d'accueil pour une application Chat |
| Se connecter à des systèmes et outils externes | Associer une application Chat à d'autres services et outils |
Limites et points à prendre en compte pour les modules complémentaires Google Workspace
Étant donné que les applications Chat sont créées en tant que modules complémentaires Google Workspace qui étendent Chat, gardez à l'esprit les limites de fonctionnalités suivantes :
- L'architecture de l'application Chat AppSheet n'est pas disponible lorsque vous la créez en tant que module complémentaire Google Workspace. Créez plutôt l'application Chat à l'aide d'un service HTTP, d'Apps Script, de Dialogflow ES, de Dialogflow CX ou de Pub/Sub.
- Les cartes d'autorisation personnalisées ne sont pas acceptées dans Chat. Pour authentifier votre service et lui accorder l'autorisation depuis Chat, l'application Chat doit renvoyer une fiche d'autorisation de base.
- Les pages d'accueil des modules complémentaires dans la barre latérale de Chat ne sont pas prises en charge. Si vous avez configuré un déclencheur de page d'accueil dans votre fichier manifeste (
addons.common.homepageTrigger), la page d'accueil n'apparaît que dans la barre latérale des autres applications Google Workspace que votre module complémentaire étend. Vous pouvez plutôt créer une page d'accueil pour une application Chat qui s'affiche dans l'onglet Accueil des messages privés (1:1) avec l'application Chat.
Si vous étendez un module complémentaire Google Workspace existant pour qu'il fonctionne dans Chat, tenez compte des exigences de configuration suivantes pour les applications Chat :
- Les paramètres d'installation de Google Workspace Marketplace doivent autoriser les particuliers et les administrateurs Google Workspace à installer le module complémentaire.
- Tous les paramètres de configuration courants du manifeste (
addons.common) du module complémentaire sont ignorés dans Chat. Pour configurer le module complémentaire afin qu'il fonctionne dans Chat, vous devez activer et configurer l'API Chat. Pour en savoir plus, consultez Configurer l'API Google Chat. - Pour déployer et tester un module complémentaire dans Chat, vous devez utiliser le paramètre Visibilité de l'API Chat. Tous les paramètres de visibilité ou de test que vous avez configurés dans le SDK Google Workspace Marketplace sont ignorés. Pour déployer une version test de l'application dans Chat, consultez Tester les fonctionnalités interactives des applications Google Chat.
- Si votre module complémentaire est publié sur Google Workspace Marketplace, vous ne pouvez pas enregistrer de brouillon des modifications apportées aux paramètres de configuration de l'API Google Chat. Lorsque vous mettez à jour les paramètres de configuration de l'API Chat, l'application Chat mise à jour est immédiatement disponible pour tous les utilisateurs existants. Pour modifier votre fiche Marketplace, vous pouvez créer un brouillon avant d'envoyer les modifications.
Articles associés
- Présentation de la documentation de l'API Google Chat
- Recevoir des interactions utilisateur et y répondre
- Choisir une architecture d'application Google Chat
- Essayez un exemple :
- Planifier des réunions depuis Google Chat
- Intégrer des concepts d'IA fondamentaux dans les applications Chat
- Planifier des voyages avec un agent IA accessible dans Google Workspace
- Créez des agents Gemini Enterprise étroitement intégrés aux datastores, aux API et aux applications de chat Workspace.
- Créez des agents Vertex AI étroitement intégrés aux datastores, aux API et aux applications Chat de Workspace.
Applications Chat qui ne sont pas des modules complémentaires : créer une application Google Chat interactive
Les applications Chat qui ne sont pas des modules complémentaires Google Workspace sont conçues comme des applications Chat uniquement qui reçoivent des événements d'interaction de l'API Chat (Event) au lieu d'objets d'événement de module complémentaire Google Workspace (EventObject) et d'actions.
Si vous gérez une application Chat qui n'est pas un module complémentaire, vous pouvez :
- Convertissez votre application Chat qui n'est pas un module complémentaire en module complémentaire Google Workspace qui étend Google Chat. Consultez Convertir une application Google Chat en module complémentaire Google Workspace.
- Consultez les sections développables Applications de chat qui ne sont pas des modules complémentaires en bas de chaque guide des fonctionnalités interactives de cet ensemble de documentation pour connaître les formats des requêtes et des réponses.