Créer votre premier agent

Prérequis

• Si vous avez créé votre compte partenaire avant le 7 mars 2022, vous devez activer l'API Business Messages. Consultez Activer les API Business Communications et Business Messages.

Créer votre agent

Ce guide vous explique comment créer un agent à l'aide d'un exemple d'application. Cet exemple permet d'explorer rapidement les fonctionnalités d'un agent et peut servir de point de départ pour son développement. Si vous souhaitez modifier une application existante pour inclure un agent, cet exemple offre un modèle adapté à votre logique d'application.

Dans ce guide de démarrage rapide, vous allez effectuer les opérations suivantes:

• S'inscrire en tant que partenaire
• Créer une marque et un agent
• Vous pouvez également explorer les fonctionnalités d'une conversation avec Business Messages. Bot d'aide
• Configurer votre agent pour envoyer et recevoir des messages

Pour créer un agent sans utiliser l'exemple, consultez Créer votre agent.

S'inscrire en tant que partenaire

1. Ouvrez le Console pour les développeurs Business Communications.
2. Sous Business Messages, cliquez sur Créer un compte partenaire.

3. Saisissez les informations relatives au partenaire:

   Champ	Valeur
   Votre nom	Votre nom complet
   Nom du partenaire	Nom de votre entreprise
   Site Web du partenaire	Site Web de votre entreprise
   Région	La région dans laquelle vous souhaitez héberger le service Business Messages

4. Lisez et acceptez les Conditions d'utilisation de Business Messages

5. Cliquez sur Créer.

Vous êtes désormais enregistré en tant que partenaire Business Messages. Un projet Google Cloud a été créé pour vous avec les API Business Messages et Business Communications activées. Vous n'avez pas accès à ce projet, qui n'interférera pas avec vos projets Google Cloud existants.

Vous avez désormais accès aux API Business Messages et Business Communications.

Créer un compte de service

1. Sur la page d'accueil de la console pour développeur Business Communications, cliquez sur Paramètres du compte partenaire.
2. Dans le panneau de navigation de gauche, cliquez sur Compte de service :

3. Cliquez sur Créer une clé, puis sur Créer.

   Votre navigateur télécharge la clé du compte de service. Conservez-le dans un l'emplacement. Vous en aurez besoin ultérieurement pour déployer une application Web accéder aux API Business Messages et Business Communications à l'avenir.

Créer une marque et un agent

Un agent est une représentation conversationnelle d'une marque, l'entité conversationnelle. avec lesquelles les utilisateurs interagissent. Vous créez une marque pour représenter l'entreprise et créer un agent afin que les clients puissent communiquer avec lui de manière conversationnelle.

1. Ouvrez l'application Business Communications Developer Console et connectez-vous avec votre compte Google Business Messages.
2. Cliquez sur Create Agent (Créer un agent).
3. Pour Type d'agent, sélectionnez Messages commerciaux.
4. Renseignez les champs Nom de la marque et Nom de l'agent.
5. Effectuez l'une des opérations suivantes :
   • Pour discuter avec votre agent et explorer les fonctionnalités disponibles, sélectionnez Activer le bot d'aide Business Messages.
   • Pour personnaliser votre agent et le préparer pour la gestion des messages, désélectionnez Activez le bot d'aide Business Messages.
6. Cliquez sur Create Agent (Créer un agent).

Si vous avez activé le bot d'aide Business Messages, vous pouvez démarrer une conversation immédiatement. Sinon, Configurez votre agent pour la gestion des messages.

Explorer les fonctionnalités avec le bot d'aide Business Messages

Le bot d'aide Business Messages vous permet de démarrer rapidement une conversation avec votre afin que vous puissiez découvrir ce que la plate-forme a à offrir. Activation de l'application auxiliaire Le bot est facultatif, mais vivement recommandé lors de la création de votre premier agent.

Le bot d'aide vous permet

• Découvrez des fonctionnalités enrichies
• Découvrir comment implémenter des fonctionnalités
• Trouver des ressources pour configurer l'agent

Lorsque le bot d'aide est activé, il envoie et reçoit des messages pour votre agent. aucun webhook n'est requis. Vous devez désactiver le bot d'aide. avant de pouvoir définir un webhook ou activer Dialogflow pour gérer les messages des utilisateurs.

Démarrer une conversation avec le bot d'aide

Une fois que vous avez activé le bot d'aide Business Messages, vous pouvez démarrer une conversation. Une boîte de dialogue s'ouvre immédiatement après la création de l'agent pour vous aider à démarrer.

Pour interagir avec le bot d'aide, procédez comme suit dans cette boîte de dialogue:

1. Accédez aux URL de test de l'agent. Pour ce faire, vous disposez de différentes méthodes:

   • Cliquez sur le bouton Android ou iOS. Scannez ensuite le code QR avec l'appareil mobile correspondant, puis cliquez sur Lancer. Vous pouvez également cliquer sur Copier l'URL Android ou Copier l'URL iOS pour copier l'URL. l'URL de test de l'agent.
   • Cliquez sur Envoyer pour envoyer les URL à votre adresse e-mail.

2. Ouvrez l'URL sur votre appareil mobile. (Les appareils iOS nécessitent Google Maps app.)

Désactiver le bot d'aide

Avant de pouvoir personnaliser votre agent et le préparer pour le lancement, vous devez désactiver le bot d'aide Business Messages.

Pour désactiver le bot d'aide,

1. Ouvrez l'application Business Communications Developer la console Cloud.
2. Sélectionnez votre agent.
3. Dans le panneau de navigation de gauche, cliquez sur Integrations (Intégrations).
4. Dans Bot d'aide, cliquez sur Désactiver.

Lorsque le bot d'aide est désactivé, il n'envoie ni ne reçoit de messages pour votre agent. Vous pouvez maintenant configurer votre agent pour qu'il gère flux de messagerie.

Configurer votre agent pour la gestion des messages

Dans ce guide, vous allez déployer un Echo Bot sur Google Cloud Platform (GCP) avec un et webhook conçu pour traiter les messages des utilisateurs.

Echo Bot est un exemple d'application qui renvoie les messages à l'utilisateur. Il vous permet de tester des fonctionnalités enrichies, suggestions d'actions et cartes enrichies, dans une conversation avec votre agent. Vous pouvez aussi utiliser Echo Bot comme point de départ pour développer votre agent.

Procédez comme suit:

• Déployer l'exemple Echo Bot sur GCP
• Configurer l'URL du webhook pour votre compte partenaire Business Messages
• Fournissez des informations de base sur votre agent

À la fin de ce guide, votre agent sera prêt à envoyer et recevoir des messages.

Remarque : Si vous avez activé le bot d'aide Business Messages, vous devez disposer des éléments suivants : de le désactiver avant de pouvoir personnaliser votre agent et recevoir des messages au niveau de votre webhook.

Déployer l'application Web sur GCP

Business Messages transfère les messages des utilisateurs vers un webhook. dans votre infrastructure. Dans ce guide, vous allez déployer l'exemple Echo Bot le code source vers un webhook préconfiguré. Si vous disposez déjà d'une infrastructure Web pour recevoir des messages, vous pouvez créer un webhook mais vous devrez configurer vous-même la logique. Voir Définir le webhook au niveau du partenaire pour en savoir plus.

Remarque :Lorsque vous créez votre propre application, vous pouvez utiliser la logique préconfigurée dans Echo Bot comme modèle. Veillez à inclure la logique pour clientToken afin de vérifier que les messages que vous recevez proviennent de Google.

Créer un environnement cloud

Vous avez besoin d'un environnement cloud pour déployer l'exemple Echo Bot.

Remarque :Vous devez ajouter un compte de facturation Cloud à votre projet lorsque vous créez un environnement Cloud. Vous pouvez choisir un compte sans frais ou payant. Vous pouvez également choisir de déployer Echo Bot sur votre propre serveur.

Pour créer un projet GCP en tant qu'environnement cloud, procédez comme suit:

1. Ouvrez le Sélecteur de projet de la console Google Cloud :

   Si vous n'avez jamais créé de projet Google Cloud, vous devez accepter les Conditions d'utilisation.

2. Cliquez sur Créer un projet.

3. Saisissez un nom et un emplacement pour votre nouveau projet

   • Votre ID de projet est généré automatiquement et s'affiche sous le nom de votre projet.
   • Dans le champ Emplacement, cliquez sur Parcourir pour afficher les emplacements potentiels de votre projet. Si vous ne trouvez pas votre organisation Google Workspace, cela signifie que vous n'êtes pas connecté à un compte Google Workspace. Vous pouvez créer un projet sans organisation, mais certaines fonctionnalités sont limitées. Pour en savoir plus, consultez la section Avantages de la ressource Organisation.

4. Cliquez sur Créer.

5. Cliquez sur Menu.

6. Cliquez sur Facturation.

7. Cliquez sur Associer un compte de facturation.

8. Créez un compte de facturation ou ajoutez un compte de facturation existant au projet. Consultez les fonctionnalités du programme sans frais Google Cloud pour comprendre les options de paiement.

Déployer l'exemple Echo Bot

1. Installer gcloud CLI Vous l'utiliserez pour déployer l'exemple de code sur Google Cloud.

2. Télécharger et extraire l'exemple Echo Bot (Node.js, Java Python).

3. Copiez le fichier d'identifiants JSON que vous avez téléchargé Créez un compte de service dans le dossier de ressources de l'exemple. Renommez les identifiants "bm-agent-service-account-credentials.json". Le chemin d'accès à ce fichier d'identifiants dépend de l'exemple que vous avez téléchargé.

   Node.js

   ./bm-nodejs-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json
   

   Java

   ./bm-java-echo-bot/full_sample/src/main/resources/bm-agent-service-account-credentials.json
   

   Python

   ./bm-python-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json
   

4. Dans un terminal, accédez au répertoire "full_sample" de l'exemple.

5. Exécutez les commandes suivantes dans un terminal pour déployer l'exemple :

   Node.js

   gcloud config set project PROJECT_ID
   gcloud app create
   gcloud app deploy
   

   PROJECT_ID est l'ID du projet que vous avez créé dans Créer un environnement cloud L'ID du projet figure dans le tableau de bord du projet dans Google Cloud.

   Java

   gcloud config set project PROJECT_ID
   gcloud app create
   mvn appengine:deploy
   

   PROJECT_ID est l'ID du projet que vous avez créé dans Créer un environnement cloud L'ID du projet figure dans le tableau de bord du projet dans Google Cloud.

   Python

   gcloud config set project PROJECT_ID
   gcloud app create
   gcloud app deploy
   

   PROJECT_ID est l'ID du projet que vous avez créé dans Créer un environnement cloud L'ID du projet figure dans le tableau de bord du projet dans Google Cloud.

6. Notez l'URL de l'application déployée dans le résultat de la dernière commande. Voici la base de votre URL de webhook:

   Deployed service [default] to [https://PROJECT_ID.appspot.com]

Définir votre webhook

Maintenant que Echo Bot est déployé, vous devez spécifier une URL de webhook (que vous fonctionner) pour démarrer la réception de messages.

1. Ouvrez le Paramètres du compte dans la console pour les développeurs Business Communications.
2. Assurez-vous que le bon compte partenaire est sélectionné.
3. Pour URL du webhook Business Messages, cliquez sur Configurer.

4. Dans le champ URL du point de terminaison du webhook, saisissez l'URL de votre application suivie de "/rappel".

   Votre point de terminaison doit respecter le format suivant: "https://PROJECT_ID.appspot.com/callback".

   Ce point de terminaison est prédéfini dans la logique d'application de l'exemple que vous déployés sur GCP.

5. Dans la console développeur, cliquez sur Valider.

   Lorsque Business Messages valide votre webhook, la boîte de dialogue se ferme.

Pour configurer votre webhook avec l'API Business Communications, consultez Exemple: Mettre à jour l'URL du webhook.

Vous pouvez utiliser le framework de test Business Messages pour tester si votre webhook répond correctement aux charges utiles Business Messages.

Saisir les informations sur l'agent

Fournissez quelques informations de base pour terminer la configuration de l'agent.

1. Ouvrez l'application Business Communications Developer la console Cloud.
2. Dans le volet de navigation de gauche, cliquez sur Informations sur l'agent.

3. Modifiez les valeurs comme vous le souhaitez ou utilisez les suggestions suivantes:

   Champ	Valeur
   Message de bienvenue	Bienvenue dans la conversation sur Echo Bot !
   Règles de confidentialité	https://policies.google.com/privacy

4. Cliquez sur Enregistrer.

Engager la conversation

Pour interagir avec Echo Bot, procédez comme suit:

1. Ouvrez l'application Business Communications Developer la console Cloud.
2. Dans le volet de navigation de gauche, cliquez sur Informations sur l'agent.
3. Sous URL de test d'agent, cliquez sur le bouton Android ou iOS.

4. Scannez le code QR avec l'appareil mobile correspondant ou cliquez sur Copier Android URL ou Copier l'URL iOS pour copier l'URL de test de l'agent.

   Vous pouvez également cliquer sur Envoyer pour envoyer les URL à votre adresse e-mail.

5. Ouvrez l'URL sur votre appareil mobile. (Les appareils iOS nécessitent l'application Google Maps).

Le message de bienvenue de votre agent vous salue. À ce stade, vous pouvez interagir avec l’Echo Bot. Il reproduit les messages que vous vous renvoyez. Vous pouvez également appeler des fonctionnalités enrichies en envoyant des chaînes spécifiques : "carrousel", "carte", "chips".

Étapes suivantes

Maintenant que vous avez créé votre premier agent, découvrez Business Messages et ce que vous pouvez faire d'autre sur la plate-forme.

• En savoir plus sur le fonctionnement de Business Messages

• Consultez les exigences et consignes Business Messages.

• Modifiez Echo Bot et répondez en suivant votre logique métier en examinant comment recevoir des messages.

• Vérifiez votre infrastructure.

• Lancer plus d'agents et des lieux.