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 effectuez des actions 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 des services externes ;
Fonctionnement des modules complémentaires Google Workspace dans Chat
Dans Chat, les modules complémentaires apparaissent aux utilisateurs comme des applications Google Chat. Pour interagir avec les utilisateurs, les applications Chat peuvent effectuer les actions suivantes:
- Envoyer des messages contenant du texte, des fiches et des éléments d'interface utilisateur interactifs
- Répondez 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 joignant 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 compatibles avec 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 module complémentaire.
Limites et problèmes connus
Les fonctionnalités Chat et les modules complémentaires suivants ne sont pas disponibles:
- Dialogflow et Pub/Sub Vous devez créer des modules complémentaires qui étendent Chat à l'aide d'Apps Script ou d'un service HTTP.
- Service Card d'Apps Script Pour utiliser les actions Chat et créer des fiches, renvoyez plutôt des objets JSON. Pour obtenir des exemples, consultez les sections Ouvrir des boîtes de dialogue interactives et Aperçu des liens.
- Cartes d'autorisation personnalisées Pour authentifier et autoriser votre service 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 n'apparaît que dans la barre latérale des autres applications Google Workspace que votre module complémentaire étend.
- Pages d'accueil de l'application 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 permettre aux utilisateurs et aux administrateurs Google Workspace d'installer le module complémentaire.
- Tous les paramètres de configuration courants du fichier manifeste (
addons.common) du module complémentaire sont ignorés dans Chat. Pour configurer le module complémentaire pour 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. - Si vous créez une application avec un service HTTP, vous devez activer l'API Google Workspace Add-ons. Les ressources REST
deploymentetprojectne s'appliquent qu'aux déploiements de modules complémentaires dans d'autres applications Google Workspace. - 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 de test du module complémentaire dans Chat, consultez la section Tester les fonctionnalités interactives pour les applications Google Chat dans la documentation de l'API Chat.
- Si vos modules complémentaires sont publiés sur Google Workspace Marketplace, vous ne pouvez pas enregistrer de brouillon de 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 mettre à jour votre fiche Marketplace, vous pouvez créer un brouillon avant d'envoyer les modifications.