DataFirefly WhatsApp: documentatie

Welkom bij de documentatie van de module DataFirefly WhatsApp. Deze gids behandelt alles wat u nodig hebt om uw zwevende WhatsApp-knop met meerdere agenten op PrestaShop 8 en 9 te installeren, in te stellen en optimaal te benutten.

Installatie

De module installeert zich zoals elke andere PrestaShop-module, in enkele klikken.

Vereisten

• PrestaShop 8.0.x of 9.0.x
• PHP 8.0 of hoger (8.1+ aanbevolen)
• MySQL 5.6+ of MariaDB 10.3+
• Minstens één WhatsApp-nummer (privé of Business)

Installatiestappen

1. Download het bestand dfwhatsapp-v1.0.0.zip vanuit uw DataFirefly-klantenaccount
2. Ga in de PrestaShop-backoffice naar Modules > Modulebeheer
3. Klik rechtsboven op Een module uploaden
4. Selecteer het ZIP-bestand en bevestig
5. Klik op Installeren zodra de module verschijnt
6. Klik op Configureren om het instellingenscherm te openen

Algemene configuratie

De configuratiepagina van de module is opgedeeld in 6 tabbladen, zodat u alles kunt instellen zonder het overzicht te verliezen.

Tabblad Algemeen

• Module activeren: hoofdschakelaar, schakelt de knop op de hele webshop uit
• Modus voor agentkeuze: round-robin, willekeurig, eerste beschikbare of handmatig
• Tracking activeren: nodig om het analyticsdashboard te voeden
• QR-code op desktop: toont een QR-code in plaats van WhatsApp Web te openen op vaste computers

Tabblad Weergave

• Positie: vier mogelijke hoeken (rechtsonder, linksonder, rechtsboven, linksboven)
• Kleur: standaard het WhatsApp-groen #25D366
• Formaat van het pictogram: in pixels (standaard 60)
• Verschuiving X / Y: afstand tot de schermrand
• Animatie: pulse, bounce, shake of geen
• Tekstlabel: optioneel label naast de knop

Tabblad Berichten

Een apart vooraf ingevuld bericht voor elk paginatype (product, winkelwagen, categorie, CMS, bestelling, home), vertaald in de 4 meegeleverde talen.

Tabblad Planning

• Modus buiten openingstijden:
  • hide: de knop verdwijnt volledig
  • show_offline: de knop blijft grijs zichtbaar met een wachtbericht
  • callback: een terugbelformulier vervangt het rechtstreekse gesprek
• Bericht buiten openingstijden: tekst die verschijnt wanneer alle agenten offline zijn

Tabblad AVG

• Toestemming activeren: toont een toestemmingstekst voordat WhatsApp opent
• Tekst van de toestemming: aanpasbaar per taal

Tabblad Uitsluitingen

• Uitgesloten pagina’s: lijst met controllers (bijvoorbeeld checkout, identity)
• Uitgesloten categorieën: categorie-ID’s gescheiden door komma’s
• Uitgesloten producten: product-ID’s gescheiden door komma’s

Beheer van de agenten

Het hart van de module: hier voegt u de personen toe die de WhatsApp-berichten zullen ontvangen.

Een agent toevoegen

1. Ga naar Verkopen > Catalogus > WhatsApp-agenten
2. Klik op Toevoegen
3. Vul in:
   • Naam: de naam die de klant ziet (bijvoorbeeld “Alex”)
   • Telefoon: in internationaal formaat zonder spaties (bijvoorbeeld 33604525981)
   • Afdeling: vrij in te vullen (Support, Verkoop, Techniek enzovoort)
   • Avatar: optionele afbeelding (png, jpg, svg, webp)
   • Positie: volgorde van weergave in de handmatige modus
   • Rol: tekst vertaald in de 4 talen (bijvoorbeeld “Technische support”)
   • Persoonlijk bericht: optionele override van de contextuele berichten

De uren van een agent instellen

Rechtstreeks in het formulier van de agent kunt u met een weektabel het volgende bepalen:

• Meerdere tijdsblokken per dag (bijvoorbeeld 9.00-12.30 uur en 14.00-18.30 uur)
• Een lege dag betekent dat de agent die dag offline is
• Een agent zonder enig ingesteld tijdsblok geldt als altijd online (24/7-modus)

Een uitzondering toevoegen (feestdag, verlof)

1. In het formulier van de agent, onder Uitzonderingen
2. Vul een begindatum en een einddatum in
3. Voeg een optioneel label toe (bijvoorbeeld “Zomerverlof”)

Contextuele variabelen

De vooraf ingevulde berichten ondersteunen 12 variabelen die ter plekke worden vervangen naargelang de pagina waarop de klant zich bevindt:

• {product_name}: naam van het product (productpagina)
• {product_url}: volledige URL van het product
• {product_price}: prijs met valuta opgemaakt
• {product_ref}: productreferentie
• {customer_name}: naam van de klant indien ingelogd
• {cart_id}: ID van de winkelwagen
• {cart_total}: opgemaakt totaal van de winkelwagen
• {cart_summary}: lijst met de artikelen in de winkelwagen
• {order_ref}: referentie van de bestelling
• {order_total}: totaal van de bestelling
• {category_name}: naam van de huidige categorie
• {shop_name}: naam van de webshop

Verdeelmodi voor de agenten

Round-robin

De module wisselt bij elke nieuwe opening af tussen de beschikbare agenten, wat de belasting vanzelf gelijkmatig verdeelt.

Willekeurig

Er wordt willekeurig een agent gekozen uit wie online is. Handig wanneer een gelijke verdeling tussen de agenten niet doorslaggevend is.

Eerste beschikbare

De eerste agent in de lijst (volgens de positie) die op dat moment online is, wordt gekozen.

Handmatig

De klant krijgt een pop-up met de lijst van beschikbare agenten (avatar, naam, rol, status). Hij kiest zelf zijn gesprekspartner.

Analytics en AVG

Het dashboard

Bereikbaar via Verkopen > Catalogus > WhatsApp Analytics, toont het:

• Het totale aantal kliks in de periode
• Het aantal unieke bezoekers (via de gehashte IP)
• De verhouding kliks per bezoeker
• De verdeling per dag, per paginatype en per agent
• De top 20 van producten die de meeste gesprekken uitlokken

Gegevensbescherming

QR-code op desktop

Op desktopcomputers kunt u, in plaats van WhatsApp Web te openen (waarbij de klant stelselmatig een QR-code moet scannen), de rechtstreekse QR-codemodus activeren:

• De module genereert een QR-code met de wa.me-link en het vooraf ingevulde bericht
• De klant scant met zijn telefoon
• WhatsApp opent meteen op zijn mobiel met het bericht klaar om te versturen

Die modus houdt het gesprek op het kanaal dat de klant verkiest, zonder extra wrijving.

Terugbelformulier

Wanneer al uw agenten offline zijn en u de modus callback hebt gekozen:

1. De klant krijgt een formulier te zien in plaats van het gebruikelijke gesprek
2. Hij vult zijn naam, zijn telefoonnummer en een optioneel bericht in
3. De aanvraag wordt opgeslagen in de tabel ps_dfwhatsapp_callback met de status pending
4. U kunt de aanvragen raadplegen via phpMyAdmin of er een eigen rapport op bouwen

Meertaligheid

De module wordt geleverd met 4 volledige talen: Frans, Engels, Spaans en Duits. Alle teksten die de klant ziet, zijn vertaald:

• Contextuele berichten per pagina
• Tekst van de AVG-toestemming
• Bericht van de welkomstpop-up
• Labels van de agenten (rol, status)
• Interface van het terugbelformulier
• Bericht buiten openingstijden

U kunt ook per taal en per agent een andere rol en een ander persoonlijk bericht instellen, rechtstreeks in het formulier van de agent door van taaltabblad te wisselen.

Compatibiliteit

• PrestaShop 8.0.x, 8.1.x, 8.2.x, 9.0.x
• PHP 8.0 tot 8.3
• Multistore ja (aparte instellingen per winkel)
• Meertalig ja (Polylang niet vereist)
• Cache compatibel (Hummingbird, LSCache, Redis)
• Override van een coreklasse: geen

Probleemoplossing

De knop verschijnt niet

1. Controleer of de module geactiveerd is onder Algemeen
2. Controleer of er minstens één agent bestaat met de status Actief
3. Controleer of de huidige pagina niet in de lijst met uitsluitingen staat
4. Leeg de PrestaShop-cache (Geavanceerde instellingen > Prestaties)
5. Leeg de browsercache (Ctrl+Shift+R)

Klikken op de knop doet niets

1. Open de browserconsole (F12) en controleer of er geen JavaScript-fout is
2. Controleer of geen andere module de JavaScript van deze module blokkeert
3. Controleer of dfwhatsapp.js wel degelijk in de HTML wordt geladen

De statistieken lopen niet op

1. Controleer of de tracking geactiveerd is onder Algemeen
2. Controleer of geen adblocker aan de clientzijde de URL module/dfwhatsapp/track filtert
3. Raadpleeg de tabel ps_dfwhatsapp_click om te zien of de events binnenkomen

SQL-fout “LIMIT 1 LIMIT 1”

Opgelost in versie 1.0.1. Werk uw module bij naar de laatste versie vanuit uw DataFirefly-klantenaccount.

Support en updates

• Support per e-mail: hello@datafirefly.com
• Updates 12 maanden inbegrepen via uw klantenaccount
• Compatibiliteit van PS 8 naar 9 gegarandeerd zonder meerkosten

Changelog

1.0.0, 13 mei 2026, lancering

• Eerste publieke versie
• Meerdere agenten met vier verdeelmodi
• Weekplanning per agent met uitzonderingen
• Welkomstpop-up, QR-code op desktop en terugbelformulier
• Ingebouwde AVG-toestemming en analytics met gehashte IP
• Vier talen: FR, EN, ES, DE
• Compatibel met PrestaShop 8.0+ en 9.0+