Integración LINE Chat: configuración y ayuda

Inicio rápido

  1. En Módulos > "Module Manager", elige "Upload a module" e instala el ZIP de mprlinechatintegration.
  2. Haz clic en "Configure".
  3. En Conexión LINE, introduce ID de LINE, por ejemplo @myshop.
  4. Deja Activar LINE Chat en Sí y elige la esquina en Apariencia del botón > Posición.
  5. En Comportamiento de visualización, deja Mostrar en páginas en Todas las páginas y Fallback Delay (seconds) en 0 para la primera prueba.
  6. Haz clic en Guardar. Abre una página permitida de la tienda con JavaScript activado.
  7. Desplázate o haz clic en la página, o espera 10 segundos. Comprueba que aparece el botón e inspecciona su destino: @myshop. Púlsalo en un dispositivo que pueda abrir LINE y confirma que el contacto es correcto.

Requiere PrestaShop 1.6 o posterior y PHP 7.1 o posterior.

Manual de configuración

Instalación y primera configuración

En versiones anteriores de PrestaShop, usa la página equivalente de instalación de módulos. Abre este módulo desde "Configure" cuando necesites volver a sus ajustes.

Conexión LINE

Ajuste Valor predeterminado Qué haces
Activar LINE Chat Sí Desactívalo para detener la salida en la tienda conservando la configuración guardada.
ID de LINE Vacío Introduce 2-64 letras, números, puntos, guiones o guiones bajos, con un @ inicial opcional.
Mensaje predefinido Vacío Para los ID de cuentas oficiales que empiezan por @, rellena previamente un mensaje en iOS y Android. Usa {url} para la URL actual de la tienda. Los ID personales no admiten mensajes predefinidos.

Después de guardar un identificador, la página de configuración ofrece un enlace a la cuenta LINE. Ábrelo para comprobar el destino. El módulo comprueba el formato de los identificadores modificados al guardar, sin comprobar si la cuenta existe. Un cambio rechazado conserva la configuración anterior; los identificadores sin cambios se mantienen sin otra comprobación de formato.

Apariencia del botón

Ajuste Valor predeterminado Qué haces
Posición bottom-right Elige Abajo a la derecha o Abajo a la izquierda para evitar otros controles flotantes.
Estilo del botón icon Elige Icono flotante para el botón redondo o Barra con texto para un botón de texto.
Texto del botón Chat on LINE Establece la etiqueta que se muestra en modo barra. La plantilla también la usa como etiqueta accesible del botón de icono.
Color del botón #06C755 Establece el color de fondo con el selector de color.
Tamaño del botón (px) 60 Cambia el diámetro del icono redondo. El modo barra usa su propio relleno interior.
Margen desde el borde (px) 20 Establece la distancia inferior y lateral en píxeles.
Mostrar descripción emergente Sí Desactiva la descripción emergente al pasar el cursor si no la necesitas.
Texto de ayuda Chat with us on LINE Escribe el mensaje que aparece al pasar el cursor.
Animación pulse Elige pulse, bounce o none. Elige none para detener la animación repetida.

Puedes traducir Texto del botón y Texto de ayuda mediante los controles de idioma del formulario. Una traducción vacía usa el idioma predeterminado. El mismo mecanismo de uso del idioma predeterminado se aplica a Mensaje predefinido. Usa Guardar después de editar.

Comportamiento de visualización

Ajuste Valor predeterminado Qué haces
Mostrar en móvil Sí Permite el botón para los visitantes que PrestaShop detecte como móviles. Desactívalo para ocultarlo en esos dispositivos.
Fallback Delay (seconds) 0 Carga al primer desplazamiento, clic, toque o pulsación de tecla. Un valor positivo establece la espera pasiva máxima en segundos. 0 usa una carga de respaldo a los 10 segundos.
Mostrar en páginas all Elige Todas las páginas, Solo páginas de producto, Solo páginas de categoría o Solo páginas de pago.

Solo páginas de pago coincide con cart, order, order-opc, orderopc y checkout. Otros módulos del proceso de compra pueden usar nombres de controlador distintos. La espera de respaldo comienza en la página. No es un retraso adicional después de una interacción.

Comportamiento en la tienda y verificación

Tu tema debe ejecutar displayHeader para la hoja de estilos y displayBeforeBodyClosingTag para el widget. El módulo comprueba el interruptor de activación, un identificador no vacío y las reglas de móvil y de página antes de devolver la salida.

Tras la primera interacción o la carga de respaldo, verás un botón fijo en la esquina seleccionada. Su enlace se abre en una pestaña nueva con noopener noreferrer. Para la cuenta oficial @myshop sin mensaje, el destino es:

https://line.me/R/oaMessage/%40myshop

Usa un ID de LINE personal o un ID de cuenta oficial, como myshop, @myshop, shop.name, shop-name o shop_name. El ID personal myshop enlaza con https://line.me/ti/p/myshop. Para una cuenta oficial con un mensaje guardado, el módulo añade /? y el mensaje codificado para una URL a la URL de la cuenta oficial, sustituyendo {url} por la URL de la página actual. Gestionas las conversaciones en LINE. El módulo no genera códigos QR, no envía notificaciones de pedidos ni proporciona una bandeja de entrada.

Prueba una página permitida y otra excluida si restringes los tipos de página. Prueba la visibilidad móvil en un dispositivo real. Si usas varios idiomas, comprueba el texto traducido del botón y la descripción emergente.

Ejemplos de configuración y ajustes del tema

Para un botón de texto en las páginas de producto, establece Estilo del botón en Barra con texto, Texto del botón en Ask us on LINE, Mostrar en páginas en Solo páginas de producto y Animación en none. Puedes elegir Abajo a la izquierda cuando otro widget ocupe la esquina derecha.

Si necesitas mover el widget por encima de otro control fijo, añade una regla a la hoja de estilos de tu tema:

#mprline-widget.mprline-bottom-right {
  bottom: 90px;
  right: 24px;
}

#mprline-widget.mprline-bar a span {
  font-size: 15px;
}

Para sobrescribir la plantilla en el tema, usa:

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

La plantilla recibe $mprline con chat_url, position, style, cta_text, color, size, margin, show_tooltip, tooltip, animation y delay. El valor preparado chat_url incluye el mensaje para las cuentas oficiales; los campos separados line_id y message no se proporcionan. Mantén los cambios en tu tema para que una actualización del módulo no los sobrescriba.

Los ajustes usan la tabla compartida mpr_config con el prefijo de base de datos configurado, el nombre de módulo mprlinechatintegration y claves cortas como LINE_ID, POSITION, STYLE, CTA_TEXT y COLOR. Los nombres de los campos del formulario usan el prefijo MPRLINE_. Cambia los ajustes desde el formulario.

Solución de problemas

  • Si no ves ningún botón, revisa el interruptor de activación, el identificador guardado y las reglas de página y móvil. Provoca una interacción o espera a la carga de respaldo.
  • Si se rechaza un cambio, introduce el identificador con el formato indicado arriba. No pegues un enlace de contacto completo.
  • Si el widget no tiene estilos, comprueba que tu tema llama a displayHeader y carga la hoja de estilos del módulo.
  • Si la plantilla no aparece nunca, revisa displayBeforeBodyClosingTag y el registro del hook del módulo en el back office.
  • Si el botón se superpone a otro control, cambia Posición o Margen desde el borde (px).
  • Si aparece el botón pero falla el destino, prueba el contacto guardado y el gestor de aplicaciones externas del dispositivo.

Si falta el mensaje predefinido, usa un ID de cuenta oficial que empiece por @ y prueba el botón de la tienda en iOS o Android. Los ID personales abren el contacto sin mensaje. El enlace de prueba del back office comprueba solo la cuenta y no incluye el mensaje guardado.

Usa la página "Integrity" del módulo para el diagnóstico de configuración y hooks. Licencia, Soporte y Actualizar son páginas de mantenimiento, no ajustes de aspecto de la tienda.

Desactivación o desinstalación

Desactiva Activar LINE Chat y guarda para conservar tu configuración. El formulario principal sigue requiriendo un identificador no vacío al guardar. También puedes desactivar el módulo desde la lista de módulos.

Usa "Uninstall" en el gestor de módulos para eliminar la configuración del módulo y sus entradas del menú de administración. Tu cuenta de mensajería externa no se elimina.

Preguntas

Aún no hay preguntas sobre este módulo

Pregunta lo que quieras sobre instalación, compatibilidad o configuración. Las respuestas aparecen aquí.

Problemas conocidos

5

El enlace del chat tenía un nombre accesible incorrecto

ResueltoActualizado:
Corregido en: 1.1.19
Las tecnologías de asistencia podían anunciar un nombre incorrecto o sin traducir para el enlace del chat de LINE.

Las etiquetas de administración seguían en inglés

ResueltoActualizado:
Corregido en: 1.1.19
Algunas etiquetas de administración podían ignorar las traducciones disponibles.

El estado de configuración seguía desactualizado

ResueltoActualizado:
Corregido en: 1.1.19
El aviso de configuración podía seguir mostrando los ajustes anteriores después de guardar.

La administración podía no abrirse

ResueltoActualizado:
Corregido en: 1.1.14
La administración del módulo podía detenerse con un error si faltaba un componente de compatibilidad necesario.

La configuración existente del chat se leía mal

ResueltoActualizado:
Corregido en: 1.1.13
La configuración existente de LINE podía ignorarse después de que el módulo cambiara la forma de guardar los ajustes.

Solicitudes de funcionalidades

4

Implementado

Botón flotante de chat LINE

Implementado
Elige el aspecto, la posición y el retardo de visualización del botón de chat.

Mensajes LINE prerrellenados

Implementado
Establece un mensaje inicial que pueda incluir la dirección de la página actual.

Actualizaciones con un clic

Implementado
Actualiza el módulo desde su página de administración.

Textos del chat por idioma

Implementado
Configura los textos del chat visibles para los visitantes por separado para cada idioma de la tienda.

Registro de cambios

v1.1.132026-09-23

  • Addedcomplete FR/DE/ES/IT/PL translations
  • FixedMigrate chat config from ps_configuration to ConfigTable
Versiones anteriores

v1.3.02026-04-20

  • Addedadmin menu management via MenuInstaller for streamlined module setup
  • AddedLicense management tab with key management and renewal options
  • Addedself-healing integrity checks for automatic diagnostics and repair
  • Addedcomplete FR/DE/ES/IT/PL translations

v1.2.02026-02-13

  • Addedfull compatibility with PrestaShop 9.x and Hummingbird theme
  • AddedLINE Official Account deep link support for one-tap mobile chat initiation
  • Improvedbutton positioning with configurable corner (bottom-left/right) and offset
  • Fixedbutton not rendering when front-office cache was enabled without module asset exclusion
  • Addedcustom pre-message text to pre-fill the LINE chat compose box

v1.1.02025-06-25

  • Addedanimated bounce effect on the LINE chat button to draw visitor attention
  • Improvedmobile UX: button scales appropriately for touch targets
  • FixedLINE button overlapping with other chat widgets when multiple integrations active
  • Addedz-index configuration to control stacking order with other floating elements

v1.0.02025-04-29

  • Initialrelease: LINE Chat floating button integration for PrestaShop
  • InitialLINE ID or LINE Official Account URL configuration
  • InitialConfigurable button label, icon, and background colour
  • InitialPage-level display rules: show only on product pages, or sitewide

Demo

Prueba el módulo completo antes de comprar

Compra la licencia más tarde y conserva tus ajustes.

  • Tu demo de 30 días Pruébalo en tu propia tienda durante 30 días desde la primera instalación.
  • Tienda demo lista Explora una tienda demo lista en tu navegador.
  • Sin registro Sin cuenta, correo ni dominio de tienda.
Iniciar tienda demo

Al descargar, aceptas las condiciones de la demo y la política de privacidad.

Al abrir esta demo, acepta los términos de la demo y la política de privacidad.

Cargando...
Volver arriba