Dec 29, 2017 4:51:11 PM Pierre LEVY avatar   763    

Intégrer un chatbot Recast dans un site Lutece

Logo Recast

Introduction

Ce guide présente la façon d'intégrer un Chatbot propulsé par la plate-forme Recast.ai dans un site Lutece.

vue du bot

Trois modes d'intégration sont envisageables :

  • mode 1 : Le chat se présente sous la forme d'une page Web (XPage classique)
  • mode 2 : Le chat se présente dans une une popup qui s'ouvre par un bouton en bas à droite de n'importe quelle page du site
  • mode 3 : Le chat est intégré en iframe dans un autre site

Pour intégrer un bot Recast la seule information nécessaire est l' Access Token de celui-ci.

Création du site

Composants nécessaires

Les plugins nécessaires sont :

  • Le plugin ChatBot qui propose l'interface conversationnelle utilisateur en mode page web, popup ou contenu à intégrer en iframe. Cette interface n'est pas liée à Recast et peut être utilisée avec d'autres chatbot.
  • Le plugin Recast qui assure la communication avec la plate-forme Recast en encapsulant notamment les appels à l'API DIalog. Par ailleurs, ce plugin permet d'interpréter tous les types de message de réponse spécifiques à Recast : card, quickReplies, picture, video, ...
  • Le plugin Recast Bots qui permet de créer des instances de bots et les publier sur l'interface du plugin ChatBot.

Création du POM de site

Pour créer le POM de site, vous pouvez utiliser le service LuteceTools https://dev.lutece.paris.fr/incubator/jsp/site/Portal.jsp?page=createsitepom

Ajouter ainsi les plugins suivants :

plugin-chatbot
plugin-recast
plugin-recastbots

Génération de la WebApp du site

Dans le répertoire contenant le POM du site précédemment créé. Lancer le build du site avec la commande Maven suivante :

mvn lutece:site-assembly

Configuration et lancement de la WebApp

Dans le fichier WEB-INF/conf/db.properties configurer le nom de la base, et les information user/password pour y accéder.

Ensuite lancer la commande Maven permettant de jouer le script de création de la base :

mvn antrun:run

Configurer votre Tomcat pour pointer sur la WebApp et lancer le.

Administration et utilisation

Déclarer un bot Recast dans le Back Office de Lutece

Dans le BackOffice de Lutece accessible à l'adresse suivante :

http://myhost/jsp/admin/AdminLogin.jsp

et en utilisant le compte par défaut admin/adminadmin.

Sélectionner dans le menu "Gérer les bots Recast"' puis cliquer sur Ajouter un bot et remplir les champs suivants :

Déclaration du Bot

Utilisation du Bot

Mode 1 : page web

L'accès à la page web se fait via l'URL suivante :

http://myhost/jsp/site/Portal.jsp?page=chatbot

Mode 2 : Intégration via une popup

Cette intégration se fait en ajoutant le bookmark du PageInclude proposé par le plugin ChatBot dans le gabarit HTML du site (fichier WEB-INF/templates/site/page_frameset.html). Il faut donc ajouter la ligne suivante dans ce fichier avant la fermeture de la balise body.

${chat_popup_include}

Mode 3 : Intégration IFRAME

L'URL à mettre en source de l'IFRAME est la suivante :

https://myhost/jsp/site/Portal.jsp?page=chatbot&view=bot&bot=mybot&standalone=true&lang=fr