Intégrez Guide sur votre site Web
Vous devez intégrer le code Guide JavaScript sur chaque page de votre site Web sur laquelle vous souhaitez afficher lesGuide règles d’engagement Guide que vous avez créées.
Pour accéder au code d'intégration, vous devez disposer de l'autorisation Guide Configuration.
Visionnez une courte vidéo sur l'intégration du code Guide JavaScript.
- Cliquez sur le sélecteur d'application
et sélectionnez Guide. -
Cliquez sur Integrations. Une page s’affiche avec un code JavaScript propre à votre locataire.
L'image d'exemple contient des zones floues où vous verrez des valeurs spécifiques à votre locataire.
-
Cliquez sur Copier le code avec Guide pour copier le code.
- Paste this code into the header of each webpage on which you want to display a Guide template or proactive offer.
Autrement, si votre site Web est intégré à un gestionnaire de balises, vous pouvez l'utiliser pour exécuter le script du site Web.
Activer le chat Démo et appliquer les Paramètres d'identité de marque
Pour prévisualiser le comportement du chat pendant l'implémentation, vous pouvez configurer Guide afin d'initialiser le chat en mode démo. Pour activer le chat de démo, ajoutez le paramètre demoMode à la fonction cxone('guide','init'); dans votre script intégré.
cxone('chat', 'init', brandId, channelId, locale, { controlledByGuide: true, demoMode: true, customContainerId: 'customId'});
Lorsque demoMode est défini sur true.
-
Guide lance la fenêtre de chat en mode démo.
-
Le chat se charge dans un état prédéfini en lecture seule.
Par défaut, le paramètre est défini sur false.
Une fois que Chat est initialisé en mode démo, vous pouvez mettre à jour l'aperçu en direct à l'aide de l'API Identité de marque :
cxone('chat','setThemeColors', {headerBgColor, headerFontColor, primaryMessageBgColor, primaryMessageFontColor, secondaryMessageBgColor, secondaryMessageFontColor});
Lorsque vous utilisez setThemeColors :
-
L'identité de marque est étendue afin d'inclure la personnalisation du chat.
-
Le chat affiche l'image de marque configurée dans la fenêtre de chat.
-
Les mises à jour de l'identité de marque peuvent être utilisées avec le chat de démo afin de prévisualiser l'apparence configurée pendant l'implémentation.
Vous pouvez également utiliser du code CSS personnalisé avec les paramètres de personnalisation :
-
Si les paramètres de marque et le CSS personnalisé ne sont pas en conflit, les deux sont appliqués.
-
Si les paramètres de marque et le CSS personnalisé sont en conflit, le CSS personnalisé est prioritaire.
Activer la réévaluation des règles pour les Applications Single Page (SPAs)
Pour prendre en charge le routage dynamique dans les applications à page unique, vous pouvez configurer Guide afin de réévaluer automatiquement les règles lorsqu'un utilisateur accède à une nouvelle page. Pour activer le routage dynamique, ajoutez le paramètre resetRulesOnNewPage à la fonction cxone('guide','init'); dans votre script intégré :
cxone('guide','init', {resetRulesOnNewPage: true});
Lorsque resetRulesOnNewPage est défini sur true.
-
Guide surveille les transitions de page à l'aide du module analytics.
-
Dès qu'elle détecte une nouvelle Page, la Rules ENGINE revient à son état initial.
-
Toutes les règles, y compris celles avec des évaluations statiques ou celles qui se sont déjà déclenchées, sont réévaluées immédiatement.
-
Les écouteurs et les minuteries de la règle redémarrent comme si la Page venait de se charger.
Par défaut, le paramètre est défini sur false.
Définition de la Langue à utiliser pour Guide
Pour remplacer tout paramètre de langue du navigateur et forcer les visiteurs de 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'});
Replace #### par les quatre chiffres de l'id du locataire.
Le contenu que vous rédigez dans une offre proactive apparaît toujours dans la langue dans laquelle il a été écrit. Cela suppose que vous ayez déjà configuré les chaînes de traduction de Guide pour le français.
Désactiver le suivi
Pour utiliser les conditions de date et d'heure ou de disponibilité de l'Agent, mais sans utiliser le suivi Web, ajoutez la commande API JavaScript suivante au script d'intégration :
cxone('disableModule', 'analytics')
Bonnes pratiques relatives au site Web
-
N'utilisez pas le paramètre
!importantdans les feuilles de style CSS pour les éléments génériques de votre site Web. Si vous le faites, le CSS de votre site Web peut se répercuter sur Guide et en modifier la conception. -
Ne contournez pas les fonctions de base de JavaScript sur votre site Web. Sinon, Guide risque de ne pas fonctionner correctement.
-
Vous pouvez personnaliser l'apparence et le comportement de Guide en utilisant les API JavaScript.