Créer votre premier agent

Conditions préalables

Créer votre agent

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

Dans ce guide de démarrage rapide, vous allez:

  • S'inscrire en tant que partenaire
  • Créer une marque et un agent
  • (Facultatif) Explorer les fonctionnalités lors d'une conversation avec le bot d'aide Business Messages
  • 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 la console développeur de Business Communications.
  2. Sous Messages commerciaux, cliquez sur Créer un compte partenaire.

  3. Saisissez vos informations de partenaire:

    Champ Value
    Votre nom Votre nom complet
    Nom du partenaire Nom de votre entreprise
    Site Web du partenaire Site Web de votre entreprise
    Une région 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 inscrit 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 et il n'interfère avec aucun de 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 développeur de Business Communications, cliquez sur Paramètres du compte partenaire.
  2. Dans le volet 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. Stockez-le en lieu sûr. Vous en aurez besoin plus tard pour déployer une application Web et accéder aux API Business Messages et Business Communications.

Créer une marque et un agent

Un agent est une représentation conversationnelle d'une marque, c'est-à-dire l'entité conversationnelle avec laquelle les utilisateurs interagissent. Vous créez une marque pour représenter l'entreprise et créez un agent afin que les consommateurs puissent interagir avec elle.

  1. Ouvrez la Console développeur de Business Communications 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 interagir avec votre agent et découvrir 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 Activer 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 lancer une conversation immédiatement. Sinon, vous pouvez configurer votre agent pour la gestion des messages.

Découvrir les fonctionnalités du bot d'aide Business Messages

Le bot d'aide Business Messages vous permet de lancer rapidement une conversation avec votre agent afin de découvrir les fonctionnalités de la plate-forme. L'activation du bot d'aide est facultative, mais vivement recommandée lors de la création de votre premier agent.

Le bot d'aide vous permet

  • découvrir des fonctionnalités enrichies
  • apprendre à implémenter des fonctionnalités
  • trouver des ressources pour la configuration de 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 le bot d'aide Business Messages activé, 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. Plusieurs options s'offrent à vous:

    • 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 de test de l'agent.
    • Cliquez sur Envoyer pour envoyer les URL vers votre adresse e-mail.

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

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 la console développeur de Business Communications.
  2. Sélectionnez votre agent.
  3. Dans le volet de navigation de gauche, cliquez sur Intégrations.
  4. Pour le bot d'aide, cliquez sur Désactiver.

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

Configurer votre agent pour la gestion des messages

Dans ce guide, vous allez déployer un bot Echo dans Google Cloud Platform (GCP) à l'aide d'un webhook conçu pour traiter les messages des utilisateurs.

Le bot Echo est un exemple d'application qui renvoie les messages à l'utilisateur. Elle vous permet de tester des fonctionnalités enrichies, telles que les suggestions d'actions et les fiches enrichies, dans une conversation avec votre agent. Vous pouvez également utiliser le bot Echo comme point de départ pour développer votre agent.

Pour ce faire, procédez comme suit:

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

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

Déployer l'application Web sur GCP

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

Créer un environnement Cloud

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

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

  1. Ouvrez le sélecteur de projet de Google Cloud Console.

    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

    • L'ID de votre projet est généré automatiquement et apparaît 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 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 offert Google Cloud pour comprendre les options de paiement.

Déployer l'exemple du bot Echo

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

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

  3. Copiez le fichier d'identifiants JSON que vous avez téléchargé à l'étape Créer un compte de service dans le dossier de ressources de l'exemple et renommez les identifiants en &bt-bs-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'échantillon.

  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 est répertorié 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 est répertorié 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 est répertorié 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 le Echo Bot est déployé, vous devez spécifier une URL de webhook (que vous exploitez) pour commencer à recevoir des messages.

  1. Ouvrez les paramètres du compte dans la console de développement Business Communications.
  2. Assurez-vous d'avoir sélectionné le bon compte partenaire.
  3. Dans le champ URL du webhook Business Messages, cliquez sur Configurer.

  4. Dans le champ URL du point de terminaison du webhook, saisissez l'URL de l'application + "/callback".

    Votre point de terminaison se présentera comme suit : "https://PROJECT_ID.appspot.com/callback".

    Ce point de terminaison est prédéfini dans la logique d'application de l'exemple que vous avez déployé 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 la section Exemple: Mettre à jour l'URL de webhook.

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

Saisir les informations sur l'agent

Fournissez des informations de base pour terminer la configuration de votre agent.

  1. Ouvrez la console développeur de Business Communications.
  2. Dans le volet de navigation de gauche, cliquez sur Informations sur l'agent.

  3. Mettez à jour les valeurs comme vous le souhaitez, ou utilisez les suggestions suivantes:

    Champ Value
    Message de bienvenue Bienvenue dans la conversation avec le bot Echo !
    Règles de confidentialité https://policies.google.com/privacy

  4. Cliquez sur Enregistrer.

Démarrer la conversation

Pour interagir avec le bot Echo, procédez comme suit:

  1. Ouvrez la console développeur de Business Communications.
  2. Dans le volet de navigation de gauche, cliquez sur Informations sur l'agent.
  3. Sous Agent test URLs (URL de test de l'agent), cliquez sur le bouton Android ou iOS.

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

    Vous pouvez également cliquer sur Envoyer pour envoyer les URL vers 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 accueille. À ce stade, vous pouvez interagir avec le bot Echo. Il reprend les messages que vous recevez. En outre, vous pouvez appeler des fonctionnalités enrichies en envoyant des chaînes spécifiques : "carrousel", "carte" et "chips".

Étapes suivantes

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