WooCommerce
Learn how to connect WooCommerce to Keeping.
WooCommerce integration
Keeping's WooCommerce integration brings your store's customer and order history into the inbox. When a customer emails you, Keeping looks them up in WooCommerce by email address and shows their order history (including order status and shipment tracking) right next to the conversation, so agents can answer "where's my order?" without ever leaving Keeping.
The integration is read-only: it pulls data from WooCommerce into Keeping for reference. It doesn't push anything back, so nothing about your WooCommerce store can be changed from inside Keeping.
What you can do
See WooCommerce customers inline. When a conversation arrives, Keeping looks up the sender's email in your store and shows the matching customer record alongside the message.
See recent orders. The panel lists the customer's three most-recent orders with order number, date, total, status, and shipment tracking (when available).
Handle guest checkouts. Customers who checked out without creating a WooCommerce account still appear in the panel — Keeping pulls their order history by searching orders for the matching billing email.
Open orders in WP-Admin. One click jumps from Keeping straight into the WordPress admin, filtered to that customer's orders.
Connect multiple stores. If your team supports more than one WooCommerce store, you can connect them all to the same Keeping company. Each conversation surfaces the matching customer from whichever store(s) have a record for that email.
Before you start
You'll need:
A Keeping account with admin access — only admins can connect or disconnect WooCommerce stores.
An administrator account on the WooCommerce store you want to connect, with permission to create REST API keys.
The store's URL (e.g.,
https://shop.example.com). HTTPS is required.
Connecting a WooCommerce store to Keeping
WooCommerce doesn't offer a single-click sign-in flow for third-party apps. Instead, you'll generate a pair of REST API credentials inside your WooCommerce admin and paste them into Keeping. This takes a couple of minutes and only needs to be done once per store.
Step 1 — Generate REST API credentials in WooCommerce
Sign in to your WordPress admin as an administrator.
In the left sidebar, go to WooCommerce → Settings.
Open the Advanced tab, then click REST API in the sub-navigation.
Click Add key.
Fill in the form:
Description: A name you'll recognize later, e.g.,
Keeping.User: An administrator account on the store. Keeping's access is scoped through this user, so pick an account you don't plan to delete.
Permissions: Read. Keeping is read-only and doesn't need write access.
Click Generate API key.
WooCommerce will show you a Consumer key and Consumer secret. Leave this tab open — you'll paste both values into Keeping in the next step. The Consumer secret is shown only once; if you navigate away before saving it, you'll need to revoke this key and generate a new one.
Step 2 — Paste the credentials into Keeping
In the left-hand sidebar, click Integrations.
Find the WooCommerce tile and click Add Integration.
A connect window opens. Fill in:
Store URL: The full URL of your WooCommerce store, including
https://(for example,https://shop.example.com). Do not include a trailing slash or any path.Consumer key: Paste the Consumer key from WooCommerce.
Consumer secret: Paste the Consumer secret from WooCommerce.
Click Connect.
Keeping verifies the credentials against your store, fetches the store name and currency, and adds the store to your integration list. You can now close the WooCommerce REST API tab in WordPress — you won't need the keys again unless you decide to rotate them.
The integration is automatically attached to every mailbox in your Keeping company, so it starts working immediately for new conversations.
Using WooCommerce in the inbox
Open any conversation in Keeping. The WooCommerce panel appears in the right-hand sidebar whenever the sender's email matches a customer or an order in one of your connected stores.
When the sender is a registered customer
The panel shows:
The customer's email and the date they registered.
Their lifetime value (total spent), in the store's currency.
A View profile link that opens the customer in WP-Admin.
A View orders link that opens the WP-Admin orders list filtered to this customer's email.
The three most-recent orders, each showing order number, date, total, status, and shipment tracking (if available).
When the sender checked out as a guest
If a customer placed an order without creating a WooCommerce account, Keeping still shows their order history. The panel works the same as for registered customers, with two small differences:
No View profile link — there's no WooCommerce customer record to open. (The View orders link still works because it filters by email, not by customer ID.)
Lifetime value isn't shown, because WooCommerce doesn't aggregate spend for guest checkouts.
Shipment tracking
If your store uses the WooCommerce Shipment Tracking plugin (bundled with WooCommerce on WordPress.com, and available as a free download elsewhere), Keeping reads tracking details directly from each order and shows them in the order card.
For every shipment on an order, you'll see:
The carrier (e.g., FedEx, UPS, Royal Mail).
The tracking number.
A click-through link to the carrier's tracking page, if your store has a tracking URL configured for that carrier (or if the person who shipped the order entered a custom tracking URL).
If you don't see tracking details on an order that has them in WooCommerce, install or enable the WooCommerce Shipment Tracking plugin in your store — Keeping reads the tracking metadata that plugin writes to each order.
How fresh is the data?
To keep your store responsive under load, Keeping caches each customer's WooCommerce data for about five minutes. If you place or update an order in WooCommerce and don't see the change in the inbox right away, give it a few minutes and refresh the conversation.
Disconnecting a store
To disconnect:
Go to Settings → Integrations → WooCommerce.
Find the store you want to disconnect.
Click Disconnect on that row.
Disconnecting a store immediately stops the WooCommerce panel from appearing for that store's data. The store remains in Keeping's records (greyed out) so that reconnecting later restores the connection without losing any history. Disconnecting one store doesn't affect any other stores you have connected.
Troubleshooting
The WooCommerce panel doesn't appear for a customer I know exists in the store. Check that:
The email Keeping is looking up matches the email on the customer's WooCommerce profile (or, for guest checkouts, the billing email on at least one order). WooCommerce treats email comparisons as case-insensitive, but stray spaces or aliases can cause mismatches.
The integration is still connected on Settings → Integrations → WooCommerce. If a store shows as disconnected, click Add Integration to reauthorize.
You haven't placed the order in the last few minutes — Keeping caches customer data for about five minutes.
A profile link is missing from the panel. That's expected for guest checkouts — WooCommerce doesn't create a customer record when a shopper checks out without registering, so there's no profile to link to. The View orders link still works.
Tracking numbers aren't showing on orders that have them. Keeping reads tracking data from the WooCommerce Shipment Tracking plugin. If your store records tracking elsewhere (a different plugin, a custom field, an ERP), it won't appear in Keeping. Switching the store to WooCommerce Shipment Tracking — or adding it alongside your existing setup — is the fix.
The store list shows the wrong store name or currency. Both are pulled from WooCommerce's general settings (Settings → General) at connect time. After updating either in WooCommerce, disconnect and reconnect the store in Keeping to refresh the cached values.
I need help. If you're still stuck, email [email protected] and we'll dig in.
Last updated