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
- Seule la saisie de texte dans la langue par défaut de l'agent est compatible avec cette intégration.
Configurer Google Chat
Pour configurer l'intégration de Google Chat pour votre agent, vous devez disposer des éléments suivants:
- Compte Google Workspace ayant accès à Google Chat.
- un projet Google Cloud ;
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.
Dans la console Google Cloud, activez l'API Google Chat et l'API Dialogflow.
Vérifiez que vous activez les API dans le projet Cloud approprié, puis cliquez sur Next (Suivant).
Vérifiez que vous activez les API appropriées, puis cliquez sur Activer.
Configurer depuis Dialogflow CX
- Accéder à la console Dialogflow CX
- Choisissez votre projet Google Cloud.
- Sélectionnez votre agent.
- Sélectionnez l'onglet Gérer.
- Cliquez sur Integrations (Intégrations) dans le menu de la barre latérale gauche.
- Cliquez sur Se connecter dans Google Chat.
- Renseignez les informations obligatoires suivantes :
- Nom: nom présenté 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: avatar qui s'affiche pour les utilisateurs qui interagissent avec l'application. Spécifiez 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 présenté 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 afin de rendre cette application Chat disponible pour des personnes et des groupes spécifiques, 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 MP. Par exemple,
- Ouvrez Google Chat.
- Cliquez sur Nouveau chat.
- Dans le champ Ajouter une ou plusieurs personnes, saisissez le nom de votre application Chat.
- Sélectionnez votre application Chat dans les résultats. Un message privé s'affiche.
Messages de réponses enrichies
Les messages de réponses enrichies sont compatibles avec l'utilisation de la charge utile personnalisée dans Fulfillment. Consultez la section API de messages 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"
}
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',
'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'
}
}
}
]
}
}
]
}
]
}
}]
}
Réponses spécifiques aux canaux
Une fois configurées, les réponses spécifiques au canal associées au canal DF_CX_GOOGLE_CHAT sont automatiquement utilisées lorsque l'agent répond aux messages Google Chat.