WooCommerce Integration

Connect your WooCommerce store using our lightweight WordPress plugin (v1.2.0). Sync products, orders, customers, and enable abandoned cart tracking.

Features

• WordPress plugin (v1.2.0) - Easy installation via plugin upload
• Real-time sync - Products, orders, customers, and carts sync in real time through the plugin
• Abandoned cart tracking & recovery - Track abandoned carts, recover them with restore links, and record recovered carts
• Storefront tracking - Track page views, product views, add-to-cart, and checkout-started events
• Email capture - Automatically identify customers from checkout and forms
• Cart recovery URLs - Generate recovery links to restore abandoned carts
• Multi-store support - Connect multiple WooCommerce stores with per-store segmentation
• Checkout never blocked - Order events are sent in the background, so Joryio can never slow down or stall a shopper's checkout

Setup Steps

Step 1: Get Your API Key

1. Navigate to Settings → Integrations in Joryio
2. In the WooCommerce section, click Get API Key
3. Copy the generated API key (starts with jry_wc_)

Step 2: Install the Plugin

1. Download the Joryio WordPress plugin from Settings → Integrations in your Joryio dashboard (the Download Plugin button)
2. In WordPress admin, go to Plugins → Add New → Upload Plugin
3. Upload the plugin ZIP file and click Install Now
4. Click Activate

Step 3: Configure the Plugin

1. In WordPress admin, go to Settings → Joryio
2. Paste your API key from Step 1
3. Click Connect

Step 4: Enter WooCommerce API Credentials

The plugin needs WooCommerce REST API access:

1. Go to WooCommerce → Settings → Advanced → REST API
2. Click Add Key
3. Set Description: "Joryio"
4. Set User: Your admin user
5. Set Permissions: Read/Write
6. Click Generate API Key
7. Copy the Consumer Key and Consumer Secret
8. Paste into the Joryio plugin settings

Sync Settings

Configure sync options in Settings → Integrations → WooCommerce → Settings tab:

Setting	Description	Default
Sync Products	Import products from WooCommerce	Enabled
Sync Orders	Import orders and update statuses	Enabled
Sync Customers	Import customer data	Enabled
Sync Carts	Track abandoned carts	Enabled
Historical Days	Days of order history to import	90

Storefront Tracking

The plugin injects a tracking script on all storefront pages:

Event	Description
Page View	Every page visit
Product Viewed	When a product page is viewed
Add to Cart	Items added to cart
Checkout Started	When a shopper reaches checkout
Identify	Email capture from forms

Email Capture

Emails are automatically captured from:

• Checkout billing email field
• Newsletter signup forms
• Any email input field

Abandoned Cart Recovery

The plugin tracks shopping carts in real-time:

1. Cart items and value are tracked as customers shop
2. After 30 minutes of inactivity, cart is marked abandoned
3. A recovery URL is generated to restore the cart
4. Use Canvas to send recovery emails with the restore link

Cart Recovery URLs

When a customer clicks the recovery link:

1. Their cart session is restored
2. All cart items are added back
3. They're redirected to checkout

Multi-Store Support

When connecting multiple WooCommerce stores:

1. Each store gets its own App entity with unique SDK key
2. All events are tagged with the store's $app_id
3. Filter events by $platform = 'woocommerce' or specific $app_id
4. Users can be linked across stores via email

Webhooks

The plugin sends events directly to Joryio (faster than webhooks). Additionally, REST API webhooks are registered as backup:

• Order created, updated, deleted
• Product created, updated, deleted
• Customer created, updated

Data Sync

Manual Sync

Trigger manual sync from Settings → Integrations → WooCommerce → Sync Status tab:

• Sync All - Full sync of products, orders, and customers
• Sync Products - Sync only products
• Sync Orders - Sync only orders
• Sync Customers - Sync only customers

Automatic Sync

The plugin sends real-time events for:

• New orders
• Order status changes
• Product updates
• Customer updates
• Cart changes
• Recovered carts

No scheduled re-sync

Your data stays current through these real-time plugin events, the one-time historical import, and the manual Sync now button. There is no periodic automatic re-sync. If you ever notice data drift (for example after downtime), run a manual sync to backfill from the Sync Status tab.

Troubleshooting

Plugin won't connect

• Verify the API key is correct (starts with jry_wc_)
• Check WordPress has outbound HTTPS access
• Ensure the API endpoint is reachable

WooCommerce API errors

• Verify Consumer Key and Secret are correct
• Check the API user has Read/Write permissions
• Ensure your site has SSL (HTTPS)

Cart tracking not working

• Verify plugin is activated
• Check tracking script loads in browser dev tools
• Clear any caching plugins

Products/Orders not syncing

• Check sync is enabled in Settings tab
• Try manual sync with "Sync All" button
• Check WooCommerce REST API is enabled