Intégration de Dialogflow à Google Chat

En intégrant Dialogflow à Google Chat, vous bénéficiez des fonctionnalités des deux services :

• Google Chat. Fournit une plate-forme de messagerie avec une interface utilisateur front-end pour les conversations à deux et les espaces de discussion. Grâce à Google Chat, vous pouvez améliorer les interfaces utilisateur en créant des fiches intégrant des icônes, des images, des boutons, des champs de saisie de texte ou des applications telles que Google Maps.
• Dialogflow. Fournit une plate-forme de compréhension du langage naturel pour les conversations automatisées et les réponses dynamiques. Grâce à Dialogflow, vous pouvez interpréter et répondre aux intentions des utilisateurs, par exemple pour planifier des rendez-vous ou traiter des achats.

Bien que vous puissiez également utiliser Google Chat pour répondre aux demandes des utilisateurs, Dialogflow permet aux utilisateurs d'exprimer leurs demandes par le biais d'une conversation normale.

Fonctionnement

Une fois que vous avez créé une application Google Chat compatible avec Dialogflow, vous pouvez la rendre disponible pour les éléments suivants :

• Grand public. Les utilisateurs Google Workspace disposant d'une licence peuvent télécharger votre application via Google Workspace Marketplace.
• Domaine Google Workspace. Un administrateur Google Workspace peut spécifier les applications que les utilisateurs peuvent ajouter à Google Chat.
• Testeurs d'applications. Lorsque vous testez votre application, vous pouvez en restreindre l'accès.

Dans Google Chat, un utilisateur peut avoir une conversation directe avec votre application ou l'appeler depuis un espace. Cela déclenche les événements suivants :

1. Un utilisateur envoie un message à une application Chat.
2. Google Chat envoie une requête JSON à l'application Chat, qui peut être hébergée dans Cloud Functions.
3. L'application Chat reçoit la requête JSON et l'analyse. Lors de cette analyse, l'application Chat appelle Dialogflow.
4. L'application Chat envoie une requête à Dialogflow qui inclut le texte du message en langage naturel de l'utilisateur.
5. Dialogflow interprète le texte de l'utilisateur et envoie une réponse à l'application Chat.
6. L'application Chat analyse la réponse de Dialogflow et envoie une réponse JSON à Google Chat.
7. Google Chat reçoit la réponse JSON de l'application Chat et affiche une réponse sous la forme d'un message texte, d'un message de fiche ou d'un message de dialogue dans l'interface utilisateur.
8. Google Chat partage cette réponse telle quelle ou présente une réponse enrichie à l'aide d'une interface utilisateur basée sur des fiches.

Cette page explique comment intégrer Dialogflow à Google Chat et configurer des réponses de chat enrichies.

Remarque : Google Chat s'appelait auparavant Hangouts Chat, et les applications Chat s'appelaient auparavant Chatbots. Bien que Google Chat et la Google Cloud console utilisent le terme applications, la console Dialogflow utilise toujours le terme bots.

Limites

Avec les intégrations Google Chat, un agent Dialogflow ne peut utiliser que la langue par défaut de l'agent.

Avant de commencer

Seuls les utilisateurs Google Workspace disposant d'une licence peuvent utiliser les applications Google Chat. Votre administrateur Google Workspace doit procéder comme suit :

• Ajouter un compte Google Workspace pour vous.
• Autoriser les utilisateurs à installer des applications Chat.

Créer un agent Dialogflow

Si vous n'avez pas encore créé d'agent Dialogflow, mais que vous souhaitez voir comment un agent interagit avec Google Chat, suivez ce guide de démarrage rapide pour créer un agent simple. Ne supprimez pas l'agent. Ensuite, nous allons configurer l'agent avec une interface Google Chat.

Configurer Google Chat

Pour configurer votre agent Dialogflow avec Google Chat, vous pouvez utiliser l'un des éléments suivants :

• Console Dialogflow
• Google Cloud Console

Configurer Google Chat à l'aide de la console Dialogflow

Pour intégrer Google Chat à l'aide de la console Dialogflow, procédez comme suit :

1. Accédez à la console Dialogflow ES.
2. Dans le menu de gauche, sélectionnez un projet Dialogflow.
3. Cliquez sur Integrations (Intégrations).
4. Cliquez sur Google Chat. Si Google Chat ne figure pas parmi les options, consultez la section Résoudre les problèmes.
5. Sélectionnez les personnes autorisées à accéder à l'application.
6. [Facultatif] Sélectionnez un environnement pour exécuter l'agent.
7. Cliquez sur Démarrer.

Votre application Google Chat est désormais en ligne et disponible pour les personnes que vous avez sélectionnées.

Pour configurer l'application, cliquez à nouveau sur Google Chat, puis sur CONFIGURER LES DÉTAILS DU BOT. La page de la console de l'API Google Chat s'affiche, où vous pouvez configurer les paramètres de l'application, comme l'avatar de l'application. Google Cloud

Configurer Google Chat à l'aide de la Google Cloud console

Pour intégrer Google Chat à l'aide de la Google Cloud console, procédez comme suit :

1. Sélectionnez le projet Dialogflow.

   Accéder au sélecteur de projet

2. Cliquez sur .

3. Cliquez sur API et services, puis sur Bibliothèque.

4. Recherchez et cliquez sur API Google Chat.

5. Cliquez sur Activer.

6. Cliquez sur l'onglet Configuration.

7. Configurez l'application.

8. Dans le volet Visibilité, sélectionnez les personnes autorisées à accéder à l'application :

   • Testeurs d'applications. Sélectionnez Rendre ce chat disponible pour des personnes spécifiques , puis saisissez leurs adresses e-mail.
   • Grand public ou domaine Google Workspace Enterprise. Publiez l'application.

9. Cliquez sur Enregistrer. Votre application Google Chat est désormais en ligne et disponible pour les personnes que vous avez sélectionnées.

Test

Avant de tester votre application Chat, assurez-vous de l'avoir démarrée, comme décrit dans Configurer Google Chat.

Vous pouvez tester votre application à l'aide de l'une des méthodes suivantes :

• Discuter directement avec l'application
• Appeler l'application depuis un espace

Discuter directement avec l'application

1. Ouvrez Google Chat.
2. Dans le volet Chat , cliquez sur + , puis sélectionnez Rechercher des applications.
3. Recherchez et sélectionnez votre application. Si Google Chat ne répertorie pas votre application, consultez la section Résoudre les problèmes.
4. Cliquez sur Chat.
5. Dans le champ de saisie du chat, saisissez une expression en langage naturel pour tester l'application.

Appeler l'application depuis un espace

1. Ouvrez Google Chat.
2. Dans le volet Espaces , cliquez sur + , puis sélectionnez Créer un espace.
3. Saisissez le nom de l'espace Test.
4. Cliquez sur Créer.
5. Dans le champ de saisie du chat, saisissez @ , puis sélectionnez votre application pour compléter automatiquement le nom.
6. Après le nom de l'application complété automatiquement, saisissez une expression en langage naturel pour tester l'application.

Résoudre les problèmes

Erreur	Solution
La page "Intégrations" de la console Dialogflow ES n'affiche pas Google Chat comme option.	Essayez d'actualiser la page : dans le menu de gauche, cliquez sur Intents, puis sur Integrations (Intégrations).
Google Chat ne répertorie pas votre application comme disponible.	Assurez-vous que votre administrateur Google Workspace a ajouté un compte Google Workspace pour vous et a autorisé les utilisateurs à installer des applications Chat. Ensuite, assurez-vous d'avoir démarré l'application Chat, comme décrit dans Configurer Google 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 sous forme de messages texte. 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 au message texte 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 plate-forme 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"
},

Fiches

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

Images

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

Charge utile personnalisée

**Remarque** : Cette intégration n'est pas compatible avec les actions de fiche.

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.

Remarque : Lorsque vous copiez et collez les exemples du guide de référence dans le champ de charge utile personnalisée de Dialogflow, assurez-vous que l'éditeur ne contient aucune erreur causée par lint. Vous ne pouvez pas tester les résultats dans le simulateur Dialogflow, mais vous pouvez les tester directement dans Google Chat.

Voici un exemple de charge utile personnalisée au format Cards v1 :

{
  "hangouts": {
    "header": {
      "title": "Pizza Delivery Customer Support",
      "subtitle": "[e-mail]",
      "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/..."
              }
            }
          }
        }]
      }]
    }]
  }
}

Arrêter l'application Chat

Pour empêcher l'application Google Chat d'être disponible, vous pouvez utiliser l'un des éléments suivants :

• Console Dialogflow

• Google Cloud Console

Arrêter l'application Chat à l'aide de la console Dialogflow

1. Accédez à la console Dialogflow ES.
2. Dans le menu de gauche, sélectionnez un projet Dialogflow.
3. Cliquez sur Integrations (Intégrations).
4. Cliquez sur Google Chat. Si Google Chat ne figure pas parmi les options, consultez la section Résoudre les problèmes.
5. Cliquez sur Arrêter.

Arrêter l'application Chat à l'aide de la Google Cloud console

1. Sélectionnez le projet Dialogflow dans la Google Cloud console.

   Accéder au sélecteur de projet

2. Cliquez sur .

3. Cliquez sur API et services, puis sur Bibliothèque.

4. Recherchez et cliquez sur API Google Chat.

5. Cliquez sur Gérer.

6. Cliquez sur l'onglet Configuration.

7. Dans le champ État de l'application, sélectionnez DÉSACTIVÉ.

En savoir plus

Pour en savoir plus sur l'utilisation de Google Chat, consultez les ressources suivantes :

• Documentation pour les développeurs de l'API Google Chat
• Créer un module complémentaire Google Workspace qui étend Google Chat
• Vidéo : Intégrer Dialogflow à Google Chat
• Atelier de programmation : Intégrer Dialogflow à Google Chat