PS PrestaShop Beginner

DataFirefly WhatsApp — Documentation

Install, configure and use DataFirefly WhatsApp 2.0.0 on PrestaShop 1.7.8 to 9: agents, opening hours, pre-filled messages, callback requests, statistics and privacy.

Updated Module version 2.0.0

DataFirefly WhatsApp adds a WhatsApp chat button and window to your PrestaShop shop. The visitor chooses who to write to, reads a message already filled in for the page they are on (product, cart, order…), then opens WhatsApp on their phone or computer. You answer from your usual WhatsApp or WhatsApp Business app.

What the module does not do: it does not send any message on your behalf and does not use the WhatsApp Business API. It creates https://wa.me/… chat links that the visitor opens themselves.

How it works

  • The floating button is shown at the bottom of the screen, with an optional text and welcome bubble.
  • The chat window presents your team: photo or initials, role, department, availability (“Online”, “Back tomorrow at 08:30”).
  • The visitor chooses an agent, edits the pre-filled message if they wish and opens WhatsApp.
  • On a computer, they can also scan a QR code to continue on their phone.
  • When nobody is online, you can keep the button, hide it or offer a callback form.
Chat window: team with photos, departments, availability and department filter
Chat window: team with photos, departments, availability and department filter

Installation and upgrade

Requirements

  • PrestaShop 1.7.8 to 9.x (Classic and Hummingbird themes tested)
  • PHP 7.4 to 8.5
  • At least one WhatsApp or WhatsApp Business number, in international format

Installation

  1. Download dfwhatsapp-2.0.0.zip from your DataFirefly customer area.
  2. In the back office, open Modules > Module Manager and click Upload a module.
  3. Select the zip file, then click Configure.
  4. Open Customers > WhatsApp and add your first agent.

The module creates the Customers > WhatsApp menu, with four tabs: Agents & hours, Callback requests, Statistics and Settings. A checklist at the top of the settings shows what is left to do.

Upgrade from 1.0.0

Upload the new zip over the old one: PrestaShop runs the upgrade script. Your agents, opening hours, closures, statistics, callback requests and settings are kept.

  • Each agent’s department is copied into every language of the shop.
  • Numbers are converted to international format when possible; a number without country code is flagged in the agent list and no longer shown on the shop until it is fixed.
  • The “round-robin” and “random” modes become “Share between agents”, the “manual” mode becomes “The customer chooses”.
  • Positions at the top of the screen move to the bottom (same side).
  • SVG avatars are no longer shown (initials replace them): replace them with a JPG, PNG or WebP photo.

Add your agents

An agent is a WhatsApp number shown to your customers: a person, a department or the whole team.

  1. In Customers > WhatsApp, click Add an agent.
  2. Enter the displayed name and the WhatsApp number with the country code, for example +33 6 00 00 00 00. The module checks the format and offers a Test the link button.
  3. Enter the role and department in each language, add a photo (JPG, PNG or WebP, 2 MB max.) or keep the initials.
  4. Optional: a greeting (first bubble of the window) and a pre-filled message of the agent’s own.
  5. In Visibility, limit the agent to some languages, customer groups or page types, and in multistore to some shops.
Back office: list of agents with photo, department, checked international number and live availability
Back office: list of agents with photo, department, checked international number and live availability

Tip: the agent list shows their live availability and flags any number without country code. Drag the rows to change the priority order.

Opening hours, time zones and closures

  • Several slots per day, with quick fill (Mon-Fri 9:00-12:30 / 14:00-18:00, Mon-Sat 10:00-19:00) and copy of Monday to the other days.
  • Overnight slots: a 22:00 – 02:00 slot continues on the next day.
  • One time zone per agent, useful for a team spread over several countries.
  • Closures per agent (holidays) and for the whole team (public holidays), in Settings > Hours & offline.
  • An agent without hours is always shown as online.
Agent opening hours: several slots per day, quick fill, time zone and closures
Agent opening hours: several slots per day, quick fill, time zone and closures

Visitors see when each absent agent is back, for example “Back on Monday at 09:00”.

What visitors see

Button and welcome bubble

The button has a fixed position and does not shift the page. The welcome bubble is optional (adjustable delay, once per visit); the button animation plays three times at most and never when the visitor has asked their system to reduce motion.

Floating WhatsApp button with its text and the agent welcome bubble on the home page
Floating WhatsApp button with its text and the agent welcome bubble on the home page

Pre-filled message and buttons in the pages

On a product page, the “A question about this product?” button is shown under the add to cart button. The message contains the product name and link, updated when the visitor changes the combination. The visitor can edit the text before opening WhatsApp.

Product page: pre-filled message with the product name and link, editable before opening WhatsApp
Product page: pre-filled message with the product name and link, editable before opening WhatsApp

In the cart, the message lists the items, their combinations and the total; on the order confirmation, it contains the order reference.

Cart: "A question about your cart?" button and message with the items and the total
Cart: "A question about your cart?" button and message with the items and the total

On a computer and on a phone

On a computer, WhatsApp Desktop or WhatsApp Web opens. The visitor can also show a QR code of the conversation and continue it on their phone. The QR code is generated in the browser: the link is not sent to any outside service.

On a computer: QR code of the conversation generated in the browser to continue on the phone
On a computer: QR code of the conversation generated in the browser to continue on the phone

On a phone, the window opens full screen and the button opens the WhatsApp app directly.

On a phone: full-screen window with the agent greeting and the pre-filled product message
On a phone: full-screen window with the agent greeting and the pre-filled product message

Settings

Display

  • Button on/off, devices (computers, phones or both), page types and customer groups.
  • Buttons in the pages: product, cart, order confirmation.
  • Agent choice when several are available: the customer chooses, share between agents (each visitor keeps theirs) or by priority.
  • Exclusions: controllers, categories (and their products), products.

Appearance

Colour (with a darker shade computed automatically when white text would not be readable), bottom right or left position, size, computer and mobile margins, animation, text next to the button, window title and subtitle, welcome bubble, QR code on computers. The preview on the right updates while you type, in the selected language.

Appearance settings with live preview: colour, position, size, margins and animation
Appearance settings with live preview: colour, position, size, margins and animation

Messages and variables

One message per page type, in each language. Click a variable to insert it:

{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}. Empty variables are removed from the message.

Pre-filled messages per page, in 8 languages, with product, cart and order variables
Pre-filled messages per page, in 8 languages, with product, cart and order variables

Offline

  • Keep the button: visitors see when you are back and can still write.
  • Callback form: name, phone, message and agreement box; requests arrive in Callback requests, with an optional email.
  • Hide the button: it only appears during opening hours.
Team offline: callback request form with name, phone, message and visitor agreement
Team offline: callback request form with name, phone, message and visitor agreement

Callback requests

Each request shows the name, the phone (with a link to reply on WhatsApp and a call link), the message, the page it was sent from, the language and, if the visitor was logged in, their customer account. Mark it as “Processed” and add an internal note. The form is protected against bots (invisible field, three requests per hour at most).

Callback requests: status, phone with WhatsApp reply link, message and visitor language
Callback requests: status, phone with WhatsApp reply link, message and visitor language

Statistics

The Statistics tab shows, over the chosen period (7, 30, 90 days or custom dates):

  • chat window openings, conversations started and their ratio;
  • QR codes shown and callback requests;
  • the breakdown per day, page, button, agent, product, device and hour;
  • a CSV export of the daily data.
Anonymous statistics: openings, conversations started, per day, page, button, agent, product and device
Anonymous statistics: openings, conversations started, per day, page, button, agent, product and device

Good to know: a “conversation started” means that WhatsApp was opened. The module cannot know whether the message was actually sent.

Privacy

  • No WhatsApp or Meta script is loaded on the shop: WhatsApp only opens when the visitor clicks.
  • An optional agreement box before WhatsApp opens and in the callback form, with a link to your privacy policy page.
  • Statistics store no IP address and no customer identifier: visitors are counted with a pseudonym that changes every day. Adjustable retention period (180 days by default).
  • A customer’s callback requests are exported and deleted with their data (official PrestaShop GDPR module and customer deletion).
Privacy: agreement box before WhatsApp, policy link, statistics without IP address and retention period
Privacy: agreement box before WhatsApp, policy link, statistics without IP address and retention period

Important: the text of the agreement box and your privacy policy remain your responsibility. Have them checked by your adviser.

Accessibility and performance

  • Keyboard navigation, closing with Escape, focus moved into the window then returned to the button, translated labels for screen readers.
  • One light stylesheet and script, without external font or library; the QR code generator is only loaded on click.
  • The button has a fixed position: it does not cause layout shift.

Compatibility

  • PrestaShop 1.7.8, 8.0 to 8.2, 9.0 and 9.1 (tested on 1.7.8.11, 8.2.1 and 9.1.5)
  • PHP 7.4 to 8.5
  • Classic and Hummingbird themes (standard PrestaShop hooks)
  • Multistore (agents assigned to shops, settings per shop) and multilingual
  • 8 languages included: French, English, Spanish, German, Italian, Dutch, Polish and Portuguese

Troubleshooting

The button does not appear

  1. Check the checklist of the settings: module enabled, at least one active agent with a valid international number.
  2. Check the display rules: devices, pages, groups, exclusions, and each agent’s visibility (languages, groups, pages, shops).
  3. If the offline mode is “Hide the button”, check the opening hours and closures.
  4. Clear the PrestaShop cache (Advanced Parameters > Performance).

An agent does not appear

Their number probably has no country code (red badge in the list) or their visibility excludes the current language, group or page.

Statistics stay empty

Check that “Count openings and conversations” is on in Settings > Privacy & statistics. Bots and automated test visits are not counted.

Changelog

2.0.0 — 7 November 2026

  • PrestaShop 1.7.8 to 9.x compatibility.
  • Fixed: module CSS, JS and image files blocked, Statistics page, callback form.
  • New chat window: team, departments, availability, editable message, QR code generated in the browser.
  • Several slots per day, overnight slots, time zone per agent, team closures.
  • Display per page, group, language, device and shop.
  • Product, cart and order buttons; 15 variables.
  • Callback requests in the back office, optional email notification.
  • Anonymous statistics, CSV export, retention period, GDPR export and deletion.
  • New back office with live preview; 8 languages.

1.0.0 — 13 May 2026

  • Initial version.
Was this page helpful?

Still stuck? Contact support