Integración HubSpot Chat: configuración y ayuda

Usa esta guía para conectar tu tienda con HubSpot. Necesitas una cuenta del servicio existente y el valor de su campo ID del portal. Configura las conversaciones y el widget visible en esa cuenta.

La acción "Configure" del módulo abre Configuración de HubSpot Chat. 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 tu ID numérico del portal de HubSpot, también llamado Hub ID, de los detalles de la cuenta o del código de instalación. El panel del módulo indica "Settings" > "Account Defaults" > "Account Info". Pega solo el identificador, sin una URL completa ni un script. La navegación de la cuenta del proveedor procede de las instrucciones del módulo y puede variar en tu cuenta.

El valor predeterminado está vacío. Para identificadores nuevos o modificados, el módulo espera de 1 a 20 dígitos. Si se rechaza el identificador, se conserva la configuración guardada anterior. Corrige el valor y vuelve a guardar.

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

Grupos de páginas

La selección usa los nombres de los controladores. Solo páginas de pago no incluye un controlador de pago personalizado que no figure en esta lista. No hay un campo de reglas URL personalizadas. Mostrar en móvil usa la detección móvil de PrestaShop en lugar de basarse solo en la anchura del navegador.

Campos del cliente

Antes de cargar el script, la plantilla encola _hsq.push(['identify', {email: 'customer@example.com'}]) para un cliente conectado con el envío de datos activado. Solo envía la dirección de correo; los nombres de los clientes no se envían. El cargador usa hs-script-loader y evita insertar un segundo elemento con ese ID.

Este módulo no transmite campos de identidad de clientes de PrestaShop para los invitados. El servicio aún puede recopilar 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, pon 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 la activación, el valor de conexión y las reglas de dispositivo y página. Después inserta 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 alternativo configurado. El cargador compartido elimina el retraso interno de la plantilla, así que las dos esperas no se suman. Con el valor inicial 0, espera 10 segundos antes de considerar que una página sin interacción ha fallado al cargar.

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

//js.hs-scripts.com/{Portal ID}.js

Abre el widget y envía un mensaje de prueba. Comprueba que llegue a la bandeja del servicio. Prueba una cuenta conectada 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.

Publica y configura tu chatflow en HubSpot. Gestiona el aspecto, el enrutamiento de la bandeja, las reuniones y el comportamiento del CRM en HubSpot.

• Si no se inserta el cargador, comprueba Activar HubSpot Chat, ID del portal, Mostrar en páginas y Mostrar en móvil.
• Si la página permanece inactiva, espera la carga alternativa o interactúa con ella. "Fallback Delay (seconds)" en 0 no significa carga inmediata.
• Si falla el guardado, mantén el identificador, comprueba su formato, recarga la página de configuración y vuelve a intentarlo. No uses credenciales de ejemplo en una prueba real.
• Si falla la solicitud externa, revisa los errores de la consola, el bloqueo de scripts, la Content Security Policy y las herramientas de consentimiento de tu tienda.
• Si el script carga pero falta el botón de apertura, comprueba la publicación del widget, la disponibilidad de la cuenta y las reglas de visualización en el servicio.
• 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 antes.
• Si otra integración también inserta el script del servicio, revisa la página renderizada para detectar código de instalación duplicado o en conflicto.

Comprobar un tema personalizado

Tu tema debe ejecutar el hook de cierre del body. Un desarrollador puede restaurar esta llamada antes de </body> si falta en el tema:

{hook h='displayBeforeBodyClosingTag'}

Para modificar la plantilla en el tema, copia:

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

a:

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

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

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

ENABLED
PORTAL_ID
SHOW_MOBILE
PAGES
DELAY
PASS_USER_DATA

La tabla 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 trates los nombres de los campos como las claves actuales de la base de datos.

Pon Activar HubSpot Chat en No y guarda manteniendo el identificador 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 código insertado por otro módulo o tema.