Connect WooCommerce

Connect a WooCommerce store with API credentials, choose catalog and order capabilities, and verify safe shopper results.

You need the public store URL and WooCommerce REST API consumer credentials with the access shown by the setup guide.

Using the Fetchply WordPress plugin? It can connect WooCommerce for you in one click, with no keys to create or copy. The steps below are for connecting manually.

Create WooCommerce keys

In WordPress, open WooCommerce REST API settings and create credentials for the intended store. Copy the consumer key and secret once.

Connect the store

Open Integrations → WooCommerce. Enter the HTTPS store URL, consumer key, and consumer secret, then save.

Choose capabilities

Enable Order lookup and Product recommendations as needed. Configure currency, product categories, and draft-product behavior carefully.

Test

Search for a real public product and perform an order lookup with a controlled test order. Confirm the agent does not reveal an order without verification.

Keep WooCommerce credentials out of chat, instructions, screenshots, logs, and documentation. Fetchply stores integration secrets server-side.

Catalog settings

When Product recommendations is on, two optional settings control what the agent can suggest:

Product categories. A comma-separated list that restricts recommendations to specific categories. Enter category slugs (like shoes) or category names (like Shoes); both work, and matching ignores capitalization. Leave it empty to recommend from every published category.
Include draft products. Off by default. When enabled, unpublished draft products can also appear in recommendations, which is useful for stores that stage upcoming products as drafts.

Catalog troubleshooting

The agent recommends products outside my chosen categories. Check the spelling of each entry against your store's category names or slugs. If none of the entries match an existing category, the filter is skipped and the agent searches the whole catalog rather than returning nothing.
A shopper asked for in-stock items and still saw a sold-out product. Stock filtering applies when the shopper's request clearly asks for availability. Make sure the product's stock status is up to date in WooCommerce.
A recommended draft product's link does not open. Draft products are not publicly visible on your storefront, so their links only work for logged-in store staff. Keep Include draft products off unless you are staging products you plan to publish soon.

Order lookup settings

When Order lookup is on, an Order lookup section appears on the WooCommerce settings page with optional tuning:

Order lookup by email. Off by default. When enabled, a shopper who only has their checkout email can list their most recent orders without an order number. Because an email alone is weaker proof of ownership, these answers never include street addresses, the customer name, or order notes; the shopper still sees the status, items, totals, tracking, and delivery estimates. Full details still require the order number plus the matching email.
Order number example. An example of your store's order numbers, such as #1001 or a prefixed format like SO-12345. The assistant uses it to recognize order numbers written in chat and mentions it when asking a shopper for their order number, so they know what to look for.
Lookup instructions. Free-form guidance the assistant follows when sharing order status, for example "Always mention that orders ship from our EU warehouse."

All of these are optional; order lookup works without them.

Order lookup troubleshooting

A shopper gave only their email and was still asked for an order number. Order lookup by email is off by default; turn it on in the WooCommerce settings if you want email-only lookups.
An email-only lookup found nothing, but the order exists. The email must exactly match the billing email on the order. Ask the shopper to use the email from their order confirmation, or to provide the order number instead.
An email-only answer is missing the delivery address. That is intentional: addresses, names, and order notes are never shown for email-only lookups. The shopper can verify with the order number plus their email to get full details.

After a shopper verifies their order, the assistant can answer "when will it arrive?" with an estimated date window computed from your store's shipping policy: your per-method delivery timeframes and processing time, counted in business days. Orders that already carry an estimated delivery date (for example from a shipment tracking plugin) keep that date. To enable estimates, fill in the delivery timeframe for each shipping method and your processing time under your store policies, using a number or range of days such as "3-5 business days". The assistant presents every date as an estimate, never a guarantee, and shares status without a date when no timeframe matches the order's shipping method.

If the store URL or keys change, reconnect and repeat both tests. Disconnect when the store should no longer be available to this agent.