L'intégration de Google Chat dans les agents conversationnels (Dialogflow CX) vous permet de créer des applications Google Chat avec une compréhension du langage naturel basée sur la technologie des agents conversationnels (Dialogflow CX).
Limites
- Cette intégration n'est compatible qu'avec la saisie de texte dans la langue par défaut de l'agent.
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 bon projet Cloud, puis cliquez sur Suivant.
Vérifiez que vous activez les API appropriées, puis cliquez sur Activer.
Configurer à partir d'agents de conversation (Dialogflow CX)
- Accédez à 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 requises suivantes :
- Nom: nom affiché aux utilisateurs qui interagissent avec le contenu créé par cette application ou qui le consomment (par exemple, dans les messages, la recherche et les @mentions). Par exemple,
Conversational Agents (Dialogflow CX) App. - URL de l'avatar: image de l'avatar qui s'affiche pour les 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 qui 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 à des personnes et groupes spécifiques, le cas échéant.
- Cliquez sur Démarrer.
Tests
Pour tester votre 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 Chat.
- 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 via une charge utile personnalisée dans Fulfillment. Pour connaître le format de message, consultez la section API de messages Google Chat.
SMS
La charge utile personnalisée suivante fournit un message texte Google Chat:
{
"text": "Hello, world"
}
Message de la fiche
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 Conversational Agents (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'
}
}
}
]
}
}
]
}
]
}
}]
}
Réponses spécifiques à la chaîne
Une fois 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.