Pas Guide aan met JavaScript

Als u Guide wilt gebruiken voor uw website, kunt u Guide eenvoudig insluiten op elke websitepagina waar u een betrokkenheidsinteractie wilt aanbieden.

Als u bekend bent met webontwikkeling, en de weergave en het gedrag van de Guide-widget wilt aanpassen, kunt u dit echter doen door API Application Programming Interface. Hiermee kunt u bepaalde functies automatiseren door uw CXone Mpower-systeem te koppelen aan andere software.-aanroepen van de JavaScript-code te gebruiken. U kunt het volgende wijzigen:

Weergave en gedrag van de Guide-widget: De weergave en het gedrag van de Guide-widget aanpassen. Zo kunt u de grootte van de widget en de knoppen wijzigen, de widget op volledige schermgrootte weergeven enzovoort.
Chatvoorkeuren indien aangeboden in Guide-widget: De weergave en het gedrag van chat aanpassen indien de Guide-widget hierin voorziet. Zo kunt u de informatie in het chatvenster wijzigen, de weergave van het chatvenster veranderen, aangepaste CSS instellen enzovoort.
Reporting-voorkeuren: Aanpassen hoe betrokkenheidsinteracties en conversies door Guide worden bijgehouden. U kunt deze API's gebruiken bij het definiëren van aangepaste gebeurtenissen, het opslaan van bezoekervariabelen, het toewijzen en verwijderen van webtags enzovoort.

Begrijp hoe Guide werkt

De Guide-widget is een webmodule die CXone Mpower Loader op uw website laadt. De webmodule bevat een JavaScript-applicatie die met het Svelte-framework is gemaakt. De applicatie gebruikt elementaire statusopslagplaatsen voor het bijhouden van de Guide-configuratie, de actieve sjabloon, de actieve chatstatus, de UI-status enzovoort. De waarden van deze statusopslagplaatsen bepalen wat de bezoeker te zien krijgt.

Als u Guide op een pagina van uw website insluit en een bezoeker die pagina opent, haalt Guide de configuratie op die specifiek is voor uw tenant. Hierdoor wordt een JSON-resultaat met regels, knoppen, toegangspunten, vertalingen, verwijzingen naar artikelen en schakelopties geretourneerd. Vervolgens wordt de engine voor gebundelde regels gebruikt om de regels en voorwaarden te verwerken die ertoe kunnen leiden dat een sjabloon of proactief aanbod op de pagina verschijnt.

Guide gebruikt lokale en sessieopslag om bezoekersgegevens te beheren tussen het laden en herladen van een pagina. Hierdoor kan Guide ondersteuning van domeinoverschrijding in ondersteunde browsers bieden. Het betekent bovendien dat Guide geen browsercookies ondersteunt.

Test Guide-aanpassingen in een testomgeving voordat u ze vrijgeeft in uw productieomgeving. Zo voorkomt u dat uw websitebezoekers last hebben van storingen. Bovendien weet u dan zeker dat uw aanpassingen werken zoals bedoeld.

Voeg JavaScript oproepen toe

Klik op de app-kiezer en selecteerGuide.
Klik op Integrations. Er verschijnt een pagina met JavaScript-code die specifiek is voor uw tenant.
Klik op Copy code with Guide om de code te kopiëren.
Plak het gekopieerde codefragment in uw code of een tekstbewerkingsprogramma.
Voeg de JavaScript-aanroepen toe direct boven de afsluitende </script>-tag van de code die u hebt geplakt. In het onderstaande voorbeeld geeft een commentaarregel aan waar de aanroepen moeten worden ingevoegd.

Voor volledige details over de oproepen die u kunt gebruiken, zie Guide widget-gerelateerde API's, chat-gerelateerde API's en rapportage-gerelateerde API's.
Kopieer het volledige script, inclusief de openende en afsluitende <script>-tags, en plak dit in de header van een pagina op uw website.
Ga naar de gewijzigde pagina en controleer of de Guide-aanpassingen goed werken.
Wanneer het definitieve script volledig is getest en werkt zoals verwacht, kopieert u het naar de header van elke pagina waarop deze Guide-aanpassing moet worden weergegeven.

Stel de taal in die u wilt gebruiken voor Guide

Als u de browsertaalinstellingen wilt opheffen en Guide-bezoekers wilt dwingen content in een specifieke taal te zien, wijzigt u het geïntegreerde script. Voeg de locale parameter toe aan de cxone('guide','init');opdracht aan het einde van het script en geef de gewenste taal op. Ga bijvoorbeeld als volgt te werk om de taal op Frans in te stellen:

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

Vervang #### door uw viercijferige tenant-ID.

De tekst die u in een proactieve aanbieding schrijft, blijft in de taal waarin deze is geschreven. Hierbij wordt ervan uitgegaan dat u de Guide-vertalingsstrings op Frans hebt ingesteld.

Schakel het cachen van het pre-chatformulier uit.

Standaard slaat de Guide-widget gegevens op die zijn ingevoerd in contactformulieren voorafgaand aan chatgesprekken en e-mails in de browser van de gebruiker. Hierdoor blijft de informatie behouden, ook na het opnieuw laden van de pagina of in volgende sessies.

In sommige omgevingen, met name die met strenge eisen op het gebied van compliance, privacy of beveiliging, is dit gedrag echter mogelijk niet wenselijk. Je kunt dit gedrag uitschakelen door de configuratievlag disableFormCaching te gebruiken bij het initialiseren van de Guide-widget.

Wanneer disableFormCaching niet is ingesteld of is ingesteld op false (standaard):

De gegevens van het pre-chatformulier worden in de browsercache opgeslagen.
Eerder ingevoerde waarden kunnen automatisch verschijnen wanneer de widget opnieuw wordt geladen of een nieuwe sessie begint.

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

Als disableFormCaching wordt ingesteld op true en de pagina wordt vernieuwd, de widget opnieuw wordt geladen of de gebruiker een nieuwe sessie start:

De velden in het pre-chatformulier zijn leeg.
Eerder ingevoerde waarden worden niet hersteld.

Hierdoor moeten gebruikers voor elke nieuwe interactie hun gegevens van vóór het chatgesprek opnieuw invoeren.