> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WooCommerce Integration

> Connect a WooCommerce store to Sequenzy to sync products, customers, orders, back-in-stock requests, and recovery events.

# WooCommerce Integration

You can connect a WooCommerce store to Sequenzy with the Sequenzy WooCommerce plugin.

Once connected, Sequenzy can sync store data, track customer activity, and power WooCommerce recovery flows.

The plugin is available on WordPress.org: [Sequenzy for WooCommerce](https://wordpress.org/plugins/sequenzy-for-woocommerce/).

## What It Does

* Sync products, customers, guest buyers, and orders
* Deliver cart and checkout activity to Sequenzy
* Capture product back-in-stock requests from your storefront
* Trigger replenishment reminders after WooCommerce purchases
* Let you run a manual store sync from `Settings -> Integrations`
* Show plugin connection health in Sequenzy

## How To Connect

1. Open `Settings -> Integrations` in Sequenzy.
2. Find `WooCommerce` and click `Install Plugin`.
3. Open the WordPress.org plugin page for [Sequenzy for WooCommerce](https://wordpress.org/plugins/sequenzy-for-woocommerce/).
4. In WordPress, go to `Plugins -> Add Plugin`, search for `Sequenzy for WooCommerce`, install it, and activate it.
5. Open `WooCommerce -> Sequenzy` in WordPress.
6. Click `Connect to Sequenzy`.
7. Sign in to Sequenzy, choose the company, and approve the connection.
8. Return to WordPress and finish the connection if the plugin asks you to confirm.

You need owner or admin access to the selected company to approve the connection.

## What Syncs

### Store Data

* Products
* Registered customers
* Guest buyers
* Orders

### Recovery Events

* `ecommerce.cart_started`
* `ecommerce.cart_cleared`
* `ecommerce.checkout_started`

### Order Events

WooCommerce orders trigger `ecommerce.order_placed` with product line items:

```json theme={null}
{
  "orderId": "501",
  "orderedAt": "2026-04-02T00:00:00.000Z",
  "lineItems": [
    {
      "provider": "woocommerce",
      "providerProductId": "101",
      "providerVariantId": "102",
      "title": "Coffee Beans",
      "quantity": 1,
      "priceCents": 2500
    }
  ]
}
```

Sequenzy uses `lineItems[].providerProductId` and `lineItems[].providerVariantId` for product-aware automation matching.

## Replenishment Reminders

WooCommerce products can use the same replenishment flow as Shopify products:

1. Sync your store products.
2. Open `Settings -> Products`.
3. Choose a product.
4. Enable replenishment and set how many days after purchase the product usually runs out.
5. Choose whether matching should use the product or exact variant.

When a matching WooCommerce order is received, Sequenzy queues a reminder. If the customer buys the same product again before the reminder is due, the reminder is skipped. When the reminder fires, it triggers `ecommerce.replenishment_due`.

Sequences started by `ecommerce.replenishment_due` default to stopping when the same product is purchased again.

## Back-In-Stock Requests

WooCommerce can use the same back-in-stock waitlist model as Shopify. When a shopper asks to be notified, send the request to Sequenzy:

```bash theme={null}
curl -X POST "https://api.sequenzy.com/api/woocommerce/back-in-stock/subscribe" \
  -H "Content-Type: application/json" \
  -H "Origin: https://store.example.com" \
  -d '{
    "storeUrl": "https://store.example.com",
    "email": "buyer@example.com",
    "providerProductId": "501",
    "productTitle": "Coffee Refill Pack"
  }'
```

For simple WooCommerce products, Sequenzy uses the product ID as the back-in-stock variant identity. If you have a variant-specific implementation, include `providerVariantId` and `variantTitle`. Variation stock webhooks should include the parent product ID as `parent_id` and the variation ID as `id`.

When a WooCommerce product update reports the product as in stock, Sequenzy marks matching active waitlist entries as notified and triggers `ecommerce.back_in_stock`.

```json theme={null}
{
  "provider": "woocommerce",
  "providerProductId": "501",
  "providerVariantId": "501",
  "productTitle": "Coffee Refill Pack",
  "productUrl": "https://store.example.com/product/coffee-refill-pack",
  "imageUrl": "https://store.example.com/uploads/coffee.png",
  "requestedAt": "2026-04-01T12:00:00.000Z",
  "backInStockAt": "2026-04-02T08:00:00.000Z"
}
```

If the product goes out of stock again after notification, Sequenzy triggers `ecommerce.back_in_stock_out_of_stock` so matching back-in-stock sequences can stop safely.

## Subscriber Profiles

WooCommerce data appears on subscriber profiles:

* Purchased products from order line items
* Product images and URLs when the synced catalog has them
* Pending replenishment reminders
* Active back-in-stock waitlist entries
* Revenue attributes such as `ordersCount`, `totalSpent`, `ltv`, and `aov` when available

## Manual Sync

You can click `Sync Store` in `Settings -> Integrations` to request a fresh WooCommerce sync from Sequenzy.

## Managing The Integration

* The initial sync starts automatically after approval
* You can reconnect or disconnect the integration from `Settings -> Integrations`
* Sequenzy shows whether the plugin is connected and when it was last seen
* Manual sync requests are supported for plugin-connected stores

## Current Beta Scope

* Product, customer, guest buyer, and order sync
* Cart and checkout event delivery
* Product-level back-in-stock waitlists
* Product-level and variant-level replenishment matching from order line items
* Manual sync from Sequenzy
* Connection health and diagnostics

## Current Limitations

* `ecommerce.cart_started` only works when WooCommerce already knows the shopper email
* Truly anonymous guest carts cannot be recovered until the shopper identifies themselves
* Built-in back-in-stock capture UI is not packaged in the plugin yet; use the subscribe endpoint from your product page or custom block