Integración WhatsApp Chat: configuración y ayuda

Inicio rápido

  1. Sube el ZIP del módulo en "Modules > Module Manager" y abre "Configure".
  2. Introduce tu Número de teléfono (de 7 a 20 dígitos con código de país).
  3. Si quieres, configura Mensaje predefinido con {product} y {url}.
  4. Mantén Activar widget activado; selecciona Posición y Estilo del botón.
  5. Configura Mostrar en móvil y Mostrar en páginas y haz clic en Guardar.
  6. Abre una página permitida de la tienda y desplázate o haz clic para cargar el botón.
  7. Haz clic en el botón y confirma que se abre la conversación de WhatsApp deseada.

Requiere PrestaShop 1.6 o posterior y PHP 7.1 o posterior.

Manual de configuración

Instalar y conectar

  1. Abre "Modules > Module Manager" en tu back office.
  2. Elige "Upload a module" y sube el ZIP de WhatsApp Chat Integration.
  3. Abre "Configure".
  4. En Conexión WhatsApp, introduce tu Número de teléfono en formato internacional usando solo dígitos.
  5. Mantén Activar widget activado y guarda.
  6. Abre tu tienda, desplázate o haz clic y prueba el botón de contacto.

Requiere PrestaShop 1.6 o posterior y PHP 7.1 o posterior.

Ajustes de conexión

Ajuste Valor predeterminado al instalar Qué hacer
Activar widget Sí Desactívalo para pausar el botón conservando los ajustes.
Número de teléfono Vacío Introduce de 7 a 20 dígitos, incluido el código de país. Omite el signo más, los espacios y la puntuación.
Mensaje predefinido Vacío Introduce un texto de mensaje opcional. Usa {product} para el nombre del producto y {url} para la URL de la página actual.

Editas los formularios de conexión, Apariencia y Comportamiento en la página de configuración del módulo. Usa Guardar después de los cambios. Texto del botón, Texto de ayuda y Mensaje predefinido admiten textos específicos por idioma. Si falta el texto de un idioma, se usa el idioma predeterminado y después el texto base guardado.

Apariencia

Ajuste Valor predeterminado al instalar Cuándo cambiarlo
Posición Abajo a la derecha (bottom-right) Selecciona Abajo a la izquierda (bottom-left) si la esquina derecha está ocupada.
Estilo del botón Icono flotante (icon) Selecciona Barra con texto (bar) para mostrar Texto del botón.
Texto del botón Chatea con nosotros Configura el texto mostrado en el estilo de barra.
Color del botón #25D366 Configura el color de fondo del botón.
Tamaño del botón (px) 60 Configura el diámetro del icono redondo.
Margen desde el borde (px) 20 Ajusta la distancia desde el borde inferior y el lado seleccionado.
Mostrar descripción emergente Sí Desactívalo para ocultar la ayuda al pasar el cursor.
Texto de ayuda ¿Necesitas ayuda? ¡Chatea con nosotros! Configura la ayuda al pasar el cursor.
Animación Pulso (pulse) Elige Rebote (bounce) o Ninguno (none).

Comportamiento y visualización en la tienda

Ajuste Valor predeterminado al instalar Función
Mostrar en móvil Sí Desactívalo para suprimir la visualización cuando PrestaShop identifica a un visitante de móvil.
Retraso de fallback (segundos) 0 El widget se carga con el primer desplazamiento, clic, toque o pulsación de tecla. Un valor positivo establece la espera máxima sin interacción. Cero usa un tiempo de espera de fallback de 10 segundos.
Mostrar en páginas Todas las páginas (all) Selecciona Solo páginas de producto (product), Solo páginas de categoría (category) o Solo páginas de pago (checkout).

La selección de páginas de pago coincide con cart, order, order-opc, orderopc y checkout. Un controlador de pago personalizado con otro nombre no coincidirá con esa opción.

El módulo carga su hoja de estilos local mediante displayHeader. Tu tema debe ejecutar displayBeforeBodyClosingTag o la alternativa displayFooter. Una protección de renderización evita botones duplicados.

El botón abre https://wa.me/PHONE con un parámetro text opcional codificado para URL. WhatsApp o WhatsApp Web gestiona la conversación. El módulo no usa WhatsApp Business API ni almacena mensajes en PrestaShop.

Para una pregunta sobre un producto, configura Mensaje predefinido como Hi! I have a question about {product}: {url} y Mostrar en páginas como Solo páginas de producto. El módulo sustituye {product} solo en las páginas de producto. En otras páginas, ese marcador puede quedar literal, así que usa texto normal y {url} para la ayuda en el pago. El módulo no ofrece chatbot, bandeja compartida, automatización ni historial de mensajes.

Verificar y solucionar problemas

  • Abre una página permitida por Mostrar en páginas e interactúa con ella. Si no haces nada, espera al temporizador de fallback.
  • Haz clic en el botón y confirma que abre tu propio número. Prueba una página de producto e inspecciona el mensaje rellenado antes de enviarlo.
  • Si falta el botón, comprueba Activar widget, el identificador requerido, Mostrar en móvil y la selección de páginas. El back office muestra un aviso de configuración si falta el identificador o no es válido. Los identificadores modificados se validan al guardar; una modificación no válida conserva la configuración anterior.
  • Si falta el marcado en todas las páginas permitidas, comprueba el hook de renderización de tu tema. Si está presente pero oculto, revisa el CSS del tema, los errores de JavaScript y los botones fijos que se superpongan.
  • Un número válido formado solo por dígitos también debe pertenecer a la cuenta de WhatsApp deseada. Prueba el enlace en los dispositivos que usan tus clientes.

Personalización del tema

Sobrescribe themes/your-theme/modules/mprwhatsappchatintegration/views/templates/hook/displayBeforeBodyClosingTag.tpl si necesitas otro marcado. Mantén los cambios en el tema.

El ID del widget es #mprwhatsapp-widget. Las clases de posición, estilo y animación usan el mismo prefijo, como .mprwhatsapp-bottom-right, .mprwhatsapp-bar y .mprwhatsapp-pulse. La clase de la ayuda emergente es .mprwhatsapp-tooltip.

Puedes mover el botón por encima de otro elemento fijo en la hoja de estilos de tu tema:

#mprwhatsapp-widget.mprwhatsapp-bottom-right {
  bottom: calc(var(--mprwa-margin, 20px) + 50px);
}
#mprwhatsapp-widget .mprwhatsapp-tooltip {
  font-size: 12px;
}

Los ajustes generan --mprwa-color, --mprwa-size y --mprwa-margin en el contenedor. Usa los ajustes para cambiar esos valores.

Desactivar o desinstalar

Desactiva Activar widget para dejar de mostrar el botón. Para eliminar el módulo, usa "Uninstall" en "Module Manager". La desinstalación elimina sus entradas de menú y la configuración guardada del módulo. No elimina las conversaciones guardadas en WhatsApp.

Preguntas

2

¿Qué información de la página puede incluir el enlace de WhatsApp?

El mensaje predefinido opcional se incluye en el enlace de WhatsApp. En una página de producto, {product} se sustituye por el nombre del producto; {url} por la URL actual, incluidos sus parámetros de consulta. Revisa qué información quieres compartir antes de usar estos marcadores. La conversación tiene lugar en WhatsApp y sus mensajes no se guardan en PrestaShop.

¿El botón carga un SDK de WhatsApp o JavaScript externo?

El botón usa un enlace normal https://wa.me/, una hoja de estilos local y un cargador integrado. No carga un SDK de WhatsApp ni un script de chat de terceros.

El cargador inserta el botón con la primera interacción o al vencer el plazo de respaldo configurado. El valor cero equivale a 10 segundos.

Problemas conocidos

6

Aviso de configuración desactualizado tras guardar

ResueltoActualizado:
Corregido en: 1.2.3
El aviso de configuración podía seguir indicando que faltaba un ajuste justo después de haberlo guardado.

El enlace de WhatsApp tenía un nombre accesible incorrecto

ResueltoActualizado:
Corregido en: 1.2.0
Los lectores de pantalla podían anunciar una etiqueta distinta del texto visible de WhatsApp o no recibir un nombre útil cuando el texto del botón estaba vacío.

No se mostraban las etiquetas traducidas de los ajustes

ResueltoActualizado:
Corregido en: 1.2.0
Los ajustes podían seguir en inglés pese a las traducciones disponibles.

La página de comprobación de instalación seguía sin traducirse

ResueltoActualizado:
Corregido en: 1.2.1
La página de comprobación de instalación no mostraba sus traducciones disponibles.

Compatibilidad con la combinación de recursos

ResueltoActualizado:
Corregido en: 1.1.15
Los recursos de la integración de WhatsApp no se combinaban correctamente con la optimización nativa de recursos de la tienda.

No se conservaban los ajustes antiguos del chat

ResueltoActualizado:
Corregido en: 1.1.14
Los ajustes del chat guardados por una instalación anterior no se migraban al almacenamiento de ajustes actualizado.

Solicitudes de funcionalidades

5

Implementado

Actualizaciones del módulo con un clic

Implementado
Busca e instala las actualizaciones del módulo desde el back office.

Interfaz multilingüe

Implementado
Usa las etiquetas y los mensajes del módulo traducidos al francés, alemán, español, italiano y polaco.

Comprobación y reparación de la instalación

Implementado
Comprueba la instalación del módulo y restaura las entradas del menú del back office que falten.

Botón de contacto de WhatsApp

Implementado
Ofrece a los compradores un enlace de contacto de WhatsApp desde la tienda.

Textos para visitantes por idioma

Implementado
Define los textos del chat que ven los visitantes por separado para cada idioma de la tienda.

Registro de cambios

v1.1.142026-05-27

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

v1.1.142026-05-26

  • Certified the release ZIP with the shared package surface gate.
  • Rebuilt the package without source maps, build tooling or leaked shared-package development files.
  • Addeda displayFooter fallback so themes that do not render displayBeforeBodyClosingTag still show the WhatsApp button, with a duplicate-render guard for themes that render both hooks.
  • Aligned module source, config.xml, composer metadata, package metadata and live release metadata.
  • Refreshed product-page content with real Back Office and storefront screenshots, and removed unsupported chat-routing, scheduling, device-state and performance claims.

v1.1.132026-05-25

  • Completed locale coverage for WhatsApp Chat configuration and storefront labels.

v1.1.x

  • WhatsApp phone number configuration from PrestaShop Back Office.
  • Optional pre-filled message with {product} and {url} placeholders.
  • Button position, icon/bar style, colour, size, tooltip, animation, mobile visibility, delay and page targeting controls.
  • Back-office readiness checks for the required phone number configuration.

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