Integración Crisp Chat: configuración y ayuda

Sigue los pasos de Inicio rápido.

Abre "Configure" en "Module Manager". Necesitas un espacio de trabajo de Crisp existente. El panel Configuración de Crisp ofrece instrucciones sobre el ID del sitio web y muestra el ID guardado.

La selección de páginas de pago coincide con cart, order, order-opc, orderopc y checkout. Comprueba el nombre del controlador, no URL de pago arbitrarias. Usa Todas las páginas si no se incluye un controlador de pago personalizado.

El cargador compartido muestra los controles de privacidad con la primera interacción, como desplazarse, hacer clic o tocar la página, o al cumplirse el plazo de respaldo configurado. El valor 5 significa un máximo de cinco segundos de espera. Interactuar o esperar nunca concede el consentimiento. Un permiso ya guardado para esta pestaña puede entonces cargar el chat automáticamente.

Los cambios del ID del sitio web se validan antes de guardarse. Un cambio no válido conserva la configuración anterior. El aviso de preparación también comprueba el formato UUID. Los controles de privacidad aparecen solo si hay un ID, el módulo está activado y la página y el dispositivo están permitidos. Introduce el ID mediante el formulario de configuración.

El módulo usa displayFooter en PrestaShop 1.6 y displayBeforeBodyClosingTag en las versiones posteriores. Cuando se activa el cargador compartido, muestra la sección Privacidad del chat y carga el archivo local views/js/consent.js. Solo la elección explícita Permitir el chat de Crisp, o un permiso recordado, inicializa window.$crisp, asigna window.CRISP_WEBSITE_ID y carga https://client.crisp.chat/l.js de forma asíncrona.

Si Pasar datos del cliente está activado y el cliente ha iniciado sesión, los controles ofrecen una casilla separada, inicialmente desmarcada, para el nombre y el correo. Solo al marcarla antes de permitir el chat se ponen en cola user:email y user:nickname con el correo y el nombre completo. Permitir solo el chat no transmite la identidad de la cuenta. El módulo no transfiere nombre ni correo de los invitados. Tu equipo gestiona las conversaciones en Crisp.

Configura el aspecto, la posición, la disponibilidad, la bandeja de entrada y las automatizaciones en Crisp. El permiso del chat y la opción separada sobre los datos se recuerdan en sessionStorage para la pestaña actual, según la ruta de la tienda, el ID del sitio web y el cliente. Si el almacenamiento está bloqueado, el permiso solo se aplica a la página actual. Tras rechazarlo, los visitantes pueden volver a abrir la sección Privacidad del chat o retirar allí el permiso. Retirarlo recarga la página e impide futuras cargas del módulo; no elimina los datos ni las cookies ya conservados por Crisp.

Copia la plantilla de origen en tu tema y edita la copia:

/modules/mprcrispchatintegration/views/templates/hook/displayBeforeBodyClosingTag.tpl
/themes/your_theme/modules/mprcrispchatintegration/views/templates/hook/displayBeforeBodyClosingTag.tpl

La plantilla recibe {$mprcrisp.website_id}, {$mprcrisp.delay}, {$mprcrisp.customer_email} y {$mprcrisp.customer_name}, además de la URL del script local, el ámbito del consentimiento y las etiquetas de privacidad traducidas. Usa el alias cr. El renderizador compartido establece el retraso de la plantilla en cero porque gestiona los tiempos de interacción/respaldo.

En una copia para el tema, conserva los controles de consentimiento, sus ID y atributos data-crisp-*, la referencia al script local y el escape de caracteres. La transferencia de datos del cliente ahora se ejecuta en el script de consentimiento y no mediante comandos integrados en la plantilla. La casilla opcional es:

{if $cr.customer_email || $cr.customer_name}
<label><input type="checkbox" data-crisp-share> {$cr.share_label|escape:'html':'UTF-8'}</label>
{/if}

Las claves de configuración son ENABLED, WEBSITE_ID, SHOW_MOBILE, PAGES, DELAY y PASS_USER_DATA, almacenadas para mprcrispchatintegration en el sistema de configuración compartido. Cámbialas desde el back office.

Abre una página permitida como invitado en una pestaña nueva. Desplázate o haz clic y confirma que los controles aparecen sin solicitudes a Crisp. Prueba también el respaldo sin interactuar. Rechaza y confirma que el chat sigue desactivado; vuelve a abrir los ajustes y permite el chat, luego comprueba client.crisp.chat/l.js y la burbuja. Prueba páginas permitidas y excluidas y un móvil cuando la visibilidad móvil esté desactivada.

Inicia sesión como cliente de prueba. Con Pasar datos del cliente activado, permite primero el chat sin marcar la opción de compartir y comprueba que no se ponen en cola comandos de correo/alias. Retira el permiso, vuelve a abrir los controles, marca la casilla y permite el chat para probar la transferencia. Desactiva el ajuste del comerciante y comprueba en una página recargada que no aparecen ni esa opción ni la transferencia. Prueba la navegación en la pestaña, el almacenamiento bloqueado y la retirada. Ninguna de estas acciones elimina los datos ya almacenados en Crisp.

Si no aparece el widget, revisa Activar Crisp Chat, ID del sitio web, selección de páginas, detección móvil y temporizador de interacción/respaldo. Abre la sección Privacidad del chat y permite el chat. Comprueba el hook displayFooter en PrestaShop 1.6 o displayBeforeBodyClosingTag en versiones posteriores, JavaScript activado y posibles bloqueos del script local de consentimiento o de la solicitud de Crisp.

Si falla el guardado, introduce un UUID completo y revisa el aviso de configuración. Si existe una sobrescritura del tema, compárala con la plantilla actual del módulo. Elimina los cargadores duplicados de Crisp del tema o de otros módulos.

Si el aspecto o la disponibilidad no son los esperados, revisa los ajustes de tu espacio de trabajo de Crisp. Usa la página "Integrity" del módulo si faltan archivos del módulo o su infraestructura de configuración compartida.

Establece Activar Crisp Chat en No y guarda para detener esta integración conservando los ajustes. Desinstala desde "Module Manager" para eliminar su menú y los valores de configuración. Tu espacio de trabajo de Crisp, las conversaciones y los datos de clientes del proveedor se gestionan por separado en Crisp.

Usa los nombres de los ajustes anteriores cuando una captura de referencia difiera de tu versión instalada.