PS PrestaShop Principiante

DataFirefly WhatsApp — Documentación

Instalar, configurar y utilizar DataFirefly WhatsApp 2.0.0 en PrestaShop 1.7.8 a 9: agentes, horarios de apertura, mensajes predefinidos, solicitudes de llamada, estadísticas y privacidad.

Actualizado Versión del módulo 2.0.0

DataFirefly WhatsApp añade a su tienda PrestaShop un botón y una ventana de chat de WhatsApp. El visitante elige a quién escribir, lee un mensaje ya rellenado según la página en la que se encuentra (producto, carrito, pedido…) y después abre WhatsApp en su teléfono u ordenador. Usted responde desde su aplicación habitual de WhatsApp o WhatsApp Business.

Lo que el módulo no hace: no envía ningún mensaje en su nombre y no utiliza la API de WhatsApp Business. Crea enlaces de chat https://wa.me/… que el propio visitante abre.

Funcionamiento

  • El botón flotante se muestra en la parte inferior de la pantalla, con un texto y una burbuja de bienvenida opcionales.
  • La ventana de chat presenta a su equipo: foto o iniciales, cargo, departamento, disponibilidad («En línea», «Vuelve mañana a las 08:30»).
  • El visitante elige un agente, edita el mensaje predefinido si lo desea y abre WhatsApp.
  • En un ordenador, también puede escanear un código QR para continuar en su teléfono.
  • Cuando no hay nadie en línea, puede mantener el botón, ocultarlo o proponer un formulario de llamada.
Ventana de chat: equipo con fotos, departamentos, disponibilidad y filtro por departamento
Ventana de chat: equipo con fotos, departamentos, disponibilidad y filtro por departamento

Instalación y actualización

Requisitos

  • PrestaShop 1.7.8 a 9.x (temas Classic y Hummingbird probados)
  • PHP 7.4 a 8.5
  • Al menos un número de WhatsApp o WhatsApp Business, en formato internacional

Instalación

  1. Descargue dfwhatsapp-2.0.0.zip desde su área de cliente de DataFirefly.
  2. En el back office, abra Módulos > Gestor de módulos y haga clic en Subir un módulo.
  3. Seleccione el archivo zip y, a continuación, haga clic en Configurar.
  4. Abra Clientes > WhatsApp y añada su primer agente.

El módulo crea el menú Clientes > WhatsApp, con cuatro pestañas: Agentes y horarios, Solicitudes de llamada, Estadísticas y Configuración. Una lista de comprobación en la parte superior de la configuración indica lo que queda por hacer.

Actualización desde la 1.0.0

Suba el nuevo zip sobre el anterior: PrestaShop ejecuta el script de actualización. Se conservan sus agentes, horarios de apertura, cierres, estadísticas, solicitudes de llamada y ajustes.

  • El departamento de cada agente se copia en todos los idiomas de la tienda.
  • Los números se convierten al formato internacional cuando es posible; un número sin prefijo del país se señala en la lista de agentes y deja de mostrarse en la tienda hasta que se corrija.
  • Los modos «round-robin» y «aleatorio» pasan a ser «Repartir entre los agentes»; el modo «manual» pasa a ser «El cliente elige».
  • Las posiciones en la parte superior de la pantalla pasan a la parte inferior (mismo lado).
  • Los avatares SVG ya no se muestran (las iniciales los sustituyen): sustitúyalos por una foto JPG, PNG o WebP.

Añada sus agentes

Un agente es un número de WhatsApp que se muestra a sus clientes: una persona, un departamento o todo el equipo.

  1. En Clientes > WhatsApp, haga clic en Añadir un agente.
  2. Introduzca el nombre mostrado a los clientes y el número de WhatsApp con el prefijo del país, por ejemplo +33 6 00 00 00 00. El módulo comprueba el formato y ofrece un botón Probar el enlace.
  3. Introduzca el cargo y el departamento en cada idioma, añada una foto (JPG, PNG o WebP, 2 MB como máximo) o conserve las iniciales.
  4. Opcional: un saludo (primera burbuja de la ventana) y un mensaje predefinido propio del agente.
  5. En Visibilidad, limite el agente a determinados idiomas, grupos de clientes o tipos de página y, en multitienda, a determinadas tiendas.
Back office: lista de agentes con foto, departamento, número internacional verificado y disponibilidad en directo
Back office: lista de agentes con foto, departamento, número internacional verificado y disponibilidad en directo

Consejo: la lista de agentes muestra su disponibilidad en tiempo real y señala cualquier número sin prefijo del país. Arrastre las filas para cambiar el orden de prioridad.

Horarios de apertura, zonas horarias y cierres

  • Varias franjas horarias por día, con relleno rápido (Lun-Vie 9:00-12:30 / 14:00-18:00, Lun-Sáb 10:00-19:00) y copia del lunes a los demás días.
  • Franjas nocturnas: una franja 22:00 – 02:00 continúa el día siguiente.
  • Una zona horaria por agente, útil para un equipo repartido en varios países.
  • Cierres por agente (vacaciones) y para todo el equipo (días festivos), en Configuración > Horarios y fuera de línea.
  • Un agente sin horario se muestra siempre en línea.
Horario de un agente: varias franjas por día, relleno rápido, zona horaria y cierres
Horario de un agente: varias franjas por día, relleno rápido, zona horaria y cierres

Los visitantes ven cuándo vuelve cada agente ausente, por ejemplo «Vuelve el lunes a las 09:00».

Lo que ven los visitantes

Botón y burbuja de bienvenida

El botón tiene una posición fija y no desplaza la página. La burbuja de bienvenida es opcional (retraso ajustable, una vez por visita); la animación del botón se reproduce tres veces como máximo y nunca cuando el visitante ha pedido a su sistema que reduzca el movimiento.

Botón flotante de WhatsApp con su texto y la burbuja de bienvenida del agente en la página de inicio
Botón flotante de WhatsApp con su texto y la burbuja de bienvenida del agente en la página de inicio

Mensaje predefinido y botones en las páginas

En una página de producto, el botón «¿Alguna pregunta sobre este producto?» se muestra debajo del botón de añadir al carrito. El mensaje contiene el nombre y el enlace del producto, actualizados cuando el visitante cambia la combinación. El visitante puede editar el texto antes de abrir WhatsApp.

Página de producto: mensaje prerrellenado con el nombre y el enlace del producto, editable antes de abrir WhatsApp
Página de producto: mensaje prerrellenado con el nombre y el enlace del producto, editable antes de abrir WhatsApp

En el carrito, el mensaje enumera los artículos, sus combinaciones y el total; en la confirmación del pedido, contiene la referencia del pedido.

Carrito: botón «¿Una pregunta sobre su carrito?» y mensaje con los artículos y el total
Carrito: botón «¿Una pregunta sobre su carrito?» y mensaje con los artículos y el total

En un ordenador y en un teléfono

En un ordenador, se abre WhatsApp Desktop o WhatsApp Web. El visitante también puede mostrar un código QR de la conversación y continuarla en su teléfono. El código QR se genera en el navegador: el enlace no se envía a ningún servicio externo.

En el ordenador: código QR de la conversación generado en el navegador para continuar en el móvil
En el ordenador: código QR de la conversación generado en el navegador para continuar en el móvil

En un teléfono, la ventana se abre a pantalla completa y el botón abre directamente la aplicación WhatsApp.

En el móvil: ventana a pantalla completa con el saludo del agente y el mensaje prerrellenado del producto
En el móvil: ventana a pantalla completa con el saludo del agente y el mensaje prerrellenado del producto

Configuración

Visualización

  • Botón activado/desactivado, dispositivos (ordenadores, teléfonos o ambos), tipos de página y grupos de clientes.
  • Botones en las páginas: producto, carrito, confirmación del pedido.
  • Elección del agente cuando hay varios disponibles: el cliente elige, repartir entre los agentes (cada visitante conserva el suyo) o por prioridad.
  • Exclusiones: controladores, categorías (y sus productos), productos.

Apariencia

Color (con un tono más oscuro calculado automáticamente cuando el texto blanco no sería legible), posición abajo a la derecha o a la izquierda, tamaño, márgenes en ordenador y móvil, animación, texto junto al botón, título y subtítulo de la ventana, burbuja de bienvenida, código QR en ordenadores. La vista previa de la derecha se actualiza mientras escribe, en el idioma seleccionado.

Ajustes de apariencia con vista previa en directo: color, posición, tamaño, márgenes y animación
Ajustes de apariencia con vista previa en directo: color, posición, tamaño, márgenes y animación

Mensajes y variables

Un mensaje por tipo de página, en cada idioma. Haga clic en una variable para insertarla:

{shop_name}, {customer_firstname}, {customer_name}, {page_url}, {page_title}, {product_name}, {product_ref}, {product_price}, {product_url}, {category_name}, {cart_total}, {cart_products}, {cart_id}, {order_ref}, {order_total}. Las variables vacías se eliminan del mensaje.

Mensajes prerrellenados por página, en 8 idiomas, con variables de producto, carrito y pedido
Mensajes prerrellenados por página, en 8 idiomas, con variables de producto, carrito y pedido

Fuera de línea

  • Mantener el botón: los visitantes ven cuándo vuelve y pueden escribir igualmente.
  • Formulario de llamada: nombre, teléfono, mensaje y casilla de consentimiento; las solicitudes llegan a Solicitudes de llamada, con un correo electrónico opcional.
  • Ocultar el botón: solo aparece durante los horarios de apertura.
Equipo no disponible: formulario de solicitud de llamada con nombre, teléfono, mensaje y consentimiento
Equipo no disponible: formulario de solicitud de llamada con nombre, teléfono, mensaje y consentimiento

Solicitudes de llamada

Cada solicitud muestra el nombre, el teléfono (con un enlace para responder por WhatsApp y un enlace de llamada), el mensaje, la página desde la que se envió, el idioma y, si el visitante había iniciado sesión, su cuenta de cliente. Márquela como «Procesada» y añada una nota interna. El formulario está protegido contra los bots (campo invisible, tres solicitudes por hora como máximo).

Solicitudes de llamada: estado, teléfono con enlace de respuesta por WhatsApp, mensaje e idioma del visitante
Solicitudes de llamada: estado, teléfono con enlace de respuesta por WhatsApp, mensaje e idioma del visitante

Estadísticas

La pestaña Estadísticas muestra, en el periodo elegido (7, 30, 90 días o fechas personalizadas):

  • las aperturas de la ventana de chat, las conversaciones iniciadas y su proporción;
  • los códigos QR mostrados y las solicitudes de llamada;
  • el desglose por día, página, botón, agente, producto, dispositivo y hora;
  • una exportación CSV de los datos diarios.
Estadísticas anónimas: aperturas, conversaciones iniciadas, por día, página, botón, agente, producto y dispositivo
Estadísticas anónimas: aperturas, conversaciones iniciadas, por día, página, botón, agente, producto y dispositivo

Conviene saber: una «conversación iniciada» significa que se abrió WhatsApp. El módulo no puede saber si el mensaje se envió realmente.

Privacidad

  • No se carga ningún script de WhatsApp ni de Meta en la tienda: WhatsApp solo se abre cuando el visitante hace clic.
  • Una casilla de consentimiento opcional antes de abrir WhatsApp y en el formulario de llamada, con un enlace a su página de política de privacidad.
  • Las estadísticas no almacenan ninguna dirección IP ni ningún identificador de cliente: los visitantes se cuentan con un seudónimo que cambia cada día. Periodo de conservación ajustable (180 días por defecto).
  • Las solicitudes de llamada de un cliente se exportan y eliminan con sus datos (módulo RGPD oficial de PrestaShop y eliminación de clientes).
Privacidad: casilla de consentimiento antes de WhatsApp, enlace a la política, estadísticas sin dirección IP y plazo de conservación
Privacidad: casilla de consentimiento antes de WhatsApp, enlace a la política, estadísticas sin dirección IP y plazo de conservación

Importante: el texto de la casilla de consentimiento y su política de privacidad siguen siendo responsabilidad suya. Hágalos revisar por su asesor.

Accesibilidad y rendimiento

  • Navegación con el teclado, cierre con Escape, foco desplazado a la ventana y devuelto después al botón, etiquetas traducidas para los lectores de pantalla.
  • Una hoja de estilos y un script ligeros, sin fuente ni biblioteca externas; el generador de códigos QR solo se carga al hacer clic.
  • El botón tiene una posición fija: no provoca desplazamientos del diseño.

Compatibilidad

  • PrestaShop 1.7.8, 8.0 a 8.2, 9.0 y 9.1 (probado en 1.7.8.11, 8.2.1 y 9.1.5)
  • PHP 7.4 a 8.5
  • Temas Classic y Hummingbird (hooks estándar de PrestaShop)
  • Multitienda (agentes asignados a tiendas, configuración por tienda) y multilingüe
  • 8 idiomas incluidos: francés, inglés, español, alemán, italiano, neerlandés, polaco y portugués

Solución de problemas

El botón no aparece

  1. Revise la lista de comprobación de la configuración: módulo activado, al menos un agente activo con un número internacional válido.
  2. Revise las reglas de visualización: dispositivos, páginas, grupos, exclusiones y la visibilidad de cada agente (idiomas, grupos, páginas, tiendas).
  3. Si el modo fuera de línea es «Ocultar el botón», revise los horarios de apertura y los cierres.
  4. Vacíe la caché de PrestaShop (Parámetros Avanzados > Rendimiento).

Un agente no aparece

Probablemente su número no tiene prefijo del país (etiqueta roja en la lista) o su visibilidad excluye el idioma, el grupo o la página actuales.

Las estadísticas siguen vacías

Compruebe que «Contar las aperturas y las conversaciones» está activado en Configuración > Privacidad y estadísticas. Los bots y las visitas de prueba automatizadas no se cuentan.

Historial de cambios

2.0.0 — 7 de noviembre de 2026

  • Compatibilidad con PrestaShop 1.7.8 a 9.x.
  • Corregido: archivos CSS, JS e imágenes del módulo bloqueados, página de Estadísticas, formulario de llamada.
  • Nueva ventana de chat: equipo, departamentos, disponibilidad, mensaje editable, código QR generado en el navegador.
  • Varias franjas por día, franjas nocturnas, zona horaria por agente, cierres del equipo.
  • Visualización por página, grupo, idioma, dispositivo y tienda.
  • Botones de producto, carrito y pedido; 15 variables.
  • Solicitudes de llamada en el back office, notificación opcional por correo electrónico.
  • Estadísticas anónimas, exportación CSV, periodo de conservación, exportación y eliminación RGPD.
  • Nuevo back office con vista previa en tiempo real; 8 idiomas.

1.0.0 — 13 de mayo de 2026

  • Versión inicial.
¿Te ha resultado útil esta página?

¿Sigues atascado? Contacta con soporte