Integración Smartsupp Chat: configuración y ayuda

Necesitas una cuenta existente en el servicio y su identificador Website Key. Configura las conversaciones y el widget visible en la cuenta del servicio.

La acción "Configure" del módulo abre Configuración de Smartsupp. Esta página también muestra un aviso de configuración necesaria y un panel de integridad. Usa las páginas Configuración, Integridad, Licencia, Soporte y Actualización del módulo para las tareas de mantenimiento correspondientes.

Encontrar el valor de conexión

Copia _smartsupp.key de tu código de instalación del chat de Smartsupp. El formulario te indica "Settings" > "Chat box". 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 16 a 128 letras, números, guiones o guiones bajos. 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 Smartsupp 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 checkout. 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 mediante _smartsupp.key. Cuando está activado el envío de datos del cliente, también transmite a Smartsupp el correo electrónico (_smartsupp.email) y el nombre (_smartsupp.name) del cliente que ha iniciado sesión.

Este módulo no transmite a Smartsupp campos de identidad del cliente de PrestaShop para los visitantes que no han iniciado sesión. 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 checkout, establece Mostrar en móvil en No y Retraso de fallback (segundos) 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 iniciar la carga. Sin interacción, espera el tiempo de respaldo configurado. Es el tiempo total de espera, sin retrasos adicionales después. Con el valor inicial 0, espera 10 segundos antes de considerar que ha fallado la carga de una página inactiva.

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

https://www.smartsuppchat.com/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 Enviar 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 los operadores, la disponibilidad, las notificaciones, las grabaciones y los chatbots en Smartsupp. El módulo no crea una cuenta ni configura esas funciones del servicio.

• Si no se genera ningún cargador, comprueba Activar chat de Smartsupp, Website Key, 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. Retraso de fallback (segundos) 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 Enviar 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/mprsmartsupp/views/templates/hook/displayBeforeBodyClosingTag.tpl

a:

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

ENABLED
WEBSITE_KEY
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 chat de Smartsupp 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.