Skip to main content

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

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.

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. Download the plugin ZIP.
  4. In WordPress, go to Plugins -> Add Plugin -> Upload Plugin, upload the ZIP, 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:
{
  "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:
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.
{
  "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

  • No automatic plugin updates yet
  • No marketplace packaging yet
  • 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