SW Shopware 6 Shopware Gemiddeld

WhatsApp Commerce Suite Shopware: installatie- en configuratiegids

De plugin installeren, de Meta Cloud API verbinden, de webhook, de HSM-templates en de 4 modules configureren op Shopware 6.5, 6.6 en 6.7.

Bijgewerkt Moduleversie 1.0.0

Vereisten

  • Shopware 6.5, 6.6 of 6.7 (één codebase), PHP 8.1 minimaal
  • Een WhatsApp Business-account met een geverifieerd nummer in Meta Business Suite
  • Een Meta-app van het type Business met het product WhatsApp geactiveerd
  • De wachtrijworker en de runner voor geplande taken van Shopware actief (messenger:consume en scheduled-task:run)

Installatie

  1. Kopieer de map DfWhatsAppCommerce naar custom/plugins/ (of upload de zip via Extensies → Mijn extensies).
  2. Installeer en activeer: 
    bin/console plugin:refresh
bin/console plugin:install --activate DfWhatsAppCommerce
bin/console cache:clear
  3. Compileer de administration en de storefront: 
    bin/build-administration.sh
bin/build-storefront.sh
De installatie maakt 5 eigen tabellen met het voorvoegsel df_wac_ aan en 2 geplande taken (winkelwagenherinnering elke 15 min, catalogusbatch elk uur). Alles wordt bij het verwijderen netjes gewist, tenzij u “gegevens behouden” aanvinkt.

Configuratie van de Meta Cloud API

1. De inloggegevens ophalen

Maak op developers.facebook.com een Business-app aan en voeg het product WhatsApp toe. Haal op: het permanente token (systeemgebruiker met de rechten whatsapp_business_messaging en catalog_management), het Phone number ID, het WABA ID en de App secret (App-instellingen → Algemeen).

2. De catalogus aanmaken

Maak in Meta Commerce Manager een catalogus aan en verbind die met uw WhatsApp Business-account. Noteer het catalogus-ID.

3. De webhook instellen

In de Meta-app → WhatsApp → Configuratie:

  • Callback-URL: https://uwshop.tld/df-wac/webhook
  • Verificatietoken: de waarde die u in de configuratie van de plugin invoert (veld “Webhook verify token”)
  • Abonneer u op het veld messages
Vul de App secret in de configuratie van de plugin in: zonder die waarde wordt de handtekening X-Hub-Signature-256 van de webhooks niet gevalideerd.

4. De configuratie in Shopware invoeren

Instellingen → Systeem → Plugins → DataFirefly WhatsApp Commerce Suite. Vul de kaart “Meta Cloud API” in en test daarna vanuit het dashboard (Marketing → WhatsApp Commerce): knop API-verbinding testen en het versturen van een testbericht.

De 4 modules

Meta-catalogus

Drie modi: realtime (bij elke opslag van een product), batch per uur, of handmatig. Varianten worden afzonderlijk verstuurd met de retailer_id sw_{artikelnummer}. Sluit zo nodig categorieën uit. De volledige hersynchronisatie (batches van 100) start u vanuit het dashboard.

Conversationeel bestellen

Statusmachine met 6 niveaus. Herkende trefwoorden (FR/EN/DE): menu, panier, payer, humain, reset, aide. De taal van de klant wordt automatisch herkend. De overdracht naar een medewerker stuurt een e-mail naar het ingestelde adres met de link naar het gesprek.

Herinnering voor verlaten winkelwagens

3 instelbare herinneringen (standaard 60 min, 24 u, 72 u), verstuurd door de geplande taak die elke 15 minuten draait, naar klanten van wie het telefoonnummer op het factuuradres bekend is. De kortingscode uit de configuratie wordt bij de derde herinnering meegestuurd en automatisch op de herstelde winkelwagen toegepast.

Maak het telefoonveld verplicht via Instellingen → Shop → Inloggen en registreren om het bereik van de herinneringen te maximaliseren.

De links voor de checkout en het herstellen van de winkelwagen worden ondertekend met HMAC SHA-256 en hebben een instelbare vervaltijd (standaard 72 u). Automatische meldingen: bestelbevestiging, verzending (met trackingnummer) en mislukte betaling.

HSM-templates die u in Meta Business Suite moet aanmaken

Template Variabelen in de tekst Knop
Herinnering 1 en 2 {{1}} klantnaam, {{2}} winkelwagentotaal Dynamische URL (achtervoegsel = token)
Herinnering 3 {{1}} naam, {{2}} totaal, {{3}} kortingscode Dynamische URL (achtervoegsel = token)
Bevestiging {{1}} naam, {{2}} bestelnummer, {{3}} totaal —
Verzending {{1}} naam, {{2}} bestelnummer, {{3}} trackingnummer CTA tracking (optioneel)
Mislukte betaling {{1}} naam, {{2}} bestelnummer CTA herinnering (optioneel)

Voor de herinneringen moet de URL-knop van het template als basis https://uwshop.tld/df-wac/cart/restore?token= hebben met het dynamische achtervoegsel {{1}}. Vul de namen van de goedgekeurde templates in de configuratie van de plugin in.

Administration

Marketing → WhatsApp Commerce: KPI-dashboard (gesprekken, ongelezen, winkelwagens, herstelpercentage, fouten), pagina Gesprekken (draad in de stijl van WhatsApp Web, rechtstreeks antwoorden), Verlaten winkelwagens, Catalogus (synchronisatielogboek) en Logboeken (filters op niveau en kanaal).

Regel van Meta: vrije antwoorden vanuit de admin worden alleen afgeleverd binnen 24 uur na het laatste bericht van de klant. Daarna gebruikt u een HSM-template.

Probleemoplossing

  • Er verschijnt niets aan de voorkant: controleer of het “Publieke WhatsApp-nummer” is ingevuld (de zwevende knop en de CTA’s hangen ervan af) en voer daarna bin/console cache:clear uit.
  • Webhook 403: het verificatietoken verschilt tussen Meta en de plugin, of de App secret klopt niet.
  • Herinneringen worden niet verstuurd: controleer of scheduled-task:run en messenger:consume draaien, of de module actief is en of de HSM-templates zijn goedgekeurd.
  • Producten niet gesynchroniseerd: raadpleeg de pagina Catalogus (statussen pending/synced/error) en de Logboeken, kanaal catalog.

AVG

Er worden geen gegevens naar derden gestuurd buiten de Meta WhatsApp Cloud API. Gesprekken en nummers worden lokaal opgeslagen in de tabellen df_wac_ en bij het verwijderen gewist.

Was deze pagina nuttig?

Loopt u nog vast? Neem contact op met support