> For the complete documentation index, see [llms.txt](https://docs.keeping.com/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.keeping.com/help/setup/integrations/woocommerce.md).

# WooCommerce

## 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.

<figure><img src="/files/PWcRIIocu4oK5fd2gqAl" alt=""><figcaption><p>See WooCommerce customer info in Gmail</p></figcaption></figure>

### 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

1. Sign in to your WordPress admin as an administrator.
2. In the left sidebar, go to **WooCommerce → Settings**.
3. Open the **Advanced** tab, then click **REST API** in the sub-navigation.
4. Click **Add key**.
5. 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.
6. Click **Generate API key**.
7. 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

1. In the left-hand sidebar, click **Integrations**.
2. Find the **WooCommerce** tile and click **Add Integration**.
3. 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.
4. 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.

<figure><img src="/files/j4Gy5Iy7PAMABQ39uN5y" alt=""><figcaption></figcaption></figure>

### 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.

<figure><img src="/files/7VInG6dumSFfNgjT05oJ" alt=""><figcaption></figcaption></figure>

#### 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:

1. Go to **Settings → Integrations → WooCommerce**.
2. Find the store you want to disconnect.
3. 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 <support@keeping.com> and we'll dig in.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.keeping.com/help/setup/integrations/woocommerce.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.