Purpose
This guide shows merchants how to connect WooCommerce, enable live order and tracking reads, understand verification, and configure state-changing actions safely. Zynli remains a general SMB support platform; WooCommerce is one supported store integration.
Prerequisites
- WordPress site with WooCommerce active (commerce actions require WooCommerce)
- Ability to install plugins from WordPress.org
- Zynli workspace on Pro or higher for store integrations and flows
- Admin access to WordPress and to Zynli Settings → Integrations
Connect WooCommerce to Zynli
Accurate UI steps from the plugin and dashboard:
- Install the Zynli plugin from wordpress.org/plugins/zynli (or your packaged zip in staging)
- In WordPress admin open Zynli
- Click Enable Zynli — you will authorize the site (create a free Zynli account or sign in)
- In Zynli, open Settings → Integrations to confirm the WordPress / WooCommerce connection
- When prompted, choose Install workflows (or Reinstall workflows) for the starter pack
- Optional: Download starter KB for WooCommerce policy seed content, then refine in Knowledge → Sources
Configure order-status workflows
After Install workflows, starter flows such as order status and shipment status call secure WooCommerce actions. Open Actions & Flows → Flow builder to review triggers (When visitor says…), Call API action steps, and replies. Publish only after testing with a non-production order.
- Confirm Pro entitlement if Integrations shows Pro plan required
- Keep knowledge-base shipping SLAs for pre-shipment answers
- Add guest OTP verify.start / verify.confirm nodes if guests are primary
Customer identity verification
Logged-in customers
Signed identity from the plugin can include WooCommerce traits used for ownership checks.
Guest OTP
Start guest order verification emails a 6-digit code (15-minute TTL). Confirm guest order verification returns a short-lived order access token (typically one hour).
Authorization rule
Order reads succeed only when the actor is privileged, presents a valid order access token, or matches billing email / customer id — not from knowing an order number alone.
Supported order and tracking fields
When authorized, order detail payloads can include fields such as status, total, currency, payment method, payment status, shipping methods, line items, refunded totals, remaining refundable amount, masked shipping address, tracking, carrier, and tracking details. Shipment actions expose status, shipping methods, and tracking. Tracking providers read native order meta (_tracking_number, _tracking_provider, _tracking_link) and, when present, WooCommerce Shipment Tracking items.
- List summaries: orderId, status, total, currency, dateCreated, fulfillmentSummary, refundedTotal
- Missing tracking is a data gap — escalate or explain; do not invent carrier scans
Returns intake and escalation
Return eligibility is a read-only check. Create return request stores an auditable on-site return (status requested / approval pending). It does not approve refunds or move money. Plugin admin copy: “Returns are recorded on-site; approve refunds from Zynli or WooCommerce.” Escalate damaged goods, disputes, and policy exceptions to humans.
State-changing actions, policies, and approvals
In WordPress → Zynli → Action execution modes, set Mode to Disabled, Human approval, or Automatic within policy, then Save action modes. Defaults put refund, coupon, and replacement on Human approval; cancel, return create, and address update default to Automatic within policy (still subject to cloud approval gates where marked). In Zynli, use Pending action approvals to Approve or Reject high-risk tool calls.
Realistic example
A guest asks where order #1049 is. The flow collects email + order number, runs guest verification, calls Get WooCommerce order, and replies that the order is processing with no tracking yet, citing your knowledge-base ship window. If the customer insists on a human, escalate with the thread.
Expected outcome
- Integrations shows a connected WooCommerce site and starter pack counts
- Order status questions resolve with authorized live fields when available
- Returns create intake records without auto-refunding
- Financial mutations wait for human approval when required
Troubleshooting and integration failures
- Not connected: WordPress shows “Not connected. Click Enable Zynli to authorize this site.”
- WooCommerce inactive: commerce actions fail with dependency errors — activate WooCommerce
- Pro plan required in Settings → Integrations: upgrade before store workflows run
- Reinstall workflows overwrites custom changes to starter flows — confirm before Reinstall workflows
- Payment gateway unsupported on refund: handle in WooCommerce admin; escalate the customer
- Safe fallback: KB policy answer + human handoff when live reads fail
Plan requirements
- Free: widget experiments without store automation
- Starter ($49/mo): knowledge base and ticketing — not WooCommerce store actions
- Pro ($129/mo) and higher: integrations, flow nodes, WooCommerce/Shopify store connect and commerce actions
Limitations
- Customer-facing returns intake is not automatic refund execution
- Zynli does not control carriers or guarantee delivery
- WhatsApp order support is not a verified channel in this product surface
- Shopify has dashboard connect code paths; treat public Shopify availability according to current Integrations UI for your workspace
Related guides
Support workflows documentation
Intent routing, Flow builder, approvals, and failure handling.
Order status automation
WISMO buyer page with illustrative conversation.
AI returns support
Returns and refund question automation with honest limits.
Human handoff documentation
When and how conversations escalate to agents.
Supported WooCommerce order actions
Read actions return live store data after customer identity checks. State-changing actions follow merchant Action execution modes in the WordPress plugin and may require human approval in Zynli before they run.
| Action | Type | Default approval | Notes |
|---|---|---|---|
| Get order / list orders / get shipment | Read-only | Not required | Ownership enforced via logged-in identity, guest OTP + order access token, or verified customer context |
| Start / confirm guest order verification | Read-only (identity) | Not required | Email + order number → one-time code; does not grant access from order number alone |
| Return eligibility | Read-only | Not required | Evaluates policy windows and reason codes; does not create a return |
| Create return request | State-changing | Automatic within policy (merchant-configurable) | Records an on-site return request; does not issue a refund |
| Cancel order / update address / add note | State-changing | Cloud approval required; plugin default automatic within policy | Only for eligible pre-fulfilment statuses; merchants can set Human approval or Disabled |
| Create refund / coupon / replacement | State-changing | Human approval (default) | Refunds also depend on the payment gateway; returns intake is separate from refund execution |
WooCommerce starter workflows
Configure AI support for orders, shipping, returns, billing, and product questions — grounded in your knowledge base and connected to your APIs.
Order Agent
Order status, delivery updates, and order lookup.
Example questions
- · Where is my order?
- · Has my order shipped?
- · Can I change my delivery address?
Example actions
- · Check order status
- · Fetch tracking number
- · Escalate delayed orders
Shipping Agent
Shipping timelines, carrier updates, and delivery exceptions.
Example questions
- · When will this ship?
- · Why is my delivery late?
- · Can I upgrade to express shipping?
Example actions
- · Pull carrier tracking
- · Explain shipping SLA from KB
- · Create ticket for lost packages
Returns Agent
Return eligibility, refund status, and exchange requests.
Example questions
- · How do I return this item?
- · When will I get my refund?
- · Can I exchange for a different size?
Example actions
- · Apply return policy from KB
- · Check refund status via API
- · Open return ticket for review
Product Agent
Product specs, availability, sizing, and compatibility.
Example questions
- · Which size should I buy?
- · Is this compatible with X?
- · Do you have this in stock?
Example actions
- · Answer from product knowledge base
- · Compare product variants
- · Route to sales for custom orders
AI resolves most issues. Agents handle the rest.
When automation can't resolve an issue — damaged goods, billing disputes, or policy exceptions — escalate to a human agent with full thread history and optional ticket creation.
- Low-confidence answers trigger handoff automatically
- Agents see chat history, citations, and workflow run logs
- Escalations become numbered tickets on your kanban board
- Customers track progress via magic-link portal
Visitor
My package arrived damaged. I need a replacement.
AI workflow
Connecting you with an agent — your order details and photos are included.
Human agent
Replacement arranged. Ticket created for tracking.
Frequently asked questions
Where do I click to connect the plugin?
In WordPress admin open Zynli and click Enable Zynli. Then confirm the connection under Settings → Integrations in your Zynli workspace.
Do I need Pro for WooCommerce order automation?
Yes. WooCommerce and Shopify store integrations require Pro or higher. Starter includes knowledge base and ticketing without store commerce actions.
Does creating a return refund the customer?
No. Create return request records an on-site return for review. Refunds use Create refund with human approval by default and depend on the payment gateway.
Which order fields can workflows read?
Authorized reads can include status, totals, payment fields, shipping methods, line items, and tracking/carrier fields when stored on the order. Exact values depend on your store data.
What if Install workflows fails or I customized starters?
Use Reinstall workflows only if you accept overwriting custom changes to starter flows. Otherwise edit flows manually in Actions & Flows → Flow builder.
See how Zynli automates your support
Train AI on your knowledge base, connect your APIs, and resolve order, shipping, billing, and return issues in chat.
Product documentation
ResourcesAI customer support for WooCommerce
Buyer-facing WooCommerce platform page.
Learn moreOrder status automation
Where-is-my-order path with illustrative conversation.
Learn moreAI returns support
Returns intake vs refund execution.
Learn moreSupport workflows docs
Flow builder, identity verification, and approvals.
Learn moreHuman handoff docs
When exceptions escalate to agents.
Learn more