Intégration de Dialogflow à Google Chat

L'intégration de Dialogflow à Google Chat vous permet de créer des bots que vous pouvez inclure dans des discussions à deux, ainsi que dans des salons de discussion. Pour en savoir plus, consultez la documentation de l'API Google Chat.

Configurer

Pour configurer et activer l'intégration de Google Chat, procédez comme suit :

  1. Cliquez sur Intégrations dans le menu de gauche.
  2. Cliquez sur Hangouts Chat.
  3. Sélectionnez une option d'accès.
  4. [Facultatif] Sélectionnez un environnement pour l'agent.
  5. Cliquez sur Démarrer.

Configurer votre bot

Une fois le bot Google Chat créé, vous pouvez en modifier les détails en cliquant sur le bouton CONFIGURER LES DÉTAILS DU BOT dans la fenêtre pop-up d'intégration. Cela vous amènera à la page Google Cloud Console dédiée à l'API Google Chat.

Configurez et publiez votre bot en suivant les instructions du guide de publication de bots de l'API Google Chat.

Configurer l'avatar de votre bot

Il existe deux alternatives à la configuration de votre avatar de bot :

  • Cliquez sur le bouton CONFIGURER LES DÉTAILS DU BOT dans les paramètres d'intégration, puis saisissez une URL d'avatar dans le champ URL de l'avatar.
  • Saisissez une URL d'avatar dans le champ URI de l'avatar de l'agent des paramètres généraux de l'agent.

Activer et configurer l'intégration à l'aide de Cloud Console

Vous pouvez également activer l'intégration de Google Chat via Cloud Console en procédant comme suit :

  1. Dans Cloud Console, cliquez sur l'icône de menu dans l'angle supérieur gauche.
  2. Cliquez sur API et services, puis sur Tableau de bord.
  3. Cliquez sur ACTIVER DES API ET DES SERVICES.
  4. Recherchez "API Google Chat".
  5. Cliquez sur la mosaïque de l'API Google Chat.
  6. Cliquez sur Activer.
  7. Cliquez sur Configuration dans le menu de la barre latérale gauche.
  8. Configurez et publiez votre bot en suivant les instructions du guide de publication de bots de l'API Google Chat.

Test

Avant de tester votre bot, assurez-vous de l'avoir démarré. (Consultez la section Configurer).

Pour tester votre bot, procédez comme suit :

  1. Accédez à Google Chat.
  2. Cliquez dans le champ Rechercher.
  3. Sélectionnez Rechercher un bot.
  4. Sélectionnez le nom de votre bot.
  5. Cliquez sur Message.

Dépannage

Erreur Solution
Votre administrateur a bloqué les interactions avec les bots dans les messages privés. Demandez à votre administrateur Google Workspace d'autoriser les utilisateurs à installer des bots.

Messages de réponses enrichies

Cette intégration traduit certains messages de réponses enrichies aux formats de messages Google Chat.

Réponses textuelles

Les réponses textuelles sont envoyées à Google Chat au format SimpleText. Avec cette mise en forme, vous pouvez mettre le texte en gras ou en italique en l'encapsulant dans certains symboles (réduction claire).

La réponse SimpleText se présente visuellement comme la réponse textuelle par défaut dans la console Dialogflow. Cependant, la réponse de l'API brute sera légèrement différente. Elle définit également la configuration de la plateforme sur GOOGLE_HANGOUTS, ce qui peut être utile pour créer des agents pour plusieurs intégrations.

"fulfillmentMessages": [
{
   "text": {
   "text": [
        "This is a test."
   ]
},
  "platform": "GOOGLE_HANGOUTS"
},

Images

Les réponses sous forme d'images sont envoyées à Google Chat sous forme de Widgets d'image Google Chat.

Fiches

Les réponses sous forme de fiches sont envoyées à Google Chat sous forme de Fiches Google Chat.

Charge utile personnalisée

Pour envoyer d'autres types de messages Google Chat, vous pouvez utiliser une charge utile personnalisée.

La charge utile personnalisée de Google Chat vous permet de créer des fiches plus avancées. Une fiche peut comporter une ou plusieurs sections. Chaque section peut avoir un en-tête. Vous pouvez consulter le guide de référence sur les fiches de formats de messages Google Chat pour découvrir certaines des combinaisons que vous pouvez créer avec ce produit. Cependant, si vous utilisez des charges utiles personnalisées, vous devrez fournir le format JSON.

Voici un exemple concret :

{
  "hangouts": {
    "header": {
      "title": "Pizza Bot Customer Support",
      "subtitle": "pizzabot@example.com",
      "imageUrl": "https://goo.gl/aeDtrS"
    },
    "sections": [{
      "widgets": [{
        "keyValue": {
          "icon": "TRAIN",
          "topLabel": "Order No.",
          "content": "12345"
        }
      },
      {
        "keyValue": {
          "topLabel": "Status",
          "content": "In Delivery"
        }
      }]
    },
    {
      "header": "Location",
      "widgets": [{
        "image": {
          "imageUrl": "https://dummyimage.com/600x400/000/fff"
        }
      }]
    },
    {
      "header": "Buttons - I could leave the header out",
      "widgets": [{
        "buttons": [{
          "textButton": {
            "text": "OPEN ORDER",
            "onClick": {
              "openLink": {
                "url": "https://example.com/orders/..."
              }
            }
          }
        }]
      }]
    }]
  }
}