Personnaliser Guide à l'aide de JavaScript

Pour utiliser Guide avec votre site Web, vous pouvez simplement intégrer Guide sur chaque page de votre site Web où vous souhaitez offrir un engagement.

Toutefois, si vous connaissez bien le développement Web et que vous souhaitez personnaliser l'apparence et le comportement du widget Guide, vous pouvez le faire en utilisant des appels d'API Interface de programmation d’applications. Vous permet d’automatiser certaines fonctionnalités en connectant votre système NiCE CXone à d’autres logiciels. vers le code JavaScript. Voici les types de changements que vous pouvez apporter :

• Apparence et comportement du widget Guide : Personnalisez l'apparence et le comportement du widget Guide. Il s’agit notamment de modifier la taille du gadget logiciel ou la taille des boutons, d’afficher le gadget logiciel en mode plein écran, etc.

• Préférences de clavardage lorsqu'il est offert dans le widget Guide : Personnalisez l'apparence et le comportement du clavardage lorsqu'il est offert dans le widget Guide. Il s’agit notamment de modifier les informations contenues dans la fenêtre de clavardage, de modifier l’apparence de la fenêtre de clavardage, de définir des feuilles de style CSS personnalisées, etc.

• Préférences de Reporting : Personnalisez la façon dont Guide suit les engagements et les conversions. Vous pouvez utiliser ces API pour définir des événements personnalisés, stocker des variables relatives aux visiteurs, stocker des données de conversion, attribuer et supprimer des balises Web, etc.

Comprendre le fonctionnement de Guide

Le widget Guide est un module Web que le NiCE CXone Loader charge sur votre site Web. Le module Web contient une application JavaScript construite à l’aide du cadre Svelte. L'application utilise des magasins d'états de base qui assurent le suivi de la configuration Guide, du modèle actif, de l'état du clavardage actif, de l'état de l'interface utilisateur, etc. Les valeurs de ces magasins d’états déterminent ce qui est affiché au visiteur.

Lorsque vous intégrez Guide sur une page de votre site Web et qu'un visiteur consulte la page, Guide récupère la configuration spécifique à votre locataire. Cette demande renvoie un résultat JSON contenant des règles, des boutons, des points d’entrée, des traductions, des articles référencés et des indicateurs de fonctionnalité. Il utilise ensuite le moteur de règles intégré pour traiter les règles et les conditions qui peuvent ou non entraîner l'apparition d'un modèle ou d'une offre proactive sur la page.

Pour gérer les données des visiteurs entre les rechargements de pages, Guide utilise le stockage local et le stockage de session. Cela permet à Guide de fournir un soutien multidomaine sur les navigateurs pris en charge. Cela signifie également que Guide n’utilise pas de témoins de navigateur.

Ajouter des appels JavaScript

1. Cliquez sur le sélecteur d'applications et sélectionnez Guide.

2. Cliquez sur Intégrations. Une page apparaît avec le code JavaScript spécifique à votre locataire.

3. Cliquez sur Copy code with Guide pour copier le code.
4. Collez l'extrait de code copié dans votre code ou dans un programme d'édition de texte.

5. Juste au-dessus de la balise fermante </script> du code que vous avez collé, ajoutez les appels JavaScript à utiliser. Dans l'image d'exemple suivante, le commentaire indique où ajouter les appels.

   

   Pour obtenir des détails complets sur les appels que vous pouvez utiliser, consultez les API liées au widget Guide, les API liées au chat, et les API liées aux rapports.

6. Copiez et collez l’intégralité du script, y compris les balises d’ouverture et de fermeture <script>, dans l’en-tête d’une page de votre site Web.

7. Visitez la page modifiée et assurez-vous que les personnalisations Guide fonctionnent comme prévu.

8. Lorsqu’il a été entièrement testé et qu’il fonctionne comme prévu, copiez le script final dans l’en-tête de chaque page qui doit avoir cette personnalisation .

Configuration de la Langue à utiliser pour Guide

Pour outrepasser tous les paramètres de langue du navigateur et forcer les visiteurs de Guide à voir le contenu dans une langue précise, modifiez le script d'intégration. Ajoutez le paramètre locale à la commande cxone('guide','init'); à la fin du script, puis précisez la langue désirée. Par exemple, vous pouvez le configurer en français comme suit :

cxone('init','####'); 
cxone('guide','init', { locale: 'ja', templateId:'xxxxxxx'});

Remplacez #### par votre id du locataire à quatre chiffres.

Désactiver la mise en cache du formulaire de pré-chat

Par défaut, le widget Guide met en cache les données saisies dans les formulaires de contact de pré-chat et de pré-courriel dans le navigateur de l'utilisateur. Cela permet aux informations de persister d'un rechargement de page à l'autre ou lors de sessions ultérieures.

Cependant, dans certains environnements, en particulier ceux ayant des exigences de conformité, de confidentialité ou de sécurité, ce comportement peut ne pas être souhaitable. Vous pouvez désactiver ce comportement en utilisant l'indicateur de configuration disableFormCaching lors de l'initialisation du widget Guide.

Lorsque disableFormCaching n'est pas défini ou est défini sur false (par défaut) :

• Les données du formulaire de pré-chat sont mises en cache dans le navigateur.

• Les valeurs précédemment saisies peuvent apparaître automatiquement lorsque le widget se recharge ou qu'une nouvelle session commence

cxone('guide', 'init', { locale: 'en-US', disableFormCaching: false});

Lorsque disableFormCaching est défini sur true et si la page est actualisée, si le widget est rechargé, ou si l'utilisateur commence une nouvelle session :

• Les champs du formulaire de pré-chat sont vides.

• Les valeurs précédemment saisies ne sont pas restaurées.

Par conséquent, les utilisateurs doivent entrer de nouveau leurs informations de prédiscussion pour chaque nouvelle interaction.