Cette page explique comment créer une application de chat HTTP. Il existe différentes manières d'implémenter cette architecture. Sur Google Cloud, Cloud Functions, Cloud Run et App Engine. Dans ce guide de démarrage rapide, vous allez d'écrire et de déployer Fonction Cloud que l'application Chat utilise pour répondre au message d'un utilisateur.
Avec cette architecture, vous configurez Chat pour l'intégrer Google Cloud ou un serveur sur site via HTTP, comme indiqué dans le schéma suivant:
Dans le schéma précédent, un utilisateur interagissant avec un serveur L'application Chat comporte le flux d'informations suivant:
- Un utilisateur envoie un message dans Chat à une Application de chat, dans un message privé ou dans une Espace Chat.
- Une requête HTTP est envoyée à un serveur Web qui est un cloud ou système sur site contenant l'application Chat logique.
- La logique de l'application Chat peut éventuellement s'intégrer à services Google Workspace (tels qu'Agenda et Sheets), d'autres services Google. (Maps, YouTube ou Vertex AI, par exemple) ou d'autres services Web (comme un projet ou un outil de suivi des demandes d'assistance).
- Le serveur Web renvoie une réponse HTTP au Service d'application Chat dans Chat
- La réponse est envoyée à l'utilisateur.
- L'application Chat peut éventuellement appeler la fonction l'API Chat pour publier des messages de manière asynchrone ou effectuer d'autres opérations.
Cette architecture vous offre la flexibilité d'utiliser des bibliothèques et qui existent déjà dans votre système, Les applications de chat peuvent être conçues à l'aide de différents langages de programmation.
Objectifs
- configurer votre environnement ;
- Créer et déployer une fonction Cloud
- Publiez l'application dans Chat.
- Testez l'application.
Prérequis
- Une entreprise Un compte Google Workspace ayant accès à Google Chat :
- Un projet Google Cloud avec facturation activée. Pour vérifier si la facturation est activée sur un projet existant, consultez la section Vérifier le l'état de facturation de vos projets. Pour créer un projet et configurer la facturation, consultez Créez un projet Google Cloud.
Configurer l'environnement
Avant d'utiliser les API Google, vous devez les activer dans un projet Google Cloud. Vous pouvez activer une ou plusieurs API dans un même projet Google Cloud.Dans la console Google Cloud, activez l'API Google Chat, l'API Cloud Build, l'API Cloud Functions, les API Cloud Pub/Sub, Cloud Logging, Artifact Registry et Cloud Run.
Créer et déployer une fonction Cloud
Créer et déployer une fonction Cloud qui génère une fiche Chat avec le nom à afficher et l'avatar de l'expéditeur. Lorsque L'application de chat reçoit un message, exécute la fonction et répond avec la carte.
Pour créer et déployer la fonction pour votre application Chat, procédez comme suit : procédez comme suit:
Node.js
Dans la console Google Cloud, accédez à la page Cloud Functions.
Assurez-vous que le projet de votre application Chat est sélectionnée.
Cliquez sur
Créer une fonction.Sur la page "Créer une fonction", configurez votre fonction:
- Dans Environnement, sélectionnez 2e génération.
- Dans Nom de la fonction, saisissez
QuickStartChatApp
. - Dans Région, sélectionnez une région.
- Sous "Authentification", sélectionnez Exiger l'authentification.
- Cliquez sur Suivant.
Dans Environnement d'exécution, sélectionnez la version la plus récente de Node.js.
Dans Code source, sélectionnez Éditeur intégré.
Dans Point d'entrée, supprimez le texte par défaut et saisissez
avatarApp
.Remplacez le contenu du fichier
index.js
par le code suivant :Cliquez sur Déployer.
Python
Dans la console Google Cloud, accédez à la page Cloud Functions.
Assurez-vous que le projet de votre application Chat est sélectionnée.
Cliquez sur
Créer une fonction.Sur la page "Créer une fonction", configurez votre fonction:
- Dans Environnement, sélectionnez 2e génération.
- Dans Nom de la fonction, saisissez
QuickStartChatApp
. - Dans Région, sélectionnez une région.
- Sous "Authentification", sélectionnez Exiger l'authentification.
- Cliquez sur Suivant.
Dans Environnement d'exécution, sélectionnez la version la plus récente de Python.
Dans Code source, sélectionnez Éditeur intégré.
Dans Point d'entrée, supprimez le texte par défaut et saisissez
avatar_app
.Remplacez le contenu du fichier
main.py
par le code suivant :Cliquez sur Déployer.
Java
Dans la console Google Cloud, accédez à la page Cloud Functions.
Assurez-vous que le projet de votre application Chat est sélectionnée.
Cliquez sur
Créer une fonction.Sur la page "Créer une fonction", configurez votre fonction:
- Dans Environnement, sélectionnez 2e génération.
- Dans Nom de la fonction, saisissez
QuickStartChatApp
. - Dans Région, sélectionnez une région.
- Sous "Authentification", sélectionnez Exiger l'authentification.
- Cliquez sur Suivant.
Dans Environnement d'exécution, sélectionnez la version la plus récente de Java.
Dans Code source, sélectionnez Éditeur intégré.
Dans Point d'entrée, supprimez le texte par défaut et saisissez
App
.src/main/java/com/example/Example.java
a été renommésrc/main/java/App.java
.Remplacez le contenu du fichier
App.java
par le code suivant :Remplacez le contenu du fichier
pom.xml
par le code suivant :Cliquez sur Déployer.
La page de détails de Cloud Functions s'ouvre et votre fonction apparaît avec des indicateurs de progression: un pour la compilation et un pour le service. Lorsque les deux les indicateurs de progression disparaissent et sont remplacés par une coche, votre fonction est déployée et prête.
Autoriser Google Chat à appeler votre fonction
Pour autoriser Google Chat à appeler votre fonction, ajoutez l'application disposant du rôle Demandeur Cloud Run.
Dans la console Google Cloud, accédez à la page Cloud Run:
Dans la liste des services Cloud Run, cochez la case située à côté du champ . (Ne cliquez pas directement sur la fonction.)
Cliquez sur Autorisations. Le panneau Autorisations s'ouvre.
Cliquez sur Ajouter un compte principal.
Dans Nouveaux comptes principaux, saisissez
chat@system.gserviceaccount.com
.Dans Sélectionner un rôle, sélectionnez Cloud Run > Demandeur Cloud Run.
Cliquez sur Enregistrer.
Publier l'application sur Google Chat
Une fois la fonction Cloud déployée, procédez comme suit pour la transformer en Application Google Chat:
Dans la console Google Cloud, cliquez sur Menu > Cloud Functions.
Vérifiez que le projet pour lequel vous avez activé Cloud Functions sélectionnée.
Dans la liste des fonctions, cliquez sur QuickStartChatApp.
Cliquez sur l'onglet Triggers (Déclencheurs).
Sous HTTPS, copiez l'URL.
Recherchez "API Google Chat" et cliquez sur API Google Chat, puis sur Gérer.
Cliquez sur Configuration et configurez l'application Google Chat:
- Dans Nom de l'application, saisissez
Quickstart App
. - Dans le champ URL de l'avatar, saisissez
https://developers.google.com/chat/images/quickstart-app-avatar.png
- Dans Description, saisissez
Quickstart app
. - Sous Fonctionnalité, sélectionnez Recevoir des messages privés. Rejoindre des espaces et des conversations de groupe
- Sous Paramètres de connexion, sélectionnez URL de l'application et collez l'URL de le déclencheur Cloud Functions.
- Dans Authentication Audience (Audience de l'authentification), sélectionnez App URL (URL de l'application).
- Sous Visibilité, sélectionnez Rendre cette application Google Chat accessible à des personnes et groupes de votre domaine et saisissez votre adresse e-mail.
- Sous Journaux, sélectionnez Consigner les erreurs dans Logging.
- Dans Nom de l'application, saisissez
Cliquez sur Enregistrer.
L'application Chat est prête à recevoir des messages et à y répondre messages dans Chat.
Tester votre application Chat
Pour tester votre application Chat, ouvrez un espace de message privé avec l'application Chat et envoyez un message:
Ouvrez Google Chat à l'aide du compte Google Workspace que vous 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, saisissez
Hello
et appuyez surenter
La réponse de l'application Chat contient un message sous forme de fiche qui affiche le du nom et de l'avatar de l'expéditeur, comme illustré dans l'image suivante:
Pour ajouter des testeurs de confiance et en savoir plus sur le test des fonctionnalités interactives, consultez Testez les fonctionnalités interactives pour Applications Google Chat
Résoudre les problèmes
Lorsqu'une application ou card renvoie une erreur, la L'interface Chat affiche le message "Une erreur s'est produite". ou "Impossible de traiter votre demande." Parfois, l'interface utilisateur de Chat n'affiche aucun message d'erreur, mais que l'application ou la carte produit un résultat inattendu. Par exemple, un message de fiche peut ne pas s'affichent.
Même s'il est possible qu'aucun message d'erreur ne s'affiche dans l'interface utilisateur de Chat, Des messages d'erreur descriptifs et des données de journaux sont disponibles pour vous aider à corriger les erreurs. Lorsque la journalisation des erreurs est activée pour les applications Chat. Pour obtenir de l'aide, le débogage et la correction des erreurs, consultez Résoudre les problèmes liés à Google Chat
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 Administrateur
> Gérer les ressources.
<ph type="x-smartling-placeholder"></ph> Accéder au gestionnaire de ressources
- Dans la liste des projets, sélectionnez celui que vous souhaitez supprimer, puis cliquez sur Supprimez .
- Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez sur Arrêter pour le supprimer. le projet.
Articles associés
Pour ajouter des fonctionnalités à votre application Chat, consultez les suivantes: