DataFirefly WhatsApp — Documentation
Installer, configurer et utiliser DataFirefly WhatsApp 2.0.0 sur PrestaShop 1.7.8 à 9 : agents, horaires, messages préremplis, demandes de rappel, statistiques et confidentialité.
DataFirefly WhatsApp ajoute à votre boutique PrestaShop un bouton et une fenêtre de discussion WhatsApp. Le visiteur choisit la personne à qui écrire, relit un message déjà rempli selon la page consultée (produit, panier, commande…), puis ouvre WhatsApp sur son téléphone ou son ordinateur. Vous répondez depuis votre application WhatsApp ou WhatsApp Business habituelle.
Ce que le module ne fait pas : il n’envoie aucun message à votre place et n’utilise pas l’API WhatsApp Business. Il crée des liens de discussion https://wa.me/… que le visiteur ouvre lui-même.
Fonctionnement
- Le bouton flottant s’affiche en bas de l’écran, avec un texte facultatif et une bulle de bienvenue.
- La fenêtre de discussion présente votre équipe : photo ou initiales, rôle, service, disponibilité (« En ligne », « De retour demain à 08:30 »).
- Le visiteur choisit un agent, modifie le message prérempli s’il le souhaite et ouvre WhatsApp.
- Sur ordinateur, il peut aussi scanner un QR code pour continuer sur son téléphone.
- Quand personne n’est en ligne, vous pouvez garder le bouton, le masquer ou proposer un formulaire de rappel.

Installation et mise à jour
Prérequis
- PrestaShop 1.7.8 à 9.x (thèmes Classic et Hummingbird testés)
- PHP 7.4 à 8.5
- Au moins un numéro WhatsApp ou WhatsApp Business, au format international
Installation
- Téléchargez
dfwhatsapp-2.0.0.zipdepuis votre espace client DataFirefly. - Dans le back-office, ouvrez Modules > Gestionnaire de modules et cliquez sur Téléverser un module.
- Sélectionnez le fichier zip, puis cliquez sur Configurer.
- Ouvrez Clients > WhatsApp et ajoutez votre premier agent.
Le module crée le menu Clients > WhatsApp, avec quatre onglets : Agents et horaires, Demandes de rappel, Statistiques et Paramètres. Une liste de contrôle en haut des paramètres indique ce qu’il reste à faire.
Mise à jour depuis la 1.0.0
Téléversez le nouveau zip par-dessus l’ancien : PrestaShop exécute le script de mise à jour. Vos agents, horaires, fermetures, statistiques, demandes de rappel et réglages sont conservés.
- Le service de chaque agent est copié dans toutes les langues de la boutique.
- Les numéros sont convertis au format international quand c’est possible ; un numéro sans indicatif pays est signalé dans la liste des agents et n’est plus affiché sur la boutique tant qu’il n’est pas corrigé.
- Les modes « round-robin » et « aléatoire » deviennent « Répartir entre les agents », le mode « manuel » devient « Le client choisit ».
- Les positions en haut de l’écran passent en bas (même côté).
- Les avatars SVG ne sont plus affichés (les initiales les remplacent) : remplacez-les par une photo JPG, PNG ou WebP.
Ajouter les agents
Un agent est un numéro WhatsApp présenté à vos clients : une personne, un service ou toute l’équipe.
- Dans Clients > WhatsApp, cliquez sur Ajouter un agent.
- Saisissez le nom affiché et le numéro WhatsApp avec l’indicatif pays, par exemple
+33 6 00 00 00 00. Le module vérifie le format et propose un bouton Tester le lien. - Indiquez le rôle et le service dans chaque langue, ajoutez une photo (JPG, PNG ou WebP, 2 Mo maximum) ou laissez les initiales.
- Facultatif : un message d’accueil (première bulle de la fenêtre) et un message prérempli propre à l’agent.
- Dans Visibilité, limitez l’agent à certaines langues, à certains groupes de clients ou à certains types de pages, et en multiboutique à certaines boutiques.

Astuce : la liste des agents affiche en direct leur disponibilité et signale tout numéro sans indicatif pays. Faites glisser les lignes pour changer l’ordre de priorité.
Horaires, fuseaux et fermetures
- Plusieurs créneaux par jour, avec un remplissage rapide (lundi-vendredi 9:00-12:30 / 14:00-18:00, lundi-samedi 10:00-19:00) et la copie du lundi sur les autres jours.
- Créneaux de nuit : un créneau 22:00 – 02:00 continue le lendemain.
- Un fuseau horaire par agent, utile pour une équipe répartie dans plusieurs pays.
- Des fermetures par agent (congés) et pour toute l’équipe (jours fériés), dans Paramètres > Horaires et hors ligne.
- Un agent sans horaires est toujours affiché en ligne.

Le visiteur voit l’heure de retour de chaque agent absent, par exemple « De retour lundi à 09:00 ».
Ce que voit le visiteur
Bouton et bulle de bienvenue
Le bouton reste en position fixe et ne décale pas la page. La bulle de bienvenue est facultative (délai réglable, une fois par visite) ; l’animation du bouton est jouée trois fois au maximum et jamais si le visiteur a demandé à son système de réduire les animations.

Message prérempli et boutons dans les pages
Sur une fiche produit, le bouton « Une question sur ce produit ? » s’affiche sous le bouton d’ajout au panier. Le message contient le nom et le lien du produit, mis à jour si le visiteur change de déclinaison. Le visiteur peut modifier le texte avant d’ouvrir WhatsApp.

Au panier, le message liste les articles, leurs déclinaisons et le total ; sur la confirmation de commande, il contient la référence de commande.

Sur ordinateur et sur mobile
Sur ordinateur, WhatsApp Desktop ou WhatsApp Web s’ouvre. Le visiteur peut aussi afficher un QR code de la conversation et la poursuivre sur son téléphone. Le QR code est généré dans le navigateur : le lien n’est envoyé à aucun service extérieur.

Sur mobile, la fenêtre s’ouvre en plein écran et le bouton ouvre directement l’application WhatsApp.

Réglages
Affichage
- Activation du bouton, appareils (ordinateurs, mobiles ou les deux), types de pages et groupes de clients.
- Boutons dans les pages : produit, panier, confirmation de commande.
- Choix de l’agent quand plusieurs sont disponibles : le client choisit, répartition entre les agents (chaque visiteur garde le sien) ou par priorité.
- Exclusions : contrôleurs, catégories (et leurs produits), produits.
Apparence
Couleur (avec une teinte plus foncée calculée automatiquement si le texte blanc n’est pas assez lisible), position en bas à droite ou à gauche, taille, marges ordinateur et mobile, animation, texte à côté du bouton, titre et sous-titre de la fenêtre, bulle de bienvenue, QR code sur ordinateur. L’aperçu à droite se met à jour pendant la saisie, dans la langue choisie.

Messages et variables
Un message par type de page, dans chaque langue. Cliquez sur une variable pour l’insérer :
{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}. Les variables vides sont retirées du message.

Hors ligne
- Garder le bouton : le visiteur voit l’heure de retour et peut quand même écrire.
- Formulaire de rappel : nom, téléphone, message et case d’accord ; les demandes arrivent dans Demandes de rappel, avec un e-mail facultatif.
- Masquer le bouton : il n’apparaît que pendant les horaires.

Demandes de rappel
Chaque demande indique le nom, le téléphone (avec un lien pour répondre sur WhatsApp et un lien d’appel), le message, la page d’origine, la langue et, si le visiteur était connecté, son compte client. Passez-la en « Traitée » et ajoutez une note interne. Le formulaire est protégé contre les robots (champ invisible, trois demandes par heure au maximum).

Statistiques
L’onglet Statistiques présente, sur la période choisie (7, 30, 90 jours ou dates libres) :
- les ouvertures de la fenêtre, les conversations démarrées et leur rapport ;
- les QR codes affichés et les demandes de rappel ;
- la répartition par jour, par page, par bouton, par agent, par produit, par appareil et par heure ;
- l’export CSV des données journalières.

À savoir : une « conversation démarrée » signifie que WhatsApp a été ouvert. Le module ne peut pas savoir si le message a réellement été envoyé.
Confidentialité
- Aucun script WhatsApp ou Meta n’est chargé sur la boutique : WhatsApp ne s’ouvre qu’au clic du visiteur.
- Une case d’accord facultative avant l’ouverture de WhatsApp et dans le formulaire de rappel, avec un lien vers votre page de politique de confidentialité.
- Les statistiques ne stockent ni adresse IP ni identifiant client : les visiteurs sont comptés avec un pseudonyme qui change chaque jour. Durée de conservation réglable (180 jours par défaut).
- Les demandes de rappel d’un client sont exportées et supprimées avec ses données (module officiel RGPD de PrestaShop et suppression du client).

Important : le texte de la case d’accord et votre politique de confidentialité restent sous votre responsabilité. Faites-les valider par votre conseil.
Accessibilité et performances
- Navigation au clavier, fermeture avec Échap, focus déplacé dans la fenêtre puis rendu au bouton, libellés traduits pour les lecteurs d’écran.
- Une feuille de style et un script légers, sans police ni bibliothèque externe ; le générateur de QR code n’est chargé qu’au clic.
- Le bouton est en position fixe : il ne provoque pas de décalage de mise en page.
Compatibilité
- PrestaShop 1.7.8, 8.0 à 8.2, 9.0 et 9.1 (testé sur 1.7.8.11, 8.2.1 et 9.1.5)
- PHP 7.4 à 8.5
- Thèmes Classic et Hummingbird (crochets standard de PrestaShop)
- Multiboutique (agents associés aux boutiques, réglages par boutique) et multilangue
- 8 langues incluses : français, anglais, espagnol, allemand, italien, néerlandais, polonais et portugais
Dépannage
Le bouton ne s’affiche pas
- Vérifiez la liste de contrôle des paramètres : module activé, au moins un agent actif avec un numéro international valide.
- Vérifiez les règles d’affichage : appareils, pages, groupes, exclusions, et la visibilité de chaque agent (langues, groupes, pages, boutiques).
- Si le mode hors ligne est « Masquer le bouton », vérifiez les horaires et les fermetures.
- Videz le cache de PrestaShop (Paramètres avancés > Performances).
Un agent n’apparaît pas
Son numéro n’a sans doute pas d’indicatif pays (badge rouge dans la liste) ou sa visibilité exclut la langue, le groupe ou la page en cours.
Les statistiques restent vides
Vérifiez que « Compter les ouvertures et les conversations » est activé dans Paramètres > Confidentialité et statistiques. Les robots et les visites de test automatisées ne sont pas comptés.
Changelog
2.0.0 — 7 novembre 2026
- Compatibilité PrestaShop 1.7.8 à 9.x.
- Correction du blocage des fichiers CSS, JS et images du module, de la page Statistiques et du formulaire de rappel.
- Nouvelle fenêtre de discussion : équipe, services, disponibilité, message modifiable, QR code généré dans le navigateur.
- Horaires multiples, créneaux de nuit, fuseau par agent, fermetures d’équipe.
- Affichage par page, groupe, langue, appareil et boutique.
- Bouton produit, panier et commande ; 15 variables.
- Demandes de rappel dans le back-office, notification par e-mail facultative.
- Statistiques anonymes, export CSV, durée de conservation, export et suppression RGPD.
- Nouveau back-office avec aperçu en direct ; 8 langues.
1.0.0 — 13 mai 2026
- Version initiale.