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
- Cette intégration n'est compatible qu'avec les entrées textuelles dans la langue par défaut de l'agent
Configurer Google Chat
Pour configurer l'intégration Google Chat pour votre agent, vous devez disposer des éléments suivants :
- Compte Google Workspace ayant accès à Google Chat.
- Un Google Cloud projet.
Activer l'API Google Chat
Avant d'utiliser les API Google, vous devez les activer dans un Google Cloud projet. Vous pouvez activer une ou plusieurs API dans un seul Google Cloud projet.
Dans la https://console.cloud.google.com/console Google Cloud, activez l'API Google Chat et l'API Dialogflow.
Vérifiez que vous activez les API dans le bon projet Cloud, puis cliquez sur Suivant.
Vérifiez que vous activez les bonnes API, puis cliquez sur Activer.
Configurer à partir de Dialogflow CX
- Accédez à la console Dialogflow CX.
- Sélectionnez votre Google Cloud projet.
- Sélectionnez votre agent.
- Sélectionnez l'onglet Gérer.
- Cliquez sur Intégrations dans le menu de la barre latérale gauche.
- Cliquez sur Se connecter sur Google Chat.
- Renseignez les informations obligatoires suivantes :
- Nom : nom affiché aux 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 d'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.
- Nom : nom affiché aux 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,
- Sélectionnez un environnement , le cas échéant.
- Saisissez des adresses e-mail pour rendre cette application de chat accessible à certains utilisateurs et groupes, le cas échéant.
- Cliquez sur Démarrer.
Tests
Pour tester l'application configurée, mentionnez-la dans un espace Google Chat ou envoyez-lui un message privé. Par exemple,
- Ouvrez Google Chat.
- Cliquez sur Nouveau chat.
- Dans le champ Ajouter une ou plusieurs personnes, saisissez le nom de votre application de chat.
- Sélectionnez votre application de chat dans les résultats. Un message privé s'ouvre.
Messages de réponses enrichies
Les messages de réponses enrichies sont compatibles avec Charge utile personnalisée dans Fulfillment. Pour connaître le format des messages, consultez l' API de messages Google Chat.
Message texte
La charge utile personnalisée suivante fournit un message Google Chat :
{
"text": "Hello, world"
}
La charge utile personnalisée suivante fournit un Google Chat message texte si vous utilisez un module complémentaire Chat :
{
hostAppDataAction: {
chatDataAction: {
createMessageAction: {
message: {
text: "Your pizza delivery is here!"
}
}
}
}
}
Message avec carte
La charge utile personnalisée suivante fournit un message avec carte 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 avec carte 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 au canal
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.
Articles associés
- Créez une application Google Chat Dialogflow CX qui comprend le langage naturel et l'utilise pour répondre
- Étendre Google Chat à l'aide de modules complémentaires Workspace
- Utiliser des objets d'événement pour déclencher des fonctions
- Envoyer des messages Google Chat