IBM Cloud 7 - Chatbot avec Messenger, NodeJS, MariaDB

Présentation

Le Palais de l’Oiseau de Jade est un hôtel de luxe situé en Bretagne. Il souhaite améliorer son service en proposant à ses clients de réserver des chambres grâce à un Chatbot. L’application permettra d’enregistrer dans une base de données les réservations.
L’hôtel souhaite également pouvoir analyser ces données bien que l’équipe ne possède pas de compétences en développement.

 

La solution retenue est de déployer le Chatbot sur Facebook Messenger. Cet outil permet d’obtenir des graphiques en fonction de questions en langage naturel.

 Nous utilisons comme base de données MariaDB grâce à une application NodeJS.

 

 

 

 

Mise à jour:
10-18 Suppression de Watson Analytics
12-18 Migration vers cloud.ibm.com
03-19
  Migration sur MariaDB d’AWS RDS.
  Suppression de la région à la connexion.
  Ajout d’une interface

Watson Assistant

 

• Créer un service Watson Assistant nommé palais de l oiseau de jade Watson Assistant . Le nom du service est reconnu dans le manifest pour le déploiement de l’application nodeJS.
• Accéder à l’outil de lancement.

 

 

 

• Importer le Workspace workspace_palaisdeloiseaudejade.json dans le nouveau skill.

 

 

•  Explorer l’interface. J’ai utilisé les propositions de “Content Catalog” pour élaborer ce Chatbot.
•  Essayer le chatbot. On pourra tester des phrases avec des mots clefs comme blague, bonjour, contact, horaire et réservation.

 

 

•  Modifier le message obtenu lorsqu’on demande les horaires.

 

 

Test de l'API Watson Assistant

• Récuperer l’url et les identifiants de l’API Watson Assistant.

 

• Utiliser une application REST comme Postman  pour tester votre chatbot avec les identifiants fournis.

 

Méthode POST 
URL  URL?version=2018-08-07
Dans Authorization ->Basic auth->  username et password
Dans Body -> raw -JSON-> {"input":{"text":"coucou"}}

• On envoie “coucou”. Le chatbot répond “Bonjour, en quoi puis-je vous aider ?”.

 

POST 1

 

• Il faut copier le context du JSON reçu pour poursuivre le dialogue.

  {"input":{"text":"réservation"}, "context": {##à remplacer##}}

 

POST 2

 

MariaDB

• Créer un service RDS MariaDB avec RosettaHub( lien valide uniquement pour Dauphine M2 SITN) en se dirigeant vers la console AWS.

 

• Modifier le groupe de sécurité pour autoriser l’adresse ip 0.0.0.0/0 à se connecter. (On autorise toutes les adresses, à éviter !)

 

• Se connecter grâce à Adminer à l’instance MariaDB avec vos identifiants RDS et l’adresse du point de terminaison.
• Créer la base de données poj

 

 

 

Application NodeJS

• Cliquer sur le bouton Deploy to IBM Cloud du dépôt GitHub.

• Créer l’API Key et déployer.

 

• Observer le déploiement dans la chaine de distribution

 

• Echec sur le déploiement de l’application, c’est normal.

 

 

• Modifier les variables suivantes dans le dépot GIT de la chaine d’outils. 

var myWatsonWorkspace = "";
var myWatsonPassword = "";

var myRDSHost ="";
var myRDSLogin ="";
var myRDSPassword ="";

 

 

• L’application se redeploie automatiquement au commit de Git.

 

• Une fois déployée, accéder à l’application depuis votre tableau de bord.
• Vous obtenez l’interface suivante et pouvez tester le chatbot.

 

Optionnel - Déploiement en ligne de commande

 

Si l’étape précédente ne fonctionne pas ou pour découvrir un autre moyen de déployer son application.

• Télécharger le code depuis le dépôt Github et le décompresser.
• Modifier app.js avec les identifiants.
• Installer le client IBM Cloud
• Ouvrir une invite de commande (CMD sous windows) et se connecter à IBM Cloud.

bx login

• En se placant dans le répertoire contenant le code, executer :

bx cf push

 

 

 

Debogage - Journaux de l'app

• Installer le client IBM Cloud
• Ouvrir une invite de commande (CMD sous windows) et se connecter à IBM Cloud.

bx login

• Afficher les logs de l’application en remplacant le nom de celle-ci dans la ligne de commande. On observe dans le cadre l’affichage de la réponse de Watson Assistant.

bx cf logs palais-de-l-oiseau-de-jade-nodejs --recent

 

 

Facebook Messenger

 

• Réaliser une page Facebook dédiée au chatbot.
• Se connecter à Facebook Developer.
• Ajouter une application.
• Ajouter le service Messenger.

 

• Générer un token en selectionant votre page, accepter les autorisations.

 

 

• Ajouter ce token à myFacebookToken dans app.js en accédant à votre dépôt Git (menu devOps). Le token est dépendant de la page Facebook.
•  Sauvegarder le fichier. L’application se redéploit automatiquement à la sauvegarde. On pourra vérifier le bon fonctionnement dans la pipeline de distribution.
• Configurer les webhooks, ajouter l’url de votre application  avec /webhook à la fin et cocher les cases correspondantes.

 

 

 

 

 

Si l’url webhook ne fonctione pas :

• Vérifier que l’application nodeJs fonctionne.
• Vérifier que /webhook est bien renseigné à la fin de l’url.
• Vérifier que le token Facebook est enregistré dans app.js et que l’application est redeployée.

 

 

• Séléctionner la page qui utilisera les webhook.

 

 

•  Ajouter une image pour l’application.

•  Ajouter une URL de politique de confidentialité pour publier votre application . https://frebourg.es/cgu

 

 

• Ajouter pages_messaging dans Messenger ->parametre->Contrôle app pour Messenger et envoyer la demande.

 

 

• Le chatbot répond au message. On pourra vérifier les logs (section debogage).

 

 

 

 

Réserver au Palais de l'Oiseau de Jade

 

Un magnifique hôtel au coeur de la Bretagne, dans une région reculée.

 

 

 

 

 

Il est temps de réserver !

 

• Demander au Chatbot de réaliser une réservation.
• Vérifier dans la base de données l’enregistrement de la réservation.
• Vérifier après confirmation les logs et déterminer les informations manquantes dans le flux de données d’une réservation (section debogage).

 

 

 

Demandes de l'hôtel

Problème dans le processus de réservation

Le Palais de l’Oiseau de Jade est obligé de rappeler les clients pour obtenir le nombre de jours de chaque réservation. Améliorer le processus de réservation.

• Améliorer l’application en prenant en compte le nombre de jours de réservation.
  • Modifier le dialogue du chatbot pour prendre en compte cette nouvelle variable.
  • Ajouter une variable de contexte à la reconnaissance de la variable numérique.
  • Tester le chatbot.
  • Modifier le fichier app.js de l’application NodeJs depuis le dépôt Git.
  • Réaliser une réservation via Messenger.
  • Vérifier l’ajout du nombre de jours dans la base de données.

Exemple d’ajout d’une variable de context, en cliquant sur JSON editor, insérer le code encadré au bon endroit dans le dialogue.

 

• Proposer des options comme Assurance annulation, Pack Romantique , Bouquet de fleurs, Accès au SPA, Massage, Repas Gourmand ou Location de vélos.
  • Ajouter une entité des différentes options dans le chatbot.
  • Modifier le dialogue pour prendre en compte cette entité en ajoutant une variable de context.
  • Tester le chatbot.
  • Ajouter une colonne option dans la table reservation de la base de données (Mariadb).
  • Modifier le fichier app.js pour inserer l’option choisie.
  • Réaliser une réservation via Messenger.
  • Vérifier l’ajout de l’option dans la base de données.

 

Une application réaliste

Pour être à la hauteur des exigences de ses clients, le Palais de l’Oiseau de Jade doit proposer un Chat-bot performant. Il semble nécessaire d’afficher le prix des options et de la réservation du client avant la confirmation. L’application doit également récupérer les coordonnées des clients, voir les enregistrer pour une future réservation avec un numéro que l’on devra leur fournir.

• Ajouter un prix par option.
  • Modifier la base de données en ajoutant une nouvelle table option avec les prix.

• CREATE TABLE IF NOT EXISTS `options` (
   `id` int(11) NOT NULL AUTO_INCREMENT,
   `libelle` varchar(50) DEFAULT NULL,
   `prix` double NOT NULL,
   PRIMARY KEY (`id`)
  ) ENGINE=InnoDB AUTO_INCREMENT=7 DEFAULT CHARSET=latin1;
  
  INSERT INTO `options` (`id`, `libelle`, `prix`) VALUES
  (1, 'Assurance annulation', 50),
  (2, 'Pack Romantique', 60),
  (3, 'Bouquet de fleurs', 15),
  (4, 'Massage', 90),
  (5, 'Repas Gourmand', 150),
  (6, 'Location de vélos', 40);alter table reservation add column id_options int;

  • Modifier l’application pour renvoyer le prix correspondant au chatbot. 
  • Modifier le chatbot pour afficher le prix.
  • Insérer l’option choisi dans la table réservation.

• Donner le prix de la réservation au client et enregistrer celui-ci dans la base.
  • Modifer la base de données en ajoutant une table de liaison qui enregistre les options choisies pour une réservation.
  • Modifier l’application pour calculer le prix total.
  • Modifier le chatbot pour afficher le prix.
  • Insérer les options en fonction de la réservation dans la base depuis l’application après la confirmation.

 

• Permettre l’ajout des prix des chambres selon la catégorie.

 

What else ?

Ces tutoriels peuvent vous intéresser :
https://developer.ibm.com/recipes/author/l-frebourg/