Product docs

WooCommerce integration documentation

Connect your WooCommerce store to Zynli with the WordPress plugin, install starter order workflows on Pro+, and configure identity-aware order lookups, returns intake, and approval controls — without confusing KB answers for live store data.

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.

Supported WooCommerce order actions
ActionTypeDefault approvalNotes
Get order / list orders / get shipmentRead-onlyNot requiredOwnership enforced via logged-in identity, guest OTP + order access token, or verified customer context
Start / confirm guest order verificationRead-only (identity)Not requiredEmail + order number → one-time code; does not grant access from order number alone
Return eligibilityRead-onlyNot requiredEvaluates policy windows and reason codes; does not create a return
Create return requestState-changingAutomatic within policy (merchant-configurable)Records an on-site return request; does not issue a refund
Cancel order / update address / add noteState-changingCloud approval required; plugin default automatic within policyOnly for eligible pre-fulfilment statuses; merchants can set Human approval or Disabled
Create refund / coupon / replacementState-changingHuman 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

Resources