> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xpressbot.org/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.

\[SCREENSHOT: woocommerce-provider-page — The WooCommerce page showing the Connect button and the list of connected stores]

## 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](/workspace/integrations/cod-confirmation)
* Remind customers who left an order unpaid — see [Abandoned Cart Recovery](/workspace/integrations/abandoned-cart)
* Look up and update orders in your own flows with the [WooCommerce order steps](/workspace/automation/steps/integrations)

## How to use it

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

### Connect the store

<Steps>
  <Step title="Open the WooCommerce page">
    Go to **Integrations** and click **WooCommerce**, then **Connect** (or **Add another store**).
  </Step>

  <Step title="Enter your store details">
    Fill in:

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

  <Step title="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.
  </Step>

  <Step title="Set up and activate">
    Click **Set up and activate**. A signed webhook is added to your store automatically, and the automation is created.
  </Step>
</Steps>

\[SCREENSHOT: woocommerce-connect-page — The Connect WooCommerce page with store URL, consumer key and secret, and the status-to-template mapping]

<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.
</Note>

### 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](/workspace/integrations/overview)
* [COD Confirmation](/workspace/integrations/cod-confirmation)
* [Abandoned Cart Recovery](/workspace/integrations/abandoned-cart)
* [Integration steps in the builder](/workspace/automation/steps/integrations)
* [Templates](/workspace/whatsapp/templates)