Integración Chatra Chat: configuración y ayuda

Necesitas una cuenta del servicio existente y el valor de su campo ID del widget. Configura las conversaciones y el widget visible en esa cuenta.

La acción "Configure" del módulo abre Configuración de Chatra. 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 ChatraID del código de instalación de tu widget de Chatra. El panel de configuración indica "Settings" > "General" > "Widget code". Pega solo el identificador, sin una URL completa ni un script.

El valor predeterminado está vacío. Para identificadores nuevos o modificados, el módulo espera de 8 a 128 letras, números, guiones o guiones bajos. 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 Chatra 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

Cuando Pasar datos del cliente está activado, el módulo envía el nombre completo y el correo electrónico de los clientes conectados a Chatra mediante ChatraIntegration. Selecciona No para omitir ambos campos.

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:

https://call.chatra.io/chatra.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.

Gestiona los agentes, las conversaciones, los activadores y el aspecto del widget en Chatra.

• Si no se inserta el cargador, comprueba Activar Chatra Chat, ID del widget, 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/mprchatra/views/templates/hook/displayBeforeBodyClosingTag.tpl

a:

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

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