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 proposer un engagement.

Toutefois, si vous êtes familiarisé avec 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 API Interface de programmation d’applications. Vous permet d’automatiser certaines fonctionnalités en connectant votre système NiCE CXone à d’autres logiciels. au code JavaScript. Vous trouverez ci-dessous les types de modifications réalisables :

• Apparence et comportement du widget Guide : Personnaliser l'apparence et le comportement du widget Guide. Cela inclut la modification de la taille du widget, la modification de la taille des boutons, l’affichage du widget en mode plein écran, etc.

• Préférences de chat lorsqu'elles sont proposées dans le widget Guide : Personnalisez l'apparence et le comportement du chat lorsqu'il est proposé dans le widget Guide. Cela inclut la modification des informations dans la fenêtre de chat, la modification de l’aspect de la fenêtre de chat, la définition du code CSS personnalisé, etc.

• Préférences de Reporting : Personnaliser la façon dont Guide suit les engagements et les conversions. Vous pouvez utiliser ces API lors de la définition d’événements personnalisés, le stockage de variables de visiteurs, le stockage de données de conversion, l’affectation et le retrait de balises Web, etc.

Comprendre le fonctionnement de Guide

Le widget Guide est un module Web que NiCE CXone Loader charge sur votre site Web. Ce module Web contient une application JavaScript qui est intégrée dans le framework Svelte. L'application utilise des magasins d'état de base qui suivent la configuration de Guide, le modèle actif, l'état du clavardage actif, l'état de l'interface utilisateur, etc. Les valeurs de ces magasins d’état déterminent le contenu visible par l’internaute.

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 requête renvoie un résultat JSON avec des règles, des boutons, des points d’entrée, des traductions, des articles référencés et des indicateurs de fonctionnalités. Elle utilise ensuite le moteur de règles intégré pour traiter les règles et les conditions qui peuvent déboucher ou non sur un modèle ou une offre proactive sur la page.

Pour gérer les données des visiteurs entre les rechargements de page, Guide utilise le stockage local et le stockage de session. Cela permet à Guide de fournir une prise en charge inter-domaines sur les navigateurs pris en charge. Cela signifie également que Guide n’a pas recours aux cookies de navigateurs.

Ajouter JavaScript Appels

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

2. Cliquez sur Integrations. Une page s’affiche avec un code JavaScript propre à 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 </script> de fermeture du code que vous avez collé, ajoutez les appels JavaScript à utiliser. Dans l'illustration suivante, le commentaire indique où ajouter des appels.

   

   Pour des informations complètes 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. Consultez la page modifiée et assurez-vous que les personnalisations de Guide fonctionnent comme prévu.

8. Après avoir procédé à l’ensemble des tests et vous être assuré que le script final fonctionne comme prévu, copiez-le dans l’en-tête des pages devant utiliser cette personnalisation de Guide.

Définition de la Langue à utiliser pour Guide

Pour outrepasser tous les paramètres de langue du navigateur et forcer les visiteurs Guide à voir le contenu dans une langue spécifique, modifiez le script d'intégration. Ajoutez le paramètre locale à la commande cxone('guide','init'); à la fin du script et précisez la langue souhaitée. Par exemple, vous pouvez sélectionner le français de la façon suivante :

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

Remplacez #### par l'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 pré-chat et pré-e-mail dans le navigateur de l’utilisateur. Cela permet aux informations de persister lors des rechargements de Page ou des sessions ultérieures.

Toutefois, dans certains environnements, en particulier ceux présentant des exigences en matière 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 s'afficher 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, le widget est rechargé ou l'utilisateur démarre 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 à nouveau leurs informations de pré-chat pour chaque nouvelle interaction.