Om je Magento 2 webshop te koppelen met MailBlue is er een plugin beschikbaar voor Magento. Via deze koppeling komen bestellingen vanuit jouw Magento webshop binnen in MailBlue, en kun je dit automatisch opvolgen. Ook verlaten winkelwagen-mails kunnen middels de plugin vanuit MailBlue worden verzonden.
In deze handleiding leggen we je uit hoe je deze plugin installeert en inricht. Voor het installeren heb je toegang nodig tot de CLI / SSH / Terminal van de server waar Magento op staat geïnstalleerd.
LET OP: Dit is een technische handleiding, laat dit uitvoeren door je website ontwikkelaar.
Systeem vereisten
- PHP 7.4/8
- Magento 2.3/2.4
- Elastic Search 7
Downloaden plugin
- De plugin is te vinden op: https://github.com/ActiveCampaign/module-integration/releases
- Download de release
- De gedownloade inhoud dient geplaatst te worden in de map: /app/code/ActiveCampaign
- Bestaat deze map nog niet, maak deze dan aan.
Installatie plugin
De plugin bestaat uit verschillende modules. Voer onderstaand commando uit om alle modules te installeren en te activeren.
php bin/magento module:enable ActiveCampaign_Core ActiveCampaign_Customer ActiveCampaign_AbandonedCart ActiveCampaign_Order ActiveCampaign_SyncLog
Nadat de modules zijn geactiveerd dien je Magento opnieuw te compileren en te deployen. Dit doe je middels de volgende commando's:
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
Configuratie plugin
Om de plugin te configureren heb je de API gegevens nodig van je MailBlue account. Voor meer informatie over waar je deze gegevens terug kunt vinden, klik hier. Deze gegevens heb je nodig bij de volgende stappen:
- Ga in je Magento installatie naar Stores -> Configuration
- Klik in het linker menu op ActiveCampaign -> Configuration
- Pas de volgende gegevens aan:
- Status: Enabled
- API URL: [url uit je MailBlue account (xxx.api-us1.com of xxx.activehosted.com]
- API Key: [api key uit je MailBlue account]
- Klik op 'Connect'
- Krijg je hier een foutmelding, controleer dan de gegevens.
- Is alles goed gegaan dan krijg je nu een melding om de Magento cache te vernieuwen, klik op de link en reset de caches die ongeldig zijn.
Synchronisatie bestellingen, klanten, verlaten winkelwagen
Onder de instellingen voor de API gegevens kun je aanpassen hoe je wenst dat gegevens doorgezet worden naar MailBlue.
Order sync configuration
Hier kun je aangeven hoe orders naar MailBlue doorgestuurd gaan worden. Mocht je een drukke store hebben dan is het aan te raden om de cronjob vaker te laten lopen. Standaard staat deze ingesteld op elke vijfde minuut van het uur.
Ook kun je hier aangeven of orders direct na het plaatsen doorgestuurd moeten worden. Heb je dit aan staan, dan geldt de cronjob niet.
Abandoned Cart
Met verlaten winkelwagens kun je een opvolging maken binnen MailBlue waarmee je de klant nog over kan halen om de bestelling nog af te ronden. Deze worden binnen Magento opgeslagen en doorgestuurd naar MailBlue. Standaard gebeurt dit elk uur, op het hele uur. Is je webshop drukker, dan is het aan te raden om deze instelling aan te passen om het vaker te laten draaien.
Binnen Magneto kunnen ook oude verlaten winkelwagentjes opgeslagen staan. Er is een mogelijkheid om deze te synchroniseren. Let hier wel mee op, het kan namelijk zo zijn dat deze data niet 100% accuraat is gezien het historische data betreft.
Customer
Klanten synchroniseren is een basis die altijd aan moet staan, zonder klanten synchroniseren kunnen bestellingen ook niet worden doorgezet. Je kunt hier aanpassen hoe vaak klanten gesynchroniseerd mogen worden. Standaard staat dit ingesteld op één keer per uur, op de tiende minuut van het uur. Voor drukkere webshops raden we aan om dit vaker te laten lopen.
Sync Log Settings
Ervaar je problemen met de synchronisatie van gegevens? In dat geval raden we je aan de 'Sync log' aan te zetten. Let op: doe dit wel altijd in Debug mode. Dit zorgt ervoor dat je gedetailleerde logging krijgt over de acties die uitgevoerd worden. De log wordt opgeslagen op /var/log/activecampaign.log. Heb je "SyncLog Delete" aan staan dan wordt de log na 7 dagen automatisch geleegd. Dit zorgt ervoor dat er niet onnodig veel logging bewaard blijft.
Historische orders sync
De plugin beschikt niet over een mogelijkheid om in bulk reeds geplaatste bestellingen te synchroniseren. De enige mogelijkheid om deze bestellingen wel in je MailBlue account te krijgen is om dit te doen door naar Orders te gaan, de gewenste orders te selecteren bij Actions te kiezen voor 'Send to ActiveCampaign'