Magento integration

Magento is a leading e-commerce platform that helps businesses manage products, customers, and orders at scale. By integrating Magento with Pushwoosh, you can automatically sync customers, orders, and abandoned carts to enable real-time messaging, targeted segmentation, and cross-channel marketing automation, helping you engage users and increase conversions directly from your store activity.

Destination: This integration pushes data from your Magento store to Pushwoosh.

Before proceeding, ensure the following:

• Access to the Magento Admin Panel

• A valid Pushwoosh account

• Your Pushwoosh API access token and App code

• Composer installed on your Magento server

• System requirements met:

  • PHP 7.4 / 8.x
  • Magento 2.3 / 2.4
  • Elasticsearch 7
  • RabbitMQ

Mapping entity names if they are different:

• Customers
• Orders
• Abandoned сarts

• Send push notifications based on order creation and cart abandonment events.

• Segment customers based on attributes (e.g., location, birthday) and send targeted campaigns.

• Send browser-based promotional notifications.

1. Run the following Composer command in the root of your Magento project:

composer require pushwoosh/magento2-integration

2. Once the package is installed, run Magento setup to install the module:

bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:clean

After completing installation:

1. Log into the Magento Admin panel.

2. Navigate to Stores > Configuration > Pushwoosh > Configuration .

In the General section, configure the following fields:

• Status: Set this to Enable to activate the integration.
• API URL: Enter the Pushwoosh API endpoint: https://api.pushwoosh.com/
• API Key: Paste your Pushwoosh API Key required to authenticate requests. Learn more about Pushwoosh API access key
• App Code: Enter the Pushwoosh App Code corresponding to your mobile or web application.

Below are the configuration options available for syncing customers, orders, and abandoned carts.

Define how order data is synchronized between your Magento store and Pushwoosh.

Fill in the following fields:

Here you can also see order synchronization status:

• Total Orders: Displays the total number of orders evaluated for synchronization.
• Synced Orders: Number of orders successfully synchronized with Pushwoosh.
• Not Synced Orders: Orders that have not yet been synchronized.
• Fail Synced Orders: Orders for which synchronization attempts have failed.

Configure synchronization of abandoned shopping cart data between your Magento store and Pushwoosh.

Fill in the following fields:

Here you can also see real-time metrics on synchronization activity:

• Total Abandoned Carts: Total number of carts identified as abandoned.
• Synced Abandoned Carts: Number of carts successfully synchronized with Pushwoosh.
• Not Synced Abandoned Carts: Number of carts that have not yet been synchronized.
• Fail Synced Abandoned Carts: Number of carts for which synchronization has failed.

Configure the synchronization of customer data from your Magento store to Pushwoosh to enable audience segmentation and personalized messaging based on customer attributes.

Fill in the following fields:

Here you can also see synchronization statistics:

• Total Customer: Total number of customer records identified for syncing.
• Synced Customer: Number of customers successfully synchronized with Pushwoosh.
• Not Synced Customer: Customers pending synchronization.
• Fail Synced Customer: Customers that failed to sync due to errors.

Set to Yes to enable web push notifications for your store visitors. Set to No to disable this functionality.

When enabled, your Magento store can send real-time messages to users via their browser. Notifications can be used for promotional offers, order status updates, abandoned cart reminders, and other marketing communications.

Once all required fields are completed, click the Save Config button located in the top right corner. Clear Magento cache if prompted to apply the changes.

If you prefer not to synchronize all customers automatically, you can manually sync individual or selected customers.

1. In the Magento Admin Panel, navigate to Customers > All Customers.
2. Locate and select the customer(s) you wish to sync.
3. From the Actions dropdown above the customer list, choose Sync to Pushwoosh.

Once synchronization is complete, the customer data will appear in the User Explorer section of your Pushwoosh account, with all relevant information transferred from Magento.

If you prefer not to synchronize all orders automatically, you can manually sync specific orders. For this:

1. In the Magento Admin Panel, navigate to Sales > Orders.

2. Select one or more orders from the list.

3. From the Actions dropdown, choose Sync to Pushwoosh.

After synchronization, the order will appear in the Events section of the user profile in Pushwoosh User Explorer as a PW_OrderCreated or PW_OrderUpdated event (if the order status has changed), including detailed order information.

To manually sync selected abandoned carts:

1. In the Magento Admin Panel, go to the Abandoned Carts section.
2. Select the cart you want to sync.
3. From the Actions dropdown, choose Sync to Pushwoosh.

Note: Make sure you have configured the required inactivity period in the Abandoned Cart Sync settings to determine when a cart is considered abandoned.

After synchronization, the abandoned cart data will appear in the Events section of the user profile in Pushwoosh User Explorer as a PW_AbandonedCart event with detailed information.

In addition, two tags will be set on the user profile:

• Abandoned Cart Date → PW_AbandonedCartDate
• Abandoned Cart ID → PW_AbandonedCartID

These tags can be used to send abandoned cart reminders using connected content in your email templates. Learn more

To confirm that the integration is working correctly:

1. Create a test customer in Magento.
2. Manually sync the customer to Pushwoosh.
3. Open User Explorer in your Pushwoosh dashboard and find the customer.

If the customer appears in User Explorer, it indicates that the synchronization was successful.