Integración Olark Chat: configuración y ayuda

Necesitas una cuenta existente en el servicio y su ID del sitio. Configura las conversaciones y el widget visible en la cuenta del servicio.

La acción "Configure" del módulo abre Configuración de Olark. Su controlador de configuración también muestra un aviso de configuración necesaria y un banner de integridad. Usa las páginas Configuración, "Integrity", Licencia, Soporte y Actualizar del módulo para las tareas de mantenimiento correspondientes.

Encontrar el valor de conexión

Copia el identificador ID del sitio de tu código de instalación de Olark. El módulo te indica "Settings" > "Installation". Pega solo el identificador. No pegues una URL ni un script completo.

El valor predeterminado está vacío. Para los identificadores nuevos o modificados, el módulo espera cuatro dígitos, tres dígitos, dos dígitos y cuatro dígitos, separados por guiones. Si se rechaza un identificador, se conserva la configuración guardada anteriormente. Corrige el valor y vuelve a guardar.

Configura estos campos en Configuración de Olark y haz clic en Guardar.

Grupos de páginas

La selección usa los nombres de los controladores. Un controlador de pago personalizado fuera de esta lista no queda incluido en Solo páginas de pago. No hay ningún campo para reglas de URL personalizadas. Mostrar en móvil usa la detección de móviles de PrestaShop, no solo el ancho del navegador.

Campos del cliente

El módulo se conecta al ID de sitio Olark configurado. Para un cliente que ha iniciado sesión, envía su correo electrónico y nombre completo a Olark.

Para los invitados, este módulo no envía a Olark datos de identidad del cliente de PrestaShop. El servicio puede seguir recopilando información mediante su propio widget. Este módulo no sincroniza el historial de pedidos ni el contenido del carrito.

Ejemplo de configuración

Para las páginas de pago en ordenadores, elige Solo páginas de pago, establece Mostrar en móvil en No y "Fallback Delay (seconds)" en 2. El cargador se inicia con la primera interacción o tras dos segundos sin interacción.

El módulo registra displayBeforeBodyClosingTag. Primero comprueba el interruptor de activación, el valor de conexión, la regla del dispositivo y la regla de la página. Después coloca un cargador diferido cerca del final de la página.

Desplázate, haz clic, toca la página o pulsa una tecla para activar el cargador. Sin interacción, espera el plazo de respaldo configurado. El cargador compartido elimina el retraso interno de la plantilla, por lo que ambos tiempos de espera no se suman. Con el valor predeterminado de instalación 0, espera 10 segundos antes de considerar que una página sin interacción tiene un fallo de carga.

En las herramientas de desarrollo del navegador, busca una solicitud que coincida con:

//static.olark.com/jsclient/loader.js

Abre el widget y envía un mensaje de prueba. Comprueba que llegue a la bandeja de entrada del servicio. Prueba con una cuenta que haya iniciado sesión si has activado Pasar datos del cliente y verifica qué campos de identidad recibe el servicio. Por último, prueba las páginas y los dispositivos móviles excluidos.

Gestiona la apariencia del widget, los saludos, el comportamiento sin conexión, los operadores y la automatización en Olark. El módulo no tiene campos para el contenido o el valor del carrito, las direcciones, los números de teléfono, el historial de pedidos ni campos personalizados del cliente.

• Si no se genera ningún cargador, comprueba Activar Olark Chat, ID del sitio, Mostrar en páginas y Mostrar en móvil.
• Si la página permanece sin interacción, espera el plazo de respaldo o interactúa con ella. "Fallback Delay (seconds)" en 0 no significa carga inmediata.
• Si no puedes guardar, mantén el identificador rellenado, comprueba su formato, vuelve a cargar la página de configuración e inténtalo de nuevo. No uses credenciales de ejemplo para una prueba real.
• Si falla la solicitud externa, comprueba los errores de la consola del navegador, el bloqueo de scripts, la Content Security Policy y las herramientas de consentimiento de tu tienda.
• Si el script se carga pero falta el botón de apertura, comprueba la publicación del widget en el servicio, la disponibilidad de la cuenta y las reglas de visualización.
• Si falta un campo del cliente, inicia sesión y confirma que Pasar datos del cliente esté en Sí. Compara con los campos exactos indicados arriba.
• Si otra integración también inserta el script del servicio, revisa la página generada para detectar código de instalación duplicado o en conflicto.

Comprobar un tema personalizado

Tu tema debe ejecutar el hook de cierre del cuerpo de la página. Un desarrollador puede restablecer esta llamada antes de </body> si falta en el tema:

{hook h='displayBeforeBodyClosingTag'}

Para modificar la plantilla del tema, copia:

modules/mprolark/views/templates/hook/displayBeforeBodyClosingTag.tpl

a:

themes/your-theme/modules/mprolark/views/templates/hook/displayBeforeBodyClosingTag.tpl

Conserva las variables Smarty del módulo y el escape del identificador. El contenedor de interacción compartido sigue aplicándose a esta plantilla del hook.

El formulario usa el prefijo MPROLARK_ para los nombres de los campos enviados. El almacenamiento actual usa el módulo mprolark en la tabla compartida mpr_config, con claves cortas:

ENABLED
SITE_ID
SHOW_MOBILE
PAGES
DELAY
PASS_USER_DATA

La tabla de la base de datos usa el prefijo de tablas de tu tienda, por lo que ps_mpr_config es solo un nombre de ejemplo. Usa el formulario de configuración para los cambios habituales. No consideres los nombres de los campos del formulario como las claves actuales de la base de datos.

Establece Activar Olark Chat en No y guarda con el identificador aún rellenado para pausar la salida de este módulo. También puedes desactivar el módulo en "Module Manager".

Para eliminarlo, usa "Uninstall" en "Module Manager" y confirma. La desinstalación elimina la configuración del módulo y sus entradas del menú de administración. No cierra la cuenta del servicio externo ni elimina el código insertado por otro módulo o tema.