Set up Shopify

Integration overview

Pushwoosh integrates seamlessly with Shopify, a leading e-commerce platform that enables businesses to create, manage, and scale online stores. This guide walks you through installing and configuring the Pushwoosh app in your Shopify store, setting up user identification, and using notifications and automation tools to engage customers across channels like push, email, SMS, and WhatsApp.

Integration type

• Destination: Shopify sends customer data to Pushwoosh, where it is used for targeting and messaging.

Prerequisites

• A Pushwoosh account
• Access to your Shopify admin panel
• Pushwoosh Device API Access Token and Application Code
• A Shopify store with customers and order data available
• Approval of the read_orders access scope for order/cart events, and write_pixels plus read_customer_events for checkout step tracking

Already connected? You'll be asked to re-approve access

If you connected the Pushwoosh app before order, cart, and checkout tracking existed, Shopify asks you to approve the new scopes the next time you open the app — this is the expected way Shopify rolls out added permissions, not an error. Approve them to start receiving order, cart, and checkout events.

Synchronized entities

• Customers: Used to assign and identify Pushwoosh User IDs via Shopify metafields

ملاحظة

Customer synchronization approaches in Pushwoosh

Due to technical limitations, Pushwoosh offers several customer synchronization methods, depending on the communication channel used for notifications:

• Email, Web, SMS & WhatsApp: Devices/users are automatically registered in the Pushwoosh application.
• Mobile & Desktop Apps: Devices/users can be synchronized manually via the Pushwoosh and Shopify admin panels.
• Web Platforms (Chrome, Firefox, Safari): Devices/users are managed by the Shopify theme embed itself.

How does it work?

The synchronization process operates as follows:

1. The system attempts to retrieve the current user session to obtain an email or phone number (identifiers that function without additional configuration).
2. If successful, the email or phone number is set as the userID identifier for both Pushwoosh and the pushwoosh_userid property in the customer data.
3. If this is not possible, the default Pushwoosh SDK userID is assigned as the identifier for both Pushwoosh and the pushwoosh_userid property.
4. In any case, a userID will be assigned on both sides, ensuring consistent synchronization.

• Customer segments: Used for group-based targeting and messaging
• Events and triggers (e.g., orders placed, tags applied): Used in Shopify Flow to automate messaging across channels
• Storefront: Used for capturing web push opt-ins through embedded scripts
• Product feed: Your store’s storefront feed (products.json) connects automatically to the Pushwoosh Product Catalog when you connect the app, and disconnects automatically if you uninstall it.
• Orders and carts: Server-to-server events from Shopify’s orders/paid, checkouts/create, and checkouts/update webhooks. See Shopify events and campaigns.
• Storefront browsing behavior: Product views and add-to-cart actions, collected by the same theme embed used for web push opt-ins.
• Checkout steps: Contact info entered and payment info submitted, collected via a Shopify Web Pixel.

Glossary (mapping entity names if they are different)

Shopify	Pushwoosh
Customer	User ID
orders/paid webhook	Event PW_OrderCreated — shared with other e-commerce integrations (e.g. Magento)
checkouts/create webhook	Event PW_AbandonedCart — same shared event, also used by the Products block’s Cart source
checkouts/update webhook	Event PW_AbandonedCartUpdate — fires as the shopper keeps editing the same checkout, overwriting the stored cart from PW_AbandonedCart
Product page view	Event PW_ProductViewed
Add to cart (no page reload)	Event PW_AddToCart
Web Pixel checkout_contact_info_submitted	Event PW_CheckoutContactInfo
Web Pixel payment_info_submitted	Event PW_PaymentInfoSubmitted

How the integration works

Pushwoosh acts as a messaging destination for Shopify. Once integrated, Shopify sends customer and behavioral data to Pushwoosh, where it powers real-time notifications, customer segmentation, and personalized messaging across channels.

Key components of the integration

1. Customer identification via metafields Each Shopify customer is assigned a unique User ID, stored in a metafield (custom.pushwoosh_userid). This ID allows Pushwoosh to recognize and message users consistently across platforms.

2. Event-driven automation via Shopify Flow Pushwoosh provides Flow actions that allow you to automate messaging (push, email, SMS, WhatsApp) based on Shopify events, such as:

   • New order placed
   • Tag applied to customer
   • Cart abandonment

3. Segment-based targeting Customer segments from Shopify can be used to send group-specific notifications across channels, such as promotions for first-time buyers or reactivation campaigns for dormant users.

4. Manual and real-time messaging From the Shopify customer or segment view, you can manually trigger notifications using the Pushwoosh Extensions:

   • Notification by Customer: For personal follow-ups or testing
   • Notification by Segment: For campaign-based messages

Web push notifications via storefront embed

By enabling the Pushwoosh embed in your Shopify theme, you can prompt website visitors to opt in to browser-based push notifications—no mobile app required.

Data flow overview

Shopify Customer & Event Data
         ↓
Pushwoosh API (via App)
         ↓
User ID → Segmentation → Triggered or Manual Notifications

This integration empowers you to deliver timely, relevant messages that improve user retention, boost conversions, and enhance the customer experience—automatically or on demand.

Part 1. Installation

Log into Shopify

1. Go to Shopify Admin
2. Select your store from the dashboard

ملاحظة

This guide assumes that you already have a Pushwoosh account. If not, create one

Install the Pushwoosh app

1. Visit the Pushwoosh App Store page
2. Click Install
3. Confirm installation in the Shopify dialog

Connect your Pushwoosh app

After installation, you will be redirected to the Pushwoosh app inside Shopify.

1. Click Connect.

2. Enter the Application Code and API Key, which you can find in the Pushwoosh Control Panel → Settings → API Access. The API Key here is your Device API Access Token.

When connected, a success message will appear: “Pushwoosh app connected.”

When Shopify asks for permissions (orders, pixels, customer events), approve them. Those scopes are required for Shopify events and campaigns tracking. If you connected the app earlier, see Already connected? You’ll be asked to re-approve access.

Automatic product catalog connection

Connecting the app also connects your store’s storefront feed to the Pushwoosh Product Catalog automatically. No separate feed setup needed. Your store’s currency is captured at the same time, and updates automatically if you change your store’s currency afterward.

Subscribe to a plan

1. Click Upgrade Subscription
2. A single usage-based plan will be shown.
3. Confirm the billing.

ملاحظة

Billing is required to use message delivery and segmentation features.

Part 2. Setup: Customer User ID via metafields

To deliver notifications to identified users across channels (push, email, SMS, WhatsApp), Pushwoosh uses a unique User ID per customer. Shopify stores this value inside Shopify’s Customer metafields.

1. Go to Settings → Metafields and metaobjects → Customers

2. Click Add definition and use these values:

Field	Value
Namespace and key	custom.pushwoosh_userid
Namespace	custom
Type	Single line text
Validation	None
Customer Account Access	Read and Write
Storefront API Access	Enabled

Set Customer accounts access and Storefront API access as in the table above.

Why this matters

This metafield is a persistent user identifier across mobile/web devices for notifications and segmentation.

Part 3. Using Pushwoosh extensions

Pushwoosh includes Shopify Extensions for segment targeting, automation (Flow), and customer-specific notifications.

Extension 1. Send notification by customer

Use case

Manually send personalized messages or test notifications to a specific user.

Steps

1. Open Customers → Select a customer
2. Click More actions → Notification by customer
   
3. Select the messaging platform (e.g., Email) and a content preset.
4. Click Send

نصيحة

Use this for post-purchase reminders, personal thank-yous, or reactivation prompts.

Extension 2. Notification by segment

Use case

Target groups of customers—abandoned carts, first-time buyers, high spenders.

Steps

1. Go to Customers → Segments

2. Choose a segment → Click Use Segment

3. Select Notification by Segment
4. Select the desired communication channel and message preset. Click Send.

نصيحة

Segments can be created based on purchase history, location, activity, or tags.

Extension 3. Pushwoosh in Shopify Flow

Use case

Automate messaging in customer journeys using triggers like orders, tags, or behavior.

Steps

1. Create a new Flow in Shopify Flow
2. Add action → Choose Pushwoosh send notification

3. Configure message and dynamic fields

For example:

• Send a message after order placed

• Remind user when cart is abandoned

• Send reactivation push after 30 days of inactivity

Part 4. Enable web push (and storefront browsing events)

Optional for web push alone. Required if you need product-view and add-to-cart events on Shopify events and campaigns.

Turn on the theme embed for browser web push on your storefront:

1. Go to Online Store → Themes → Customize
   
2. Open App Embeds from the left menu
3. Toggle Push Init Embed ON

ملاحظة

Now your store can prompt users to opt-in to web push directly from the storefront. If you skip this toggle, you also won’t get storefront browsing events on Shopify events and campaigns. Order paid and checkout events still arrive without it.

Data compliance

Shopify requires every public app to respond to its mandatory GDPR/CCPA webhooks. Pushwoosh handles them as follows:

• customers/redact: When a shopper asks the store to erase their data, Pushwoosh erases the matching Pushwoosh records by whichever identifiers Shopify sends — email, phone, and Shopify customer ID.
• customers/data_request: When a shopper requests a copy of their data, Pushwoosh posts a notification to support’s internal channel, and a person handles the request manually. Shopify requires apps to respond to these within 30 days.
• shop/redact: Shopify sends this 48 hours after a store uninstalls the app, asking to erase the store’s data. Pushwoosh re-runs the same deletion the uninstall itself triggers, clearing any session left over and erasing the store’s integration record (device API key, application code, and billing IDs included). This exists as a safety net for the case where uninstall didn’t fully clean up the first time.

Use cases summary

After setup, common ways to message from Shopify:

Scenario	Tool used
Personalized follow-up	Notification by Customer
Segment-based promotion	Notification by Segment
Welcome message after signing up	Flow + Metafield tracking
Cart abandonment reminder	Shopify Flow + Pushwoosh action
Push opt-in	Theme Embed + Push Init Toggle

For journeys and segments on order, cart, checkout, and storefront events, see Shopify events and campaigns.