Google Chat

L'intégration Google Chat de 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 Google Chat pour votre agent, vous devez disposer des éléments suivants :

Activer l'API Google Chat

Avant d'utiliser les API Google, 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 API appropriées, puis cliquez sur Activer.

Configurer à partir de Dialogflow CX

  1. Accédez à la console Dialogflow CX.
  2. Sélectionnez votre projet Google Cloud .
  3. Sélectionnez votre agent.
  4. Sélectionnez l'onglet Gérer.
  5. Cliquez sur Integrations (Intégrations) dans le menu de la barre latérale gauche.
  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 le consomment (par exemple, dans les messages, la recherche et les @mentions). Par exemple, Dialogflow CX App.
    • URL de l'avatar : image de l'avatar affiché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. Par 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.
  8. Sélectionnez un environnement, le cas échéant.
  9. Saisissez les adresses e-mail pour rendre cette application Chat accessible à certains utilisateurs et groupes, le cas échéant.
  10. Cliquez sur Démarrer.

Tests

Pour tester l'application que vous avez configurée, mentionnez-la dans un espace Google Chat ou envoyez-lui un message privé. Par 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

Les messages de réponses enrichies sont acceptés à l'aide d'une charge utile personnalisée dans Fulfillment. Consultez la documentation de l'API Google Chat pour connaître le format des messages.

SMS

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

{
  "text": "Hello, world"
}

La charge utile personnalisée suivante fournit un message texte Google Chat si vous utilisez un module complémentaire 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 :

{
  "host_app_data_action": {
    "chat_data_action": {
      "create_message_action": {
        "message": {
          "cardsV2": [
            {
              "card_id": "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 aux chaînes

Une fois configurées, les réponses spécifiques au canal avec le canal DF_CX_GOOGLE_CHAT seront automatiquement utilisées lorsque l'agent répondra aux messages Google Chat.