> ## Documentation Index
> Fetch the complete documentation index at: https://wabis.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# WooCommerce

> Connect your WooCommerce store to send order updates, confirm COD orders, and remind customers who didn't finish paying.

## What is this?

The **WooCommerce** integration connects your online store to your workspace. When an order is placed or its status changes, WooCommerce tells the platform, and an automation sends the right WhatsApp template — for example *Your order is on its way* when an order becomes **Completed**.

Unlike Shopify, WooCommerce connects with your store's **API keys**. Saving the connection creates a secure webhook in your store and a ready-made automation for you.

## What can I do here?

* Connect one or more WooCommerce stores to a channel
* Send a WhatsApp template for each order status
* Ask cash-on-delivery customers to **confirm or cancel** — see [COD Confirmation](https://wabis.mintlify.site/workspace/integrations/cod-confirmation.md)
* Remind customers who left an order unpaid — see [Abandoned Cart Recovery](https://wabis.mintlify.site/workspace/integrations/abandoned-cart.md)
* Look up and update orders in your own flows with the [WooCommerce order steps](https://wabis.mintlify.site/workspace/automation/steps/integrations.md)

## How to use it

### The plugin (optional)

If your platform offers a WooCommerce plugin, a card on this page titled **WooCommerce plugin (optional)** has a **Get the plugin** button. The plugin sends order messages and abandoned-cart reminders from inside your store. You still connect your store below, so AI agents and automations can see and update your orders.

### Create your API keys in WooCommerce

In your WordPress admin, go to **WooCommerce → Settings → Advanced → REST API** and add a key with **Read/Write** permission. Copy the **Consumer key** and **Consumer secret**.

> [!WARNING]
>
> The key must have **Read/Write** permission. Creating the store's webhooks needs it, and COD confirmation changes orders. A read-only key is rejected.

### Connect the store

**1. Open the WooCommerce page**

Go to **Integrations** and click **WooCommerce**, then **Connect** (or **Add another store**).

**2. Enter your store details**

Fill in:

* **WooCommerce store URL** — for example `https://mystore.com`
* **WooCommerce consumer key**
* **WooCommerce consumer secret**

**3. Choose your messages**

Pick a WhatsApp template for each order status you want to notify about:

| Status | When it applies |
| - | - |
| **Pending payment** | Order received, waiting for payment |
| **Processing** | Payment received, order being prepared |
| **On hold** | Waiting for you to confirm something |
| **Completed** | Order fulfilled |
| **Cancelled** | Order cancelled |
| **Refunded** | Order refunded |
| **Failed** | Payment failed |
| **COD (awaiting confirmation)** | An open cash-on-delivery order |

Leave a status empty to send nothing for it.

**4. Set up and activate**

Click **Set up and activate**. A signed webhook is added to your store automatically, and the automation is created.

> [!NOTE]
>
> If a template contains variables, the page shows "variable(s) to check." After saving, open the automation in the builder and choose the value for each one.

### Manage a connected store

Click a store to open it. The tabs are:

| Tab | What's in it |
| - | - |
| **Overview** | Status, last event, signature verification, and **Verify on WooCommerce** to confirm the webhooks exist |
| **Messages** | The status-to-template mapping (read-only — edit the flow in the automation builder) |
| **Abandoned cart** | Reminders for orders left unpaid |
| **Activity** | Every request received from this store, including duplicates |
| **Settings** | **Update credentials** and **Disconnect** |

If you regenerate your keys in WooCommerce, open **Settings** and use **Update credentials** with the new consumer key and secret.

### Disconnect a store

Open the store, go to **Settings**, and click **Disconnect**. The webhooks are removed from your store and the automation is switched off.

## Things to know

* **Repeats are ignored.** WooCommerce sends more than one update per order. If the status hasn't changed, the customer isn't messaged twice.
* **Deliveries are verified.** Every request is checked against a signature generated when you connected.
* **Older connections.** A store connected before signatures were added stays unsigned until you disconnect and reconnect it.
* **Tracking details.** Order lookups can include tracking information when your store uses the *Shipment Tracking* plugin.

## Troubleshooting / Technical Notes

* **Connecting fails.** Check the store URL is a public address reachable from the internet (not a local or private one), and that the consumer key has **Read/Write** permission.
* **Orders don't trigger messages.** Open the store and click **Verify on WooCommerce**. If a webhook is **Missing**, disconnect and reconnect. Also check the status has a template and the store is **Connected**.
* **"Needs reconnect" or an error on the store.** The keys were changed or revoked. Use **Update credentials** in Settings.
* **A customer wasn't messaged.** The order needs a phone number, and the template must be approved.

## Related docs

* [Integrations Overview](https://wabis.mintlify.site/workspace/integrations/overview.md)
* [COD Confirmation](https://wabis.mintlify.site/workspace/integrations/cod-confirmation.md)
* [Abandoned Cart Recovery](https://wabis.mintlify.site/workspace/integrations/abandoned-cart.md)
* [Integration steps in the builder](https://wabis.mintlify.site/workspace/automation/steps/integrations.md)
* [Templates](https://wabis.mintlify.site/workspace/whatsapp/templates.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.