Uw overstap van de oude Shopware 6-plug-in naar de nieuwe

Met de nieuwe versie van onze Shopware 6-plugin bieden we je nog betere prestaties en verbeterde functies. Het migratieproces is gedeeltelijk geautomatiseerd via een modaal venster en duurt maar een paar minuten.
In deze handleiding leggen we je stap voor stap uit hoe je kunt overstappen van je huidige integratie naar de nieuwe plug-in.

• De belangrijkste verschillen op een rijtje
• Vereisten & voorbereiding
• Installatie:
  • Stap 1: Nieuwe plug-in installeren
  • Stap 2: Open het migratievenster en start de gegevensoverdracht
  • Stap 3: Invoerinstellingen vastleggen
  • Stap 4: Afronden & functietest
• Wat blijft hetzelfde, wat verandert er?
• Rechten- en rolmodel
• Bekende problemen (bekende beperkingen)
• Veelgestelde vragen

Belangrijke opmerking: 
De oude verbinding wordt automatisch verbroken zodra je klikt in het migratievenster automatische overdracht naar Instellingen toepassen . Als je kiest voor handmatige configuratie Handmatig instellen , zal er geen automatische deactivering plaatsvinden.

De belangrijkste verschillen in één oogopslag

Vereisten & Voorbereiding

Om ervoor te zorgen dat de migratie en de daaropvolgende synchronisatie soepel verlopen, moet je van tevoren zorgen dat de volgende punten in orde zijn:

Stap 1: Installeer de nieuwe plug-in

1. Extensies > Winkel.
2. Zoek naar de nieuwe CleverReach-plugin en klik op Extensie installeren.
   
   

Stap 2: Open het migratievenster en start de gegevensoverdracht

1. Klik op het menu-item Mijn extensies. Hier staan nu zowel de oude als de nieuwe CleverReach-plugins vermeld. Activeer de nieuwe plugin met de schuifbalk. 
   
   
2. Klik in het menu op Marketing en selecteer de nieuwe CleverReach-plug-in.

3. Zodra je de nieuwe plug-in voor het eerst opent, detecteert het systeem automatisch de bestaande verbinding. Er verschijnt een venster (modaal) met twee opties:
   
   

   Automatisch importeren (aanbevolen): De plug-in importeert de reeds gekoppelde ontvangerslijst rechtstreeks vanuit de oude plug-in.

   Belangrijke technische opmerking: Bovendien wordt tijdens deze stap de verbinding tussen de oude plug-in en CleverReach automatisch verbroken, en wordt de plug-in automatisch gedeactiveerd in de Shopware-extensies. Dit is een beveiligingsmechanisme dat bedoeld is om:

   • In de volgende stap kun je onze nieuwe app koppelen aan je CleverReach- account.

   Handmatig koppelen: Kies deze optie als je verbinding wilt maken met een ander CleverReach-account . Let op: De oude app wordt niet gedeactiveerd. Houd er rekening mee dat dit kan leiden tot inconsistente gegevens.

4. Kies in de volgende stap welke ontvangerslijsten je wilt importeren en klik op Volgende.
   
   

Stap 3: Importeinstellingen configureren

In deze stap heb je een breed scala aan importinstellingen. 

• Welke klantgroepen je wilt importeren (nieuwsbriefabonnees, klanten die iets hebben gekocht, andere contacten)
• Of je de bestelgeschiedenis wilt overzetten (standaard: de afgelopen 12 maanden, aanpasbaar tot maximaal 24 maanden)
• Of gegevensvelden toegewezen moeten worden. 

Klik ten slotte op Importeren starten.

Let op: Het importeren gebeurt op de achtergrond. Je kunt van tabblad wisselen of gewoon doorwerken in andere menu’s. Houd het browsertabblad wel open totdat het proces is voltooid.

Stap 4: Voltooiing & functionaliteitscontrole

Zodra de migratie is voltooid, krijg je een bevestiging in het modaalvenster. Je nieuwe dashboard is klaar en je kunt weer volledig gebruikmaken van je integratie met CleverReach. 

Let op: De oude plug-in is automatisch gedeactiveerd. Je kunt nu gerust de oude versie van de plug-in uit je Shopware-backend verwijderen.

Wat blijft hetzelfde, wat verandert er?

Gebruik van tags
Het tagformaat komt precies overeen met de vorige interface. Je bestaande segmenten en automatiseringen blijven daarom naadloos werken en hoeven niet aangepast te worden.

Formulieren gebruiken
De nieuwe integratie maakt gebruik van onze huidige formuliermodule. Oude formulieren worden niet langer ondersteund. Maak het gewenste formulier rechtstreeks in CleverReach aan, zodat je het vervolgens via de interface kunt integreren.

Segmenten aanmaken
Het is momenteel niet de bedoeling om rechtstreeks via de integratie nieuwe segmenten aan te maken. Je kunt je bestaande segmenten echter zonder beperkingen blijven gebruiken: Aangezien het tagformaat ongewijzigd blijft, werken alle segmentaties en het filteren op gegevensvelden zoals gewoonlijk.

Automatiseringen gebruiken
Heb je al tag-gebaseerde automatiseringen ingesteld? Deze blijven gewoon draaien zonder enige handmatige tussenkomst. We raden je alleen aan om even te controleren of alle triggers werken zoals de bedoeling is.

Rechten- en rollenmodel

Met het machtigingenbeheer van Shopware kun je verschillende rollen toewijzen voor toegang tot de CleverReach-plugin:

• Probleem/Onderwerp	Oorzaak/Oplossing
  De CleverReach-import loopt vast wanneer wachtwoordbeveiliging (.htaccess) is ingeschakeld	Oorzaak: In omgevingen met wachtwoordbeveiliging (Basic Auth / Staging) loopt de import vast in een eindeloze lus (Infinite Spinner), omdat achtergrondprocessen worden geblokkeerd (401 fout). Oplossing: Schakel de wachtwoordbeveiliging voor het importeren tijdelijk uit, of schakel de volgende API-routes in je serverconfiguratie in : /api/crsw-on-prem-CleverReach/webhook/receiver   /api/crsw-on-prem-CleverReach/webhook/abandonedCart
  De synchronisatie start niet	Controleer: 1. Draaien de message queue workers of admin workers? 2. Is de CleverReach-authenticatie geldig? 3. Staan er fouten in de logbestanden van de plug-in?
  Synchronisatie wordt afgebroken voordat deze is voltooid	Controleer: 1. De berichtenwachtrij. 2. De logbestanden van de plug-in. 3. Of de OAuth-verbinding nog klopt.
  Problemen met grote synchronisaties (50.000 records of meer)	Oorzaak: De standaardwaarde voor de time-out van de query is 3600 seconden (1 uur). Als het proces langer duurt, zal een worker het bericht opnieuw ophalen. Oplossing: Stel de time-out voor het DSN-transport in redeliver_timeout op een hogere waarde (aanbevolen: 8 uur): MESSENGER_TRANSPORT_DSN=doctrine://default?auto_setup=0&redeliver_timeout=28800
  E-mails over achtergelaten winkelwagentjes worden niet verzonden.	Controleer het volgende: 1. Is de CleverReach-automatisering voor “Achtergelaten winkelwagentjes” ingeschakeld? 2. Draaien de workers voor geplande taken (Geplande taken) wel? 3. Zie je in de logbestanden fouten met webhooks of automatisering?
  E-mails over verlaten winkelwagentjes worden met een kleine vertraging verstuurd	Uitleg: De plug-in voert elke 15 minuten een geplande controle uit (Geplande run) om te controleren of er nieuwe verlaten winkelwagentjes zijn. Afhankelijk van het tijdsinterval kan het versturen daarom iets vertraging oplopen.
  De gekoppelde groep mag niet worden verwijderd in CleverReach	Uitleg: De “Offline-modus” voor het automatisch detecteren van verwijderde groepen is nog niet geïntegreerd. Oplossing: Verwijder de gekoppelde ontvangerslijst niet handmatig in CleverReach.
  Oude formulieren werken niet meer na het wisselen van plug-in	Oplossing: Als je overstapt naar de nieuwe plug-in, moeten formulieren die eerder in de Shopware Experience Worlds waren geïntegreerd, handmatig worden vervangen door de nieuwe formulieren.
  Bidirectionele synchronisatie van CleverReach Flow-formulieren naar Shopware	Oplossing: Om synchronisatie in beide richtingen te garanderen, moet het Flow Form in CleverReach worden geconfigureerd met dezelfde ontvangerslijst als de plug-in.

• Vraag	Antwoord
  Kan ik gewoon van de oude interface naar de nieuwe overschakelen zonder gegevens te verliezen?	Ja. De migratie verloopt gedeeltelijk automatisch via een modaalvenster en duurt maar een paar minuten. Je bestaande ontvangerslijst wordt automatisch overgezet. Tijdens dit proces wordt ook de oude CleverReach-plugin automatisch gedeactiveerd. Nadat je de ontvangerslijst hebt geselecteerd, kun je extra gegevens voor de import individueel instellen.
  Moet ik de oude plug-in eerst verwijderen?	Nee. Laat de oude plug-in voorlopig actief staan. Zodra de eerste stap (migratievenster) in de nieuwe plug-in succesvol is voltooid, wordt de oude verbinding automatisch verbroken en de oude plug-in gedeactiveerd. Zodra je de import in de nieuwe interface hebt voltooid, kun je de oude plug-in verwijderen.
  Welke Shopware-versie heb ik nodig voor de nieuwe plug-in?	De plug-in ondersteunt Shopware 6.6 en 6.7, evenals PHP 8.2 of hoger.
  Welke gegevens worden tijdens de migratie overgedragen?	Met het migratievenster in de nieuwe plug-in kun je kiezen of we de gegevens automatisch moeten laden of handmatig moeten configureren. Als je ‘Automatisch’ selecteert, lezen we de bestaande, gekoppelde CleverReach-ontvangerslijst in en importeren we deze in de nieuwe plug-in. Je kunt deze instelling later nog steeds wijzigen. Daarnaast kun je in de volgende configuratiestappen andere nieuwe importopties (bestelgegevens, tags, gegevensvelden) afzonderlijk selecteren.
  Moet ik mijn aanmeldformulieren voor de nieuwsbrief opnieuw insluiten?	Ja. De nieuwe interface maakt gebruik van onze nieuwe formuliermodule. Oude formulieren in je experience worlds werken niet meer met de nieuwe interface en moeten worden vervangen door nieuwe formulieren.
  Wat gebeurt er met de double opt-in-bevestiging als ik CleverReach gebruik?	Als je de double opt-in-functie van CleverReach inschakelt, stuurt CleverReach de bevestigingsmail en wordt de standaard Shopware DOI-mail onderdrukt. Het hele bevestigingsproces loopt dan via je CleverReach-formulier.
  Blijven mijn bestaande segmenten en automatiseringen werken?	Ja. Het tagformaat blijft identiek aan de oude interface, dus bestaande segmenten en op tags gebaseerde automatiseringen blijven zonder handmatige tussenkomst werken. Het is aan te raden om na de migratie even te controleren of alles goed werkt.
  Kunnen meerdere medewerkers met verschillende rechten toegang krijgen tot de integratie?	Ja. Met het rechtenbeheer van Shopware kun je verschillende rollen toewijzen: van alleen-lezen-toegang (alleen het dashboard/de logboeken bekijken) tot bewerkingsrechten (instellingen wijzigen, synchronisatie/import starten) tot volledige beheerderstoegang.
  De e-mail over het achtergelaten winkelmandje komt niet precies op het ingestelde tijdstip aan. Is dit normaal?	Ja, de plug-in controleert elke 15 minuten op nieuwe achtergelaten winkelmandjes, dus de verzending kan tot deze tijd vertraging oplopen.
  Mijn winkel is met een wachtwoord beveiligd (bijv. een testomgeving) — het importeren loopt vast. Wat moet ik doen?	In met een wachtwoord beveiligde omgevingen (Basic Auth) blokkeert de wachtwoordbeveiliging de achtergrondprocessen van de import (401-fout), waardoor deze eindeloos blijft laden. Sta de volgende twee API-routes toe in je .htaccess-configuratie (whitelisting), of schakel de wachtwoordbeveiliging tijdelijk uit voor de import: /api/crsw-on-prem-CleverReach/webhook/receiver /api/crsw-on-prem-CleverReach/webhook/abandonedCart

Help & Ondersteuning

Als je vragen hebt of hulp nodig hebt, neem dan gerust contact op met ons serviceteam.