Aller au contenu principal

Intégration - FAQ dynamique

Intégration - FAQ dynamique

Le champ de recherche de la FAQ dynamique est généré par un script javascript. Il peut également être constitué d'images et d'autres éléments en fonction de la personnalisation qui a été effectuée.

Code HTML

Pour intégrer la boîte de dialogue, ces fichiers doivent être hébergés sur un serveur de fichiers.

La page qui doit héberger la FAQ dynamique doit réserver un emplacement où s'afficheront la fieldbox et les résultats.

Généralement, une page dédiée est conservée pour ce module avec uniquement un en-tête et un pied de page non définis.

Un nœud HTML avec un identifiant doit être présent. This identifier will be used by javascript to build the graphic elements in the page.

Ci-dessous, un exemple de code HTML pour l'intégration de la fieldbox.

Ce fichier HTML est hébergé dans le même répertoire que le fichier chatbox.js.

La balise DOCTYPE en haut du fichier est absolument nécessaire au bon fonctionnement de la boîte de dialogue.

De plus, la balise script doit avoir l'attribut id=dydufieldbox.

Variables de contexte

Pour permettre l'identification de l'utilisateur et personnaliser les réponses, il est possible d'utiliser le moteur de dialogue ou d'afficher à l'opérateur Livechat des informations depuis le site lui-même :

  • Contenu des éléments de la page :

    • montant du panier ;

    • nom de l'utilisateur ;

    • code d'erreur actuellement affiché ;

    • etc.

    • Valeurs variables ou fonctions javascript ;

    • Valeurs des cookies.

La récupération de ces informations ne nécessite généralement pas d'éditer le site qui comprend la boîte de dialogue, sauf si vous souhaitez récupérer des informations qui ne sont pas présentes au moment de l'intégration.

La déclaration des variables de contexte se fait de cette manière :

getMontantPanier est la fonction javascript qui obtient le nom de cette boutique.

Il peut être défini soit dans la boîte de dialogue, soit par un autre script s'il est chargé sur les mêmes pages que la boîte de dialogue.

L'écriture de fonctions pour les variables de contexte peut être effectuée par les équipes du client ainsi que par nos équipes.

Débogage

Pour vérifier si les variables de contexte sont fonctionnelles, rendez-vous sur la page où la FAQ dynamique a été intégrée et posez n'importe quelle question dans la fieldbox.

Dans l'onglet Réseau du panneau Outils de développement, vous devez localiser la dernière requête talk

Dans la liste des paramètres, recherchez le paramètre contextVariables.

Cette liste doit inclure la liste des variables de contexte qui ont été enregistrées dans DYDUServlet, avec leur valeur encodée en base64.

Dans cet exemple, vous pouvez voir deux variables first_name et last_name:

  • first_name is Sm9obg== base64 ("John");

  • last_name is RG9v== base64 ("Doo").

Navigateur Web de bureauVersionComptabilité
Microsoft Edge≥ 80Total
Mozilla Firefox≥ 68Total
Apple Safari≥ 13.0Total
Google Chrome≥ 83Total
Borne mobileVersionComptabilité
iOs≥ 10Total
Android≥ 6.0Total

Le bon fonctionnement des éléments suivants doit être vérifié :

  • Le champ de saisie ;

  • Le bouton d'envoi ;

  • Saisie semi-automatique : suggestion lors de la rédaction.

Lorsqu'une question est posée, vous devriez voir :

  • Les sujets des FAQ proposées ;

  • Les titres des FAQ ;

  • Réponses associées ;

  • Satisfaction (facultative – et uniquement sur les FAQ liées à la base de connaissances, c'est-à-dire qu'elle ne concerne pas les FAQ issues de l'indexation externe).

Intéractions

  1. Poser une question

Il faut tester ce processus en envoyant la requête soit par la saisie de la touche Entrée soit en cliquant sur le bouton Demander.

  1. Rediriger le lien vers une autre connaissance

Certaines connaissances peuvent contenir un lien dans leur réponse pour permettre l'accès à une autre connaissance, il faut donc identifier une connaissance à l'aide de ces liens de redirection et vérifier que l'utilisation de ce lien affiche la connaissance ciblée.

  1. Lien vers une autre page

Certaines connaissances peuvent contenir dans leur réponse un lien permettant d'accéder à une autre page du site, il est nécessaire d'identifier une connaissance utilisant ces liens et de vérifier que l'utilisation de ce lien entraîne le changement de page. Le clic sur ce type de lien provoque une requête vers le serveur de dialogue de manière à suivre l'utilisation qui en est faite par les internautes.

  1. Champ de saisie vide

Quand le champ de saisie est vide, il ne doit pas être possible de soumettre la requête au serveur, cela aussi bien par l'appui de la touche Entrée dans le champ de saisie que par le bouton d'envoi. Ce bouton d'envoi doit également être grisé ou inactif.

  1. Arbres de décision

Lorsqu'une connaissance comporte un arbre de décision, il faut vérifier qu'un clic sur les icônes "+" affiche les réponses des sous-branches.

  1. URL de redirection

Lorsqu'une connaissance est configurée avec une URL de redirection, vérifiez que le titre de la FAQ devient cliquable ou qu'un lien cliquable apparaît à côté de la FAQ.

  1. URL de la question posée

Vous devez vérifier que l'URL de la page de la question posée utilise les termes de la question.

  1. Retours et changements de page

Lorsque deux questions sont posées l'une après l'autre, le retour à la page précédente doit réafficher la première question. Cela devrait également être le cas lors du changement de page et du retour à la question posée.