Intégration de Dialogflow à Google Chat

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

L'intégration de Dialogflow à Google Chat vous permet de créer des applications de chat que vous pouvez inclure dans des conversations en tête à tête ou dans des espaces de discussion. Pour en savoir plus, consultez la documentation pour les développeurs Google Chat.

Limites

Seule la langue de l'agent par défaut est acceptée par cette intégration.

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 Start (Démarrer).

Configurer votre application de chat

Une fois votre application Google Chat créée, vous pouvez en modifier les détails en cliquant sur le bouton CONFIGURE BOT DETAILS (CONFIGURER LES DÉTAILS DU BOT) dans la fenêtre pop-up d'intégration. Vous êtes redirigé vers la page Google Cloud Console de l'API Google Chat.

Suivez les instructions du guide des applications de l'API Google Chat pour configurer et publier votre application.

Configurer l'avatar de l'application Chat

Il existe deux façons de configurer l'avatar de votre application:

  • 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 avec Google Cloud Console

L'intégration de Google Chat peut également être activée via Google Cloud Console en procédant comme suit:

  1. Dans Google Cloud Console, cliquez sur l'icône de menu en haut à 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. Suivez les instructions du guide des applications de l'API Google Chat pour configurer et publier votre application.

Test

Avant de tester votre application de chat, assurez-vous de l'avoir démarrée (consultez la section Configurer).

Pour tester votre application, procédez comme suit:

  1. Ouvrez Google Chat.
    1. Envoyez un nouveau message privé à l'application en cliquant sur Démarrer une discussion > Rechercher des applications.
    2. Sur la page "Rechercher des applications", recherchez le nom de votre application.
    3. À côté de votre application, cliquez sur Chat.
    4. Dans le nouveau message privé contenant l'application, saisissez Hello et appuyez sur enter.

Dépannage

Error La solution
Votre administrateur vous empêche d'envoyer des messages privés aux applications. Demandez à votre administrateur Google Workspace d'autoriser les utilisateurs à installer des applications de chat.

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 Delivery Customer Support",
      "subtitle": "pizzadelivery@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/..."
              }
            }
          }
        }]
      }]
    }]
  }
}