Ce tutoriel explique comment créer une application Google Chat qui aide les utilisateurs de Google Chat à gérer leurs contacts personnels et professionnels. Pour collecter des informations, l'application Chat invite les utilisateurs à remplir un formulaire de contact dans les messages de fiche et les boîtes de dialogue.
Découvrez l'application Chat en action:
-
Figure 2 : La L'application Chat ouvre une boîte de dialogue dans laquelle les utilisateurs peuvent saisir des informations sur un contact. -
Figure 3 : L'application Chat affiche une boîte de dialogue de confirmation afin que les utilisateurs puissent examiner et confirmer les informations avant de les envoyer. -
Figure 4 : Une fois que l'utilisateur a envoyé le formulaire, l'application Chat envoie un message privé pour confirmer l'envoi. -
Figure 5 : La L'application Chat invite également les utilisateurs à ajouter un contact à partir d'une fiche dans un message.
Prérequis
- Une entreprise Un compte Google Workspace ayant accès à Google Chat :
Objectifs
- Concevoir et créer des interfaces utilisateur (UI)
en tant qu'objets
card
, et afficher les interfaces utilisateur dans les messages et les boîtes de dialogue. - Recevoir et traiter les informations envoyées par les utilisateurs via widgets de saisie de formulaire.
- Répondez aux commandes slash en envoyant des messages contenant du texte, des fiches et des widgets accessoires.
Architecture
L'application Chat est créée dans Google Apps Script et utilise des événements d'interaction pour traiter et répondre aux utilisateurs de Chat.
L'exemple suivant montre comment un utilisateur peut généralement interagir avec Application de chat:
Un utilisateur ouvre un message privé avec l'application Chat ou ajoute l'application Chat à un espace existant.
L'application Chat invite l'utilisateur à ajouter un contact en créant et en affichant un formulaire de contact en tant qu'objet
card
. Pour présenter le formulaire de contact, l'application Chat répond aux utilisateurs de différentes manières:- Répond aux mentions et aux messages privés avec un message avec fiche contenant le formulaire de contact.
- Répond à la commande à barre oblique
/addContact
en ouvrant une boîte de dialogue avec le formulaire de contact. - Elle répond à la commande à barre oblique
/about
par un message contenant un Bouton Ajouter un contact sur lequel les utilisateurs peuvent cliquer pour ouvrir une boîte de dialogue contenant le formulaire de contact.
Lorsqu'il reçoit le formulaire de contact, l'utilisateur saisit ses coordonnées dans les champs et widgets suivants:
- Prénom et nom : widget
textInput
qui accepte des chaînes. - Date de naissance: a
dateTimePicker
widget qui n'accepte que les dates. - Type de contact: a
selectionInput
widget de cases d'option permettant aux utilisateurs de sélectionner et d'envoyer une seule chaîne (Personal
ouWork
). - Bouton Examiner et envoyer: a
buttonList
tableau avec le widgetbutton
sur lequel l'utilisateur clique pour envoyer les valeurs qu'ils saisissent.
- Prénom et nom : widget
L'application Google Chat gère un événement d'interaction
CARD_CLICKED
pour traiter les valeurs saisies par l'utilisateur, puis affiche les valeurs dans une carte de confirmation.L'utilisateur consulte la carte de confirmation, puis clique sur le bouton Envoyer. pour finaliser les coordonnées.
L'application Google Chat envoie un message privé qui confirme l'envoi.
Préparer l'environnement
Cette section explique comment créer et configurer un projet Google Cloud pour le Application Chat
Créer un projet Google Cloud
console Google Cloud
- Dans la console Google Cloud, accédez à Menu > IAM et administration > Créer un projet.
-
Dans le champ Nom du projet, saisissez un nom descriptif pour votre projet.
Facultatif: Pour modifier l'ID du projet, cliquez sur Modifier. Impossible de modifier l'ID du projet Une fois le projet créé, choisissez donc un ID qui répond à vos besoins pendant toute la durée de vie projet.
- Dans le champ Emplacement, cliquez sur Parcourir pour afficher les emplacements potentiels de votre projet. Cliquez ensuite sur Sélectionner.
- Cliquez sur Créer. La console Google Cloud accède à la page "Tableau de bord", et votre projet est créé. en quelques minutes.
CLI gcloud
Dans l'un des environnements de développement suivants, accédez à la console
CLI (gcloud
):
-
Cloud Shell : pour utiliser un terminal en ligne avec gcloud CLI déjà configuré, activez Cloud Shell.
Activer Cloud Shell -
Shell local : pour utiliser un environnement de développement local, installez et initialisez gcloud CLI.
Pour créer un projet Cloud, utilisez la commandegcloud projects create
: Remplacez PROJECT_ID en définissant l'ID du projet que vous souhaitez créer.gcloud projects create PROJECT_ID
Configurer l'authentification et l'autorisation
Les applications Google Chat nécessitent que vous configuriez un l'écran de consentement OAuth, afin que utilisateurs peuvent autoriser votre application dans les applications Google Workspace, y compris Google Chat.
Dans ce tutoriel, vous déployez une application Chat réservée les tests et l'utilisation interne. Vous pouvez donc utiliser des informations d'espace réservé l'écran de consentement. Avant de publier l'application Chat, remplacez les informations d'espace réservé avec des informations réelles.
Dans la console Google Cloud, accédez à Menu > API et Services > Écran de consentement OAuth.
Sous Type d'utilisateur, sélectionnez Interne, puis cliquez sur Créer.
Dans le champ Nom de l'application, saisissez
Contact Manager
.Dans Adresse e-mail d'assistance utilisateur, sélectionnez votre adresse e-mail ou un groupe Google approprié.
Sous Coordonnées du développeur, saisissez votre adresse e-mail.
Cliquez sur Enregistrer et continuer.
Sur la page Champs d'application, cliquez sur Enregistrer et continuer. (Le L'application Chat ne nécessite aucune habilitation OAuth.)
Examinez le récapitulatif, puis cliquez sur Revenir au tableau de bord.
Créer et déployer l'application Chat
Dans la section suivante, vous allez copier et mettre à jour un projet Apps Script complet contenant tout le code d'application requis pour votre application Chat. Vous n'avez donc pas besoin de copier et coller chaque fichier.
Vous pouvez éventuellement afficher l'intégralité du projet sur GitHub.
Voici un aperçu de chaque fichier:
main.gs
Gère toute la logique de l'application, y compris les événements d'interaction lorsque les utilisateurs envoient des messages à l'application Chat, cliquent sur des boutons à partir d'un message de l'application Chat ou ouvrent et ferment des boîtes de dialogue.
Afficher le code
main.gs
contactForm.gs
Contient les widgets qui reçoivent les données de formulaire des utilisateurs. Ces données de saisie les widgets s'affichent dans des fiches qui apparaissent dans les messages et les boîtes de dialogue.
Afficher le code
contactForm.gs
appsscript.json
Le fichier manifeste Apps Script qui définit et configure le projet Apps Script pour l'application Chat.
Afficher le code
appsscript.json
Trouver le numéro et l'ID de votre projet Cloud
Dans la console Google Cloud, accédez à votre projet Cloud.
Cliquez sur Paramètres et utilitaires > Paramètres du projet.
Notez les valeurs des champs Numéro du projet et ID du projet. Toi utilisez-les dans les sections suivantes.
Créer le projet Apps Script
Pour créer un projet Apps Script et l'associer à votre Cloud:
- Cliquez sur le bouton suivant pour ouvrir le projet Apps Script Gérer les contacts dans Google Chat.
Ouvrir le projet - Cliquez sur Vue d'ensemble.
- Sur la page "Vue d'ensemble", cliquez sur Créer une copie .
Nommez votre copie du projet Apps Script :
Cliquez sur Copie de "Gérer les contacts dans Google Chat".
Dans Titre du projet, saisissez
Contact Manager - Google Chat app
.Cliquez sur Renommer.
Définir le projet Cloud du projet Apps Script
- Dans votre projet Apps Script, cliquez sur Paramètres du projet.
- Sous Projet Google Cloud Platform (GCP), cliquez sur Changer de projet.
- Dans Numéro de projet GCP, collez le numéro de votre projet Cloud.
- Cliquez sur Définir un projet. Le projet Cloud et le projet Apps Script sont maintenant associés.
Créer un déploiement Apps Script
Maintenant que tout le code est en place, déployez Apps Script projet. Vous utilisez l'ID de déploiement lorsque vous configurez l'application Chat dans Google Cloud.
Dans Apps Script, ouvrez le fichier projet.
Cliquez sur Déployer > Nouveau déploiement.
Si Module complémentaire n'est pas déjà sélectionné, en regard de Sélectionner le type, cliquez sur "Types de déploiement" , puis sélectionnez Module complémentaire.
Dans Description, saisissez une description pour cette version, par exemple
Test of Contact Manager
Cliquez sur Déployer. Apps Script indique que le déploiement a réussi et fournit un ID de déploiement.
Cliquez sur
Copier pour copier. l'ID de déploiement, puis cliquez sur OK.
Configurer l'application Chat dans la console Google Cloud
Cette section explique comment configurer l'API Google Chat dans la console Google Cloud contenant des informations sur votre application Chat, y compris ID du déploiement que vous venez de créer à partir de votre script Apps Script projet.
Dans la console Google Cloud, cliquez sur Menu. > Autres produits > Google Workspace > Bibliothèque de produits > API Google Chat > Gérer > Configuration.
Dans le champ Nom de l'application, saisissez
Contact Manager
.Dans le champ URL de l'avatar, saisissez
https://developers.google.com/chat/images/contact-icon.png
.Dans Description, saisissez
Manage your personal and business contacts
.Activez l'option Activer les fonctionnalités interactives.
Sous Fonctionnalité, cochez les cases Recevoir des messages privés et Rejoindre des espaces et des conversations de groupe
Sous Paramètres de connexion, sélectionnez Apps Script.
Dans Deployment ID (ID de déploiement), collez l'ID de déploiement Apps Script. que vous avez copiées dans la section précédente lors de la création du Déploiement d'Apps Script
Sous Commandes à barre oblique, configurez les commandes à barre oblique
/about
et/addContact
:- Cliquez sur Ajouter une commande à barre oblique pour configurer la première commande à barre oblique.
- Dans Nom, saisissez
/about
. - Dans le champ ID de commande, saisissez
1
. - Dans Description, saisissez
Learn how to use this Chat app to manage your contacts
- Sélectionnez Ouvre une boîte de dialogue.
- Cliquez sur OK.
- Cliquez sur Ajouter une commande à barre oblique pour configurer une autre commande à barre oblique.
- Dans Nom, saisissez
/addContact
. - Dans ID de commande, saisissez
2
. - Dans Description, saisissez
Submit information about a contact
- Sélectionnez Ouvre une boîte de dialogue.
- Cliquez sur OK.
Sous Visibilité, sélectionnez l'icône Rendre cette application Chat accessible à des personnes et groupes spécifiques dans YOUR DOMAIN, puis saisissez votre adresse e-mail.
Sous Journaux, sélectionnez Consigner les erreurs dans Logging.
Cliquez sur Enregistrer. Un message de configuration enregistrée s'affiche.
L'application Chat est prête à être installée et testée dans Chat.
Tester l'application Chat
Pour tester votre application Chat, ouvrez un espace de messages privés avec l'application Chat et envoyez un message :
Ouvrez Google Chat avec le compte Google Workspace que vous avez fourni lorsque vous vous êtes ajouté en tant que testeur de confiance.
- Cliquez sur Nouveau chat.
- Dans le champ Ajouter une ou plusieurs personnes, saisissez le nom de votre application Chat.
Sélectionnez votre application Chat dans les résultats. Un direct message s'ouvre.
Dans le nouveau message privé avec l'application Chat, saisissez
/addContact
, puis appuyez sur Entrée.Dans la boîte de dialogue qui s'affiche, saisissez vos coordonnées:
- Dans le champ de texte Prénom et nom, saisissez un nom.
- Dans le sélecteur de date de date de naissance, sélectionnez une date.
- Sous Type de contact, sélectionnez la case d'option Professionnel ou Personnel.
Cliquez sur Vérifier et envoyer.
Dans la boîte de dialogue de confirmation, vérifiez les informations que vous avez envoyées et cliquez sur Envoyer. L'application Chat répond par un message de texte indiquant
✅ CONTACT NAME has been added to your contacts.
.Vous pouvez également tester et envoyer le formulaire de contact comme suit :
- Utilisez la commande à barre oblique
/about
. L'application de chat répond avec un message texte et un bouton de widget accessoire indiquantAdd a contact
. Vous pouvez cliquer sur ce bouton pour ouvrir une boîte de dialogue contenant formulaire de contact. - Envoyez un message privé à l'application Chat sans commande à barre oblique, par exemple
Hello
. L'application Chat répond avec un texte et une fiche contenant le formulaire de contact.
- Utilisez la commande à barre oblique
Effectuer un nettoyage
Afin d'éviter que des frais ne soient facturés sur votre compte Google Cloud pour utilisées dans ce tutoriel, nous vous recommandons de supprimer Google Cloud.
- Dans la console Google Cloud, accédez à la page Gérer les ressources. Cliquez sur Menu > IAM et administration > Gérer les ressources.
- Dans la liste des projets, sélectionnez celui que vous souhaitez supprimer, puis cliquez sur Supprimer .
- Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez sur Arrêter pour supprimer le projet.
Articles associés
- Répondre aux commandes à barre oblique
- Collecter et traiter des informations auprès des utilisateurs de Google Chat
- Ouvrir des boîtes de dialogue interactives
- Explorer d'autres exemples d'applications Google Chat