Google Chat

L'intégration de Google Chat à Dialogflow CX vous permet de créer des applications Google Chat avec une compréhension du langage naturel basée sur la technologie Dialogflow CX.

Limites

Configurer Google Chat

Pour configurer l'intégration de Google Chat pour votre agent, vous aurez besoin des éléments suivants :

Activer l'API Google Chat

Avant d'utiliser les Google APIs, vous devez les activer dans un projet Google Cloud. Vous pouvez activer une ou plusieurs API dans un même projet Google Cloud.

  1. Dans https://console.cloud.google.com/, activez l'API Google Chat et l'API Dialogflow.
  2. Vérifiez que vous activez les API dans le bon projet Cloud, puis cliquez sur Suivant.
  3. Vérifiez que vous activez les bonnes API, puis cliquez sur Activer.

Configurer depuis Dialogflow CX

  1. Accédez à la console Dialogflow CX.
  2. Sélectionnez votre projet Google Cloud .
  3. Sélectionnez votre agent.
  4. Accédez à l'onglet Gérer dans le menu de navigation.
  5. Sélectionnez Intégrations.
  6. Cliquez sur Connecter sur Google Chat.
  7. Renseignez les informations obligatoires suivantes :
    • Nom : nom affiché pour les utilisateurs qui interagissent avec le contenu créé par cette application ou qui le consomment (par exemple, dans les messages, la recherche et les @mentions). Exemple : Dialogflow CX App.
    • URL de l'avatar : image d'avatar présentée aux utilisateurs qui interagissent avec l'application. Indiquez une URL HTTPS qui héberge une image PNG carrée (format 1:1). Taille minimale recommandée : 256 x 256 pixels. Exemple : https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png.
    • Description : description de l'application. Par exemple, A helpful bot that responds to real human conversation.
    • Environnement : environnement auquel se connecter. Sélectionnez un environnement, le cas échéant.
  8. Saisissez des adresses e-mail pour rendre cette application Chat accessible à certains utilisateurs et groupes, le cas échéant.
  9. Cliquez sur Démarrer.

Tests

Pour tester votre application configurée, mentionnez-la dans un espace Google Chat ou envoyez un message privé.

Exemple :

  1. Ouvrez Google Chat.
  2. Cliquez sur New chat (Nouveau chat).
  3. Dans le champ Ajouter une ou plusieurs personnes, saisissez le nom de votre application Chat.
  4. Sélectionnez votre application Chat dans les résultats. Un message privé s'ouvre.

Messages de réponses enrichies

Vous pouvez accepter les messages de réponse enrichis à l'aide d'une charge utile personnalisée dans le fulfillment. Pour en savoir plus sur le format des messages, consultez l'API Google Chat Message.

SMS

La charge utile personnalisée suivante fournit un message Google Chat :

{
  "text": "Hello, world"
}

Si vous utilisez un module complémentaire Chat, la charge utile personnalisée suivante fournit un message texte Google Chat :

{
  "hostAppDataAction": {
    "chatDataAction": {
      "createMessageAction": {
        "message": {
          "text": "Your pizza delivery is here!"
        }
      }
    }
  }
}

Message de la carte

La charge utile personnalisée suivante fournit un message de fiche Google Chat :

{
  "cardsV2": [{
    "cardId": "createCardMessage",
    "card": {
      "header": {
        "title": "A card message!",
        "subtitle": "Sent from Dialogflow CX",
        "imageUrl": "https://developers.google.com/chat/images/chat-product-icon.png",
        "imageType": "CIRCLE"
      },
      "sections": [
        {
          "widgets": [
            {
              "buttonList": {
                "buttons": [
                  {
                    "text": "Read the docs!",
                    "onClick": {
                      "openLink": {
                        "url": "https://developers.google.com/workspace/chat"
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  }]
}

La charge utile personnalisée suivante fournit un message de fiche Google Chat si vous utilisez un module complémentaire Chat :

{
  "hostAppDataAction": {
    "chatDataAction": {
      "createMessageAction": {
        "message": {
          "cardsV2": [
            {
              "cardId": "basic1",
              "card": {
                "header": {
                  "title": "This is a card!",
                  "subtitle": "Sent from Conversational Agents (Dialogflow CX)",
                  "imageUrl": "https://developers.google.com/chat/images/chat-product-icon.png",
                  "imageType": "CIRCLE"
                },
                "sections": [
                  {
                    "widgets": [
                      {
                        "buttonList": {
                          "buttons": [
                            {
                              "text": "Open Google!",
                              "color": {
                                "red": 0.101960786,
                                "green": 0.4509804,
                                "blue": 0.9098039
                              },
                              "onClick": {
                                "openLink": {
                                  "url": "http://google.com"
                                }
                              }
                            }
                          ]
                        }
                      }
                    ]
                  }
                ]
              }
            }
          ]
        }
      }
    }
  }
}

Réponses spécifiques au canal

Lorsqu'elles sont configurées, les réponses spécifiques au canal avec le canal DF_CX_GOOGLE_CHAT sont automatiquement utilisées lorsque l'agent répond aux messages Google Chat.