Configurer une application Google Chat

Cette page explique comment configurer et déployer une application Google Chat en tant que module complémentaire Google Workspace.

Pour déployer et tester un module complémentaire Google Workspace qui étend Chat, vous devez activer et configurer une application Chat à l'aide de l'API Google Chat. Les paramètres de configuration de l'API Chat vous permettent de spécifier tous les détails concernant l'application Chat, y compris le nom, l'avatar, le déploiement et les fonctionnalités interactives que vous souhaitez utiliser.

Prérequis

Choisir un nom à afficher, un avatar et une description pour votre application Chat

Le nom, l'avatar et la description de l'application Chat s'affichent pour les utilisateurs dans l'interface utilisateur Chat. Pour interagir avec les applications Chat, les utilisateurs voient ou utilisent ces informations de différentes manières :

  • Mentionnez l'application Chat avec un @ pour l'ajouter à un espace ou lui envoyer un message.
  • Recherchez l'application Chat et démarrez une conversation privée avec elle. Dans le menu Applications, les messages privés affichent le nom et l'avatar de l'application Chat.
  • Dans la barre de rédaction, les utilisateurs peuvent parcourir les applications Chat et voir leur nom, leur avatar et leur description.

Avant de configurer une application Chat, vous devez préparer les informations suivantes :

Champ Description Format
Nom de l'application Nom à afficher de l'application Chat. 25 caractères alphanumériques au maximum
URL de l'avatar Image qui s'affiche comme avatar de votre application Chat avatar. URL HTTPS pointant vers une image graphique carrée (PNG ou JPEG). La taille recommandée est de 256 x 256 pixels ou plus.
Description Brève description de l'objectif de l' application Chat. 40 caractères alphanumériques au maximum

Dans la section suivante, vous spécifiez ces informations dans les paramètres de configuration de l'API Chat.

Configurer votre application Chat dans la console Google Cloud

Dans la console Google Cloud, vous configurez les informations sur votre application Chat qui s'affichent pour les utilisateurs dans Chat, y compris un nom à afficher, un avatar et une description. Ces informations ne s'affichent que dans Chat. Pour publier votre application Chat sur le Marketplace, vous devez également spécifier les informations qui s'affichent dans la fiche Marketplace de votre application Chat.

Une fois que vous disposez des informations sur votre application Chat, ouvrez votre projet Cloud et configurez l'API Chat :

  1. Dans la console Google Cloud, accédez à la page de l'API Chat, puis cliquez sur la page Configuration :

    Accéder à la page de configuration de l'API Chat

  2. Sous Informations sur l'application, remplissez les champs Nom de l'application, URL de l'avatar, et Description.

  3. Sous Fonctionnalités interactives , cliquez sur le bouton Activer les fonctionnalités interactives pour l'activer, puis procédez comme suit :

    1. Sous Fonctionnalité, sélectionnez Rejoindre des espaces et des conversations de groupe pour rendre votre application Chat disponible à l'installation et à l'utilisation.

      Par défaut, les utilisateurs peuvent installer l'application Chat et envoyer des messages dans un espace dédié entre l'utilisateur et l'application Chat. Les utilisateurs peuvent également ajouter l'application Chat et interagir avec elle dans des espaces avec plusieurs personnes.

    2. Sous Paramètres de connexion, sélectionnez l'architecture que vous souhaitez utiliser pour recevoir des objets d'événement de Chat :

      • Pour utiliser un service HTTP, sélectionnez URL du point de terminaison HTTP et fournissez une URL.
      • Pour utiliser un projet Google Apps Script, sélectionnez Apps Script et fournissez un ID de déploiement pour le projet.
      • Pour utiliser un agent Dialogflow, sélectionnez Dialogflow, puis Dialogflow CX ou Dialogflow ES, et fournissez le nom de ressource de l'agent.
      • Pour utiliser Pub/Sub, sélectionnez Cloud Pub/Sub et saisissez le nom du sujet.

    3. Facultatif : Pour recevoir des objets d'événement sur plusieurs points de terminaison ou fonctions, accédez à Paramètres de connexion > Déclencheurs , puis fournissez ou mettez à jour les fonctions de rappel pour les déclencheurs Chat suivants :

      • Ajouté à l'espace : un utilisateur ajoute l'application Chat à une conversation de groupe ou à un espace, ou installe l'application Chat pour les messages privés.
      • Message : un utilisateur envoie un message à l’application Chat. Par exemple, il envoie un message privé à l’application Chat ou la mentionne avec un @dans un espace avec plusieurs personnes.
      • Supprimé de l'espace : un utilisateur désinstalle ou supprime l' application Chat d'un espace.
      • Commande d'application : un utilisateur utilise une commande rapide ou une commande barre oblique à partir de l' application Chat.

    4. Facultatif : Ajoutez d'autres fonctionnalités interactives telles que des commandes rapides, des commandes barre oblique, ou des aperçus de liens.

    5. Sous Visibilité, spécifiez votre adresse e-mail afin de pouvoir installer et tester l'application Chat avant de la publier sur Google Workspace Marketplace. Vous pouvez spécifier jusqu'à cinq personnes, ou un ou plusieurs groupes Google de votre organisation Google Workspace.

  4. Facultatif : Sous Journaux, cochez la case Enregistrer les erreurs dans Logging pour utiliser Google Cloud Logging. Pour en savoir plus, consultez Interroger les journaux d'erreurs pour les applications Chat dans la documentation de l'API Chat.

  5. Cliquez sur Enregistrer.

Une fois la configuration enregistrée, toute personne que vous avez spécifiée dans le paramètre Visibilité de l'API Chat peut installer, tester ou utiliser l' application Chat. Pour commencer à tester et à déboguer votre application Chat, consultez Tester les fonctionnalités interactives des applications Google Chat dans la documentation de l'API Chat.

Considérations concernant les modules complémentaires Google Workspace existants

Les applications Chat nécessitent une configuration différente de celle des modules complémentaires Google Workspace qui étendent d'autres applications Google Workspace. Si votre module complémentaire étend d'autres applications Google Workspace, tenez compte des exigences suivantes pour configurer l'application Chat :

  • Les particuliers et les administrateurs Google Workspace doivent pouvoir installer votre module complémentaire depuis Marketplace. Vous configurez ces paramètres d'installation dans le SDK Google Workspace Marketplace.
  • Les applications Chat n'utilisent pas le nom et le logo que vous configurez pour d'autres applications Google Workspace dans l'objet addons.common du fichier manifeste.
  • Pour les modules complémentaires publiés sur le Google Workspace Marketplace, vous ne pouvez pas enregistrer de brouillon des modifications apportées aux paramètres de configuration de l'API Google Chat. Une fois que vous avez mis à jour et enregistré les paramètres de configuration de l'API Chat, l'application Chat mise à jour est disponible pour tous les utilisateurs existants. Pour mettre à jour votre fiche Marketplace, vous pouvez créer un brouillon avant d'envoyer des modifications.

  • Si vous avez créé votre module complémentaire à l'aide d'Apps Script :

  • Si vous avez créé votre module complémentaire à l'aide d'un service HTTP, omettez tous les détails de configuration de l'application Chat dans le fichier manifeste et les déploiements que vous créez à l'aide de l'API des modules complémentaires Google Workspace. Les déploiements HTTP que vous spécifiez dans le SDK Google Workspace Marketplace ne sont utilisés que pour d'autres applications Google Workspace.