Skip to main content

​
WooCommerce Plugin

The direct-install WooCommerce plugin is the new preferred path for connecting a WooCommerce store to Sequenzy. Instead of asking you to paste WooCommerce REST credentials into Sequenzy, the plugin starts a connection request inside WordPress and sends you straight to Sequenzy to sign in and choose the company that should own the store.

​
What the current beta includes

  • Direct-install plugin pairing
  • A first-class WooCommerce plugin beta flow in Settings -> Integrations
  • A browser authorize page at /setup/woocommerce
  • A dedicated installation token for each plugin install
  • Plugin heartbeat reporting so Sequenzy can track connection health
  • Initial sync for products, registered customers, and guest buyers
  • Product, customer, and order event delivery from the plugin
  • Cart-updated event delivery for known WooCommerce shoppers
  • Checkout-started event delivery from the plugin for Woo checkout recovery flows
  • Plugin-side retries for transient API failures
  • A local diagnostics panel for recent plugin delivery failures
  • Plugin-side disconnect support
  • A simplified plugin admin flow built around connect, reconnect, disconnect, sync, and diagnostics
  • Automatic initial sync right after plugin approval
  • Manual Sync Store requests from Sequenzy, even when the store is connected through the plugin
  • Repeatable zip packaging from the repo with bun run build:plugins

​
What is not included yet

  • Automatic plugin updates
  • A polished in-app installer/update flow inside Sequenzy
  • Full marketplace packaging for WordPress.org and Woo Marketplace
Those pieces are the next layer on top of the current direct-install beta.

​
How connection works

  1. You open the plugin in WordPress and click Connect to Sequenzy.
  2. The plugin sends store metadata to Sequenzy and gets back a direct authorize URL.
  3. Sequenzy opens a hosted page where you sign in if needed and choose which company should own the store.
  4. The plugin polls Sequenzy until the connection is complete.
  5. Sequenzy issues a dedicated installation token scoped to that WooCommerce integration.
  6. After that, the plugin also polls Sequenzy for manual sync requests from the app and runs the sync locally when needed.
This token is separate from normal Sequenzy API keys, so reconnecting or disconnecting the plugin does not affect other tools.

​
What Sequenzy tracks

After approval, Sequenzy stores:
  • the connected company
  • the WooCommerce store URL and site name
  • the plugin version
  • the WordPress version
  • the WooCommerce version
  • the last heartbeat time
This makes it easier to see whether the plugin is connected, stale, or disconnected.

​
Why this direction

The plugin-first path avoids several problems with direct credential entry:
  • merchants do not need to generate and paste Woo API keys
  • plugin installs get their own revocable credentials
  • local and unusual Woo setups no longer depend on Woo webhook registration as the first step
  • Sequenzy gets an explicit installation identity for support and diagnostics

​
Current status

This is still a beta direct-install connector, not a finished marketplace release. If you are testing this flow, you can now use it for real connection, initial sync, cart-started tracking, cart-cleared tracking, checkout-started tracking, and ongoing Woo event delivery. Automatic updates and marketplace packaging are still pending.

​
Abandoned cart and abandoned checkout

The WooCommerce plugin beta now exposes three recovery-friendly events:
  • ecommerce.cart_started
  • ecommerce.cart_cleared
  • ecommerce.checkout_started
The practical split is:
  • Use ecommerce.cart_started for abandoned-cart sequences
  • Use ecommerce.checkout_started for abandoned-checkout sequences
  • Let cart flows continue only while the subscriber still has the ecommerce.in_cart tag
  • Let checkout flows continue only while the subscriber still has the ecommerce.in_checkout tag
Current limitation:
  • ecommerce.cart_started only fires when WooCommerce already knows the shopper email, such as logged-in customers or sessions where Woo has captured customer details
  • ecommerce.cart_cleared clears cart state for known shoppers who empty the cart
  • truly anonymous guest carts still cannot be recovered until the shopper identifies themselves

​
Manual sync from Sequenzy

The Sync Store button in Sequenzy now works for plugin-connected WooCommerce stores too. When you click it in Sequenzy:
  1. Sequenzy records a pending sync request on the WooCommerce integration.
  2. The installed plugin polls Sequenzy for commands on a recurring schedule.
  3. The plugin runs a full local sync of products, customers, and guest buyers.
  4. The plugin acknowledges the result so Sequenzy can update sync status and timestamps.
This keeps the app-level UX simple while letting the plugin execute the sync locally.