← All integrations

Magento

Magento 2 Integration

waveConnect links your Magento 2 store to waveMail and automatically adds customers to your lists based on store activity — registrations, orders, newsletter signups, and more.

What You'll Need

• Magento 2 (Open Source or Adobe Commerce) running PHP 8.0 or later.
• SSH / command-line access to your Magento server.
• An active waveMail account at app.wavemail.com.au.
• Magento administrator access.

Step 1 — Install the Module

Download the module package from the connector's download button in your waveMail Integrations area, then install it one of two ways.

Option A — Manual (app/code):

1. Unzip the package and upload the WaveConnect folder to app/code/Techwave/WaveConnect in your Magento installation.
2. From your Magento root, run:
   • bin/magento module:enable Techwave_WaveConnect
   • bin/magento setup:upgrade
   • bin/magento setup:di:compile
   • bin/magento cache:flush

Option B — Composer (if provided as a Composer package):

1. Require the package: composer require techwave/module-waveconnect
2. Then run bin/magento setup:upgrade, setup:di:compile, and cache:flush as above.

After this, a waveConnect menu appears in your Magento admin sidebar.

Step 2 — Connect Your waveMail Account

1. In the Magento admin, go to waveConnect → Setup Account.
2. Click Connect to waveMail. A secure waveMail authorisation window opens.
3. Log in and approve. The window closes and the module is authorised automatically — no API keys to copy. (A manual API key option is available as a fallback.)
4. The account then shows a Connected status.

Step 3 — Create an Integration

1. Go to waveConnect → Integrations and click Add New.
2. Choose a trigger:
   • Customer registration — a new customer account is created.
   • Customer saved / updated — a customer profile changes.
   • Order placed and order status change (e.g. processing, complete).
   • Newsletter subscription.
   • Contact form submission.
3. Select the waveMail list the contact should join.
4. Map the fields — match Magento data (name, email, billing details, etc.) to your list fields.
5. Add conditional logic (optional) so the integration only runs when your conditions are met.
6. Click Save. The integration is now live.

Step 4 — Sync Existing Customers (Optional)

Go to waveConnect → Sync Customers, choose the list, and start the sync. It runs in the background, and you can retry any failed records.

Step 5 — Test & Monitor

1. Trigger a configured event (for example, register a test customer or place a test order).
2. Check the linked waveMail list to confirm the contact appears.
3. Open waveConnect → Debug to review the API log and resend any failed requests.