WooCommerce connector
Connect WooCommerce to FreeScout so conversations show matched customer orders and purchase context. The connector talks directly to the WooCommerce REST API, so there is no store-side plugin to install. On Pro, ReplyRabbit also feeds product-ownership context into the AI layer so drafts can reference what a customer has bought.
Looking for the overview?
Overview
The WooCommerce connector adds an order sidebar to FreeScout conversations. When a conversation has a customer email address, the connector queries the WooCommerce REST API (wc/v3) on your store for matching orders and shows them next to the conversation.
Free shows a basic customer panel plus up to three recent orders, each with order number, date, status, and total. Pro adds full order history, per-order line items with quantities and prices, financial totals, customer lifetime value (CLV), average order value (AOV), and product-ownership entitlement that flows into the ReplyRabbit AI context for more relevant drafts.
There is one component to install: the FreeScout WooCommerce connector module. It reads the WooCommerce REST API over HTTPS using a consumer key and secret, then renders the order sidebar. It has its own per-mailbox settings page in FreeScout.
The order sidebar works on its own. The product-ownership entitlement that flows into AI drafts is the part that uses ReplyRabbit.
Prerequisites
Before you start, make sure you have:
- A working FreeScout installation.
- A WooCommerce store reachable over HTTPS, with admin access to create REST API keys.
- A store that is not behind site-wide Basic HTTP Authentication, which conflicts with the REST API authentication header.
- ReplyRabbit installed and activated if you want product-ownership context in AI drafts.
- A way to unlock Pro for the connector: a free connector license key from your ReplyRabbit account during the launch promo, or an active paid ReplyRabbit plan (Pro or Team).
If ReplyRabbit is not installed yet, start with How to install the ReplyRabbit module, then finish How to set up ReplyRabbit.
Generate WooCommerce REST API keys
The connector authenticates with a WooCommerce REST API key, made of a consumer key and a consumer secret. Create the key in your WordPress admin.
Open the REST API settings
In the WordPress admin, go to WooCommerce, then Settings, then Advanced, then REST API.Add a key
Click Add key. Enter a description such as "FreeScout connector", set Permissions to Read, and click Generate API key.Copy the consumer key and secret
Copy the Consumer key and Consumer secret. WooCommerce shows the secret once, so store both values somewhere safe before you leave the page.
Read-only access
Install the FreeScout connector module
The FreeScout WooCommerce connector module queries the WooCommerce REST API and renders the order sidebar in conversations. It is its own module with its own settings, separate from ReplyRabbit.
Download the connector module
Free during the launch promo. Log in with a verified email at app.replyrabbit.app to download the FreeScout connector module ZIP.Upload to FreeScout
In FreeScout, go to Modules, click the upload button, choose the ZIP, and install it.Activate the module
Activate the WooCommerce module from the Modules list.
Configure per mailbox
After the module is installed, connect it to your store in the connector's own per-mailbox settings page.
Open the connector settings
In FreeScout, open the mailbox that should show WooCommerce order data, open the mailbox settings menu, and choose Store Connector. This is the WooCommerce connector's settings page, not a section inside the ReplyRabbit settings.Enter the store URL
Paste the base URL of your WooCommerce store over HTTPS, for examplehttps://your-store.com. A trailing slash is not needed.Enter the consumer key and secret
Paste the Consumer key and Consumer secret you generated in WooCommerce. They are stored encrypted, and only a masked preview is shown after saving.Add a Pro license key (optional)
To unlock Pro features, enter a connector license key. Skip this step if an active paid ReplyRabbit plan already unlocks Pro for the install.Save and test
Save the settings. Open a FreeScout conversation where the customer email matches a WooCommerce order and confirm that the order sidebar appears.
Each FreeScout mailbox stores its own store URL and REST API keys, so you can connect different mailboxes to different WooCommerce stores.
Free vs Pro
| Feature | Free | Pro |
|---|---|---|
| Customer panel | Yes | Yes |
| Recent orders (order number, date, status, total) | Up to 3 | Full history |
| Per-order line items with quantities and prices | No | Yes |
| Financial totals (subtotal, discount, shipping, tax, refunds) | No | Yes |
| Customer lifetime value (CLV) and average order value (AOV) | No | Yes |
| Product-ownership entitlement for AI drafts | No | Yes |
How to unlock Pro
Pro is free for a limited time during the launch promo. You can unlock the same Pro features two ways:
- Log in with a verified email at app.replyrabbit.app to download the connector and copy your free connector license key, then paste it into the connector settings.
- Run any active paid ReplyRabbit plan (Pro or Team), which unlocks the connector's Pro features at no extra cost.
Get your free connector license key and download from your ReplyRabbit account. Visit the pricing page for ReplyRabbit plan options. If a paid plan already covers the install, Pro activates once the connector is configured, with no license key needed.
Troubleshooting
| Symptom | What to check |
|---|---|
| Order sidebar does not appear | Confirm the store URL, consumer key, and consumer secret in the connector settings are correct, and that the mailbox panel is enabled. |
| "Connection refused" or timeout error | Check that the FreeScout server can reach your store URL over HTTPS. Firewalls, IP allowlists, or maintenance mode may block the request. |
| Store URL is rejected | The store must be served over HTTPS. A plain http:// URL or an unreachable host is refused. |
| Authentication fails | Confirm the store is not behind site-wide Basic HTTP Authentication, which intercepts the REST API authentication header before WooCommerce sees it. |
| Consumer key or secret is rejected | Regenerate the key in WooCommerce under Settings, then Advanced, then REST API, with Read permission, and paste the new consumer key and secret into the connector settings. |
| Orders are empty for a known customer | Confirm the customer email on the FreeScout conversation matches the billing email on their WooCommerce orders. |
| Line items, financials, or CLV are not showing | Confirm Pro is unlocked through a connector license key or an active paid ReplyRabbit plan. |
| Product-ownership context not appearing in drafts | Confirm Pro is active, ReplyRabbit is installed, the connector is returning orders, and the AI context feature is enabled for the mailbox. |
For broader issues, see Troubleshooting ReplyRabbit.
Privacy and data handling
When the connector queries WooCommerce, it sends the customer email address to your own WooCommerce REST API over HTTPS. The order data returned from your store populates the FreeScout sidebar and, on Pro with ReplyRabbit, builds the AI context for drafts.
The REST API key needs only Read permission, so the connector never writes to your store. The consumer key and secret are stored encrypted in FreeScout, and outbound requests verify TLS and follow no redirects.
No WooCommerce order data is sent to third parties except through the AI provider selected for the mailbox, and only when the AI context feature uses it. If your policy requires order data to stay entirely on your own servers, use a local AI provider (such as Ollama) for the mailbox.
Next steps
- Finish How to set up ReplyRabbit if the mailbox still needs provider, context, or style settings.
- See How to install the ReplyRabbit module if you have not yet installed ReplyRabbit.
FAQ
Do I need a WordPress plugin for the WooCommerce connector?
No. The connector talks directly to the WooCommerce REST API. You generate a REST API key in WooCommerce and enter the store URL, consumer key, and consumer secret in the FreeScout connector. There is one free download, the FreeScout WooCommerce connector module.
Which plan includes WooCommerce order data?
Free shows a basic customer panel plus up to three recent orders with order number, date, status, and total. Pro adds full order history, per-order line items, financial totals, CLV, AOV, and product-ownership entitlement for AI drafts.
How do I unlock Pro features?
Pro is free for a limited time during the launch promo. Log in with a verified email at https://app.replyrabbit.app to download the connector and copy your free connector license key, then paste it into the connector settings. Any active paid ReplyRabbit plan also unlocks the same Pro features at no extra cost.
How does the connector match customers?
The connector looks up WooCommerce orders by the customer email address on the FreeScout conversation. For product-ownership on Pro, it also checks linked emails and, as a best-effort fallback, other paid orders on the same email domain.
What permission does the REST API key need?
Read only. The connector never writes to your store, so a key with Read permission is enough.
Can each FreeScout mailbox connect to a different WooCommerce store?
Yes. Each mailbox stores its own store URL and REST API keys in the connector settings, so different stores can connect to different mailboxes.