Une intégration gère les interactions des utilisateurs finaux à votre place. Il vous suffit de créer un agent, éventuellement d'implémenter un webhook et de configurer l'intégration.
Ce guide vous explique comment utiliser l'intégration de Dialogflow Messenger pour fournir à votre agent une interface utilisateur de chat textuel simple.
Avant de commencer
Si vous ne prévoyez pas d'utiliser d'intégration, vous pouvez ignorer ce guide de démarrage rapide.
Avant de lire ce guide, procédez comme suit :
- Consultez les principes de base de Dialogflow CX.
- Effectuez la procédure de configuration.
- Suivez la procédure décrite dans le guide de démarrage rapide Créer un agent. Les étapes ci-dessous continuent d'utiliser le même agent. Si vous n'avez plus cet agent, vous pouvez le télécharger et le restaurer.
Préparation
Pour configurer un accès non authentifié à votre agent Dialogflow Messenger:
- 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.
- Dans Dialogflow Messenger, cliquez sur Connect (Se connecter).
- Une boîte de dialogue de configuration s'ouvre.
- Si l'intégration a déjà été configurée pour cet agent, vous verrez du code HTML intégrable. Que vous souhaitiez activer l'authentification ou non, cliquez sur le bouton Désactiver... en bas de la boîte de dialogue. Vous pourrez ainsi reconfigurer les paramètres à l'étape suivante.
- Sélectionnez un environnement.
- Sélectionnez API non authentifiée.
- Sélectionnez un style.
- Limiter l'accès au domaine (facultatif)
- Cliquez sur Activer l'API non authentifiée.
- La boîte de dialogue affiche le code HTML intégrable qui peut être intégré à votre site Web. Copiez ce code.
- Cliquez sur OK.
Intégrée
Collez le code d'intégration que vous avez copié ci-dessus dans une page Web de votre site Web.
Les éléments HTML <script> et <df-messenger> doivent se trouver dans l'élément <body> de votre page.
Si vous utilisez une intégration authentifiée, définissez l'attribut oauth-client-id pour <df-messenger> sur votre ID client OAuth.
Mettez à jour tous les autres attributs qui doivent être mis à jour.
Pour autoriser les mises en page responsives, ajoutez également les éléments suivants à votre élément <head>:
<meta name="viewport" content="width=device-width, initial-scale=1">
Une fois l'intégration effectuée, vous pouvez interagir avec votre agent via la page Web en cliquant sur l'icône de chat en bas à droite.
Personnaliser
Vous pouvez personnaliser l'apparence et le comportement de cette interface utilisateur de nombreuses façons. Pour en savoir plus, consultez la documentation de Dialogflow Messenger.