PS PrestaShop Débutant

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é.

Mis à jour Version du module 2.0.0

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.
Fenêtre de discussion : équipe avec photos, services, disponibilités et filtre par service
Fenêtre de discussion : équipe avec photos, services, disponibilités et filtre par service

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

  1. Téléchargez dfwhatsapp-2.0.0.zip depuis votre espace client DataFirefly.
  2. Dans le back-office, ouvrez Modules > Gestionnaire de modules et cliquez sur Téléverser un module.
  3. Sélectionnez le fichier zip, puis cliquez sur Configurer.
  4. 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.

  1. Dans Clients > WhatsApp, cliquez sur Ajouter un agent.
  2. 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.
  3. Indiquez le rôle et le service dans chaque langue, ajoutez une photo (JPG, PNG ou WebP, 2 Mo maximum) ou laissez les initiales.
  4. Facultatif : un message d’accueil (première bulle de la fenêtre) et un message prérempli propre à l’agent.
  5. Dans Visibilité, limitez l’agent à certaines langues, à certains groupes de clients ou à certains types de pages, et en multiboutique à certaines boutiques.
Back-office : liste des agents avec photo, service, numéro international vérifié et disponibilité en direct
Back-office : liste des agents avec photo, service, numéro international vérifié et disponibilité en direct

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.
Horaires d’un agent : plusieurs créneaux par jour, remplissage rapide, fuseau horaire et fermetures
Horaires d’un agent : plusieurs créneaux par jour, remplissage rapide, fuseau horaire et fermetures

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.

Bouton WhatsApp flottant avec son texte et la bulle de bienvenue de l’agent sur la page d’accueil
Bouton WhatsApp flottant avec son texte et la bulle de bienvenue de l’agent sur la page d’accueil

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.

Page produit : message prérempli avec le nom et le lien du produit, modifiable avant d’ouvrir WhatsApp
Page produit : message prérempli avec le nom et le lien du produit, modifiable 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.

Panier : bouton « Une question sur votre panier ? » et message avec les articles et le total
Panier : bouton « Une question sur votre panier ? » et message avec les articles et le total

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 ordinateur : QR code de la conversation généré dans le navigateur pour continuer sur le téléphone
Sur ordinateur : QR code de la conversation généré dans le navigateur pour continuer sur le téléphone

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

Sur mobile : fenêtre plein écran avec le message de l’agent et le message prérempli du produit
Sur mobile : fenêtre plein écran avec le message de l’agent et le message prérempli du produit

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.

Réglages de l’apparence avec aperçu en direct : couleur, position, taille, marges et animation
Réglages de l’apparence avec aperçu en direct : couleur, position, taille, marges et animation

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.

Messages préremplis par page, en 8 langues, avec insertion des variables produit, panier et commande
Messages préremplis par page, en 8 langues, avec insertion des variables produit, panier et commande

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.
Équipe absente : formulaire de demande de rappel avec nom, téléphone, message et accord du visiteur
Équipe absente : formulaire de demande de rappel avec nom, téléphone, message et accord du visiteur

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).

Demandes de rappel : statut, téléphone avec lien de réponse WhatsApp, message et langue du visiteur
Demandes de rappel : statut, téléphone avec lien de réponse WhatsApp, message et langue du visiteur

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.
Statistiques anonymes : ouvertures, conversations démarrées, par jour, page, bouton, agent, produit et appareil
Statistiques anonymes : ouvertures, conversations démarrées, par jour, page, bouton, agent, produit et appareil

À 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).
Confidentialité : case d’accord avant WhatsApp, lien vers la politique, statistiques sans adresse IP et durée de conservation
Confidentialité : case d’accord avant WhatsApp, lien vers la politique, statistiques sans adresse IP et durée de conservation

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

  1. Vérifiez la liste de contrôle des paramètres : module activé, au moins un agent actif avec un numéro international valide.
  2. Vérifiez les règles d’affichage : appareils, pages, groupes, exclusions, et la visibilité de chaque agent (langues, groupes, pages, boutiques).
  3. Si le mode hors ligne est « Masquer le bouton », vérifiez les horaires et les fermetures.
  4. 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.
Cette page vous a-t-elle été utile ?

Toujours bloqué ? Contactez le support