Integración JivoChat: configuración y ayuda

Conecta tu tienda con JivoChat. Necesitas una cuenta existente en el servicio y su identificador ID del widget. Configura las conversaciones y el widget visible en la cuenta del servicio.

La acción "Configure" del módulo abre Configuración de JivoChat. La página 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 widget del código de instalación del canal de tu sitio web en JivoChat. El panel de configuración indica "Manage" > "Channels" > "Website widget". 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 de 5 a 128 letras o números. 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 JivoChat 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

Cuando Pasar datos del cliente está activado y el cliente ha iniciado sesión, el módulo registra window.jivo_onLoadCallback antes de cargar el widget. Cuando JivoChat llama a esta función y jivo_api está disponible, envía el nombre y el correo mediante jivo_api.setContactInfo. Establece No para omitir esta transferencia.

Este módulo no proporciona a los invitados campos 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:

//code.jivosite.com/widget/{Widget ID}

Abre el widget y envía un mensaje de prueba. Comprueba que llegue a la bandeja de entrada del servicio. Por último, prueba las páginas y los dispositivos móviles excluidos.

Gestiona los operadores, los canales, el enrutamiento, los formularios sin conexión y la automatización en JivoChat. Este módulo proporciona el cargador del widget de la tienda y las reglas de visualización.

• Si no se genera ningún cargador, comprueba Activar JivoChat, ID del widget, 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 el nombre o el correo del cliente conectado, comprueba Pasar datos del cliente, recarga la página y busca errores u otra integración que sustituya window.jivo_onLoadCallback.
• 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/mprjivochat/views/templates/hook/displayBeforeBodyClosingTag.tpl

a:

themes/your-theme/modules/mprjivochat/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 MPRJIVO_ para los nombres de los campos enviados. El almacenamiento actual usa el módulo mprjivochat en la tabla compartida mpr_config, con claves cortas:

ENABLED
WIDGET_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 JivoChat 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.