Cette page explique comment créer des modules complémentaires Google Workspace qui étendent Google Chat.
Les modules complémentaires Google Workspace qui étendent Chat peuvent aider les utilisateurs à effectuer les actions suivantes :
- Prévisualisez les liens des messages Chat et agissez sans quitter la conversation.
- Automatisez ou effectuez des tâches dans les applications Google Workspace.
- Recevoir des alertes ou des notifications concernant des outils ou services externes
Fonctionnement des modules complémentaires Google Workspace dans Chat
Dans Chat, les modules complémentaires sont présentés aux utilisateurs en tant qu'applications Google Chat. Pour interagir avec les utilisateurs, les applications Chat peuvent effectuer les actions suivantes :
- Envoyez des messages contenant du texte, des fiches et des éléments d'interface utilisateur interactifs.
- Répondre aux commandes rapides.
- Répondre aux commandes à barre oblique
- Ouvrez des boîtes de dialogue pour aider les utilisateurs à effectuer des processus en plusieurs étapes, comme remplir des données de formulaire.
- Affichez un aperçu des liens dans les messages en ajoutant des fiches contenant des informations utiles qui permettent aux utilisateurs d'effectuer des actions directement depuis la conversation.
Commencer
Pour commencer à créer des modules complémentaires Google Workspace fonctionnant dans Chat, consultez la documentation suivante :
- Essayez un guide de démarrage rapide pour créer une application Chat de base à l'aide de Google Apps Script ou d'un service HTTP.
- Configurez une application Chat et ses fonctionnalités interactives à l'aide de l'API Chat.
- Découvrez comment créer des interfaces Chat à l'aide de déclencheurs, d'actions et d'objets d'événement de modules complémentaires.
Limites et problèmes connus
Les fonctionnalités de chat et de modules complémentaires suivantes ne sont pas disponibles :
- Les architectures d'applications Chat Dialogflow, Pub/Sub et AppSheet ne sont pas disponibles. Vous devez plutôt créer l'application Chat à l'aide d'Apps Script ou d'un service HTTP.
- Service Card d'Apps Script. Pour utiliser les actions de chat et créer des fiches, renvoyez plutôt des objets JSON. Pour obtenir des exemples, consultez Ouvrir des boîtes de dialogue interactives et Prévisualiser des liens.
- Cartes d'autorisation personnalisées Pour authentifier votre service et lui accorder l'autorisation depuis Chat, l'application Chat doit renvoyer une fiche d'autorisation de base.
- Pages d'accueil des modules complémentaires dans la barre latérale de Chat. Si vous avez configuré un déclencheur de page d'accueil pour votre module complémentaire, la page d'accueil ne s'affiche que dans la barre latérale des autres applications Google Workspace que votre module complémentaire étend.
- Les pages d'accueil des applications Chat, qui s'affichent dans l'onglet Accueil des messages privés avec l'application Chat.
Si vous mettez à jour un module complémentaire Google Workspace existant, 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 du module complémentaire (
addons.common) 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 connaître la procédure à suivre, consultez Configurer une application 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 du module complémentaire dans Chat, consultez Tester les fonctionnalités interactives des applications Google Chat dans la documentation de l'API 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, la nouvelle application Chat est immédiatement disponible pour tous les utilisateurs existants. Pour mettre à jour votre fiche Marketplace, vous pouvez créer un brouillon avant d'envoyer les modifications.