Personalizar Guide con JavaScript

Para usar Guide con su sitio web, simplemente puede incrustar Guide en cada página de su sitio web donde desee ofrecer una participación.

Sin embargo, si usted está familiarizado con el desarrollo web y desea realizar personalizaciones a la apariencia y comportamiento del widget Guide, puede hacerlo mediante llamadas de API Interfaz de programación de aplicaciones. Le permite automatizar ciertas funcionalidades al conectar su sistema NiCE CXone con otro software. al código JavaScript. Estos son los tipos de cambios que puede realizar:

• Apariencia y comportamiento del widget Guide: Personalizar la apariencia y el comportamiento del widget Guide. Esto incluye cambiar el tamaño del widget, cambiar el tamaño de los botones, mostrar el widget en modo de pantalla completa, etc.

• Preferencias de chat cuando se ofrece en el widget Guide: Personalice la apariencia y el comportamiento del chat cuando se ofrece en el widget Guide. Esto incluye cambiar la información en la ventana de chat, cambiar la apariencia de la ventana de chat, definir CSS personalizado, etc.

• Preferencias de Reporting: Personalizar cómo Guide rastrea las interacciones y conversaciones. Puede usar estas API al definir eventos personalizados, almacenar variables de visitante, almacenar datos de conversación, asignar y quitar etiquetas web, entre otros.

Comprender cómo funciona Guide

El widget Guide es un módulo web que el NiCE CXone Loader carga en su sitio web. El módulo web contiene una aplicación JavaScript que está construida con el framework Svelte. La aplicación utiliza almacenes de estado básicos que mantienen el seguimiento de la configuración de Guide, la plantilla activa, el estado del chat activo, el estado de la IU, entre otros. Los valores de estos almacenes de estado controlan lo que se muestra al visitante.

Cuando usted integra Guide en una página de su sitio web, y un visitante ve la página, Guide obtiene la configuración específica de su abonado. Esta solicitud devuelve un resultado JSON con reglas, botones, puntos de entrada, traducciones, artículos referenciados e indicadores de funciones. Luego, utiliza el motor de reglas incluido para procesar las reglas y condiciones que pueden o no resultar en la aparición de una plantilla u oferta proactiva en la página.

Para administrar los datos de los visitantes entre las recargas de página, Guide usa almacenamiento local y de sesión. Esto permite que Guide proporcione soporte entre dominios en los navegadores admitidos. También significa que Guide no utiliza cookies del navegador.

Agregar JavaScript Llamadas

1. Haga clic en el selector de aplicaciones y seleccioneGuide.

2. Haga clic en Integraciones. Aparece una página con el código JavaScript que es específico para su abonado.

3. Haga clic en Copy code with Guide para copiar el código.
4. Pegar el fragmento de código copiado en su código o en un programa de edición de texto.

5. Justo arriba de la etiqueta de cierre </script>del código que ha pegado, agregue las llamadas a JavaScript para usar. En la siguiente imagen de ejemplo, el comentario indica dónde agregar llamadas.

   

   Para obtener detalles completos sobre las llamadas que puede usar, consulte Guide API relacionadas con widgets, API relacionadas con chat y API relacionadas con generación de informes.

6. Copie y pegue el script completo, incluidas las etiquetas <script> de apertura y cierre, en el encabezado de una página de su sitio web.

7. Visite la página modificada y asegúrese de que las personalizaciones de Guide funcionen según lo previsto.

8. Cuando esté totalmente probado y funcione como se espera, copie el script final en el encabezado de cada página que deba tener esta personalización de Guide.

Definir el Idioma para utilizar en Guide

Para anular cualquier configuración de idioma del navegador y forzar que los visitantes de Guide vean el contenido en un idioma específico, modifique el script de inserción. Agregue el parámetro locale al comando cxone('guide','init'); al final del script y especifique el idioma deseado. Por ejemplo, puede definirlo a francés de la siguiente manera:

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

Sustituir #### con el id de abonado de cuatro dígitos.

Desactivar el almacenamiento en caché del formulario previo al chat

De forma predeterminada, el widget de Guide almacena en caché los datos ingresados en los formularios de contacto de chat previo y correo electrónico previo en el navegador del usuario. Esto permite que la información persista a través de recargas de página o sesiones posteriores.

Sin embargo, en algunos entornos, particularmente aquellos con requisitos de cumplimiento, privacidad o seguridad, este comportamiento puede no ser deseable. Puede deshabilitar este comportamiento utilizando la bandera de configuración disableFormCaching al inicializar el widget Guide.

Cuando disableFormCaching no está configurado o está configurado en false (valor predeterminado):

• Los datos del formulario previo al chat se almacenan en caché en el browser.

• Los valores ingresados anteriormente pueden aparecer automáticamente cuando el widget se recarga o cuando comienza una nueva sesión

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

Cuando disableFormCaching está configurado en true y si se actualiza la página, se recarga el widget o el usuario inicia una nueva sesión:

• Los campos del formulario previo al chat están vacíos.

• Los valores ingresados anteriormente no se restauran.

Como resultado, los usuarios deben volver a ingresar su información previa al chat para cada nueva interacción.