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

# WooCommerce

*Last updated: May 15, 2026*

Connect WooCommerce to let Aissist read store data and run commerce actions.

WooCommerce is the integration.

Actions use WooCommerce during conversations.

With WooCommerce, Aissist can work with:

* customers and orders
* products and inventory
* refunds and subscriptions
* actions like address updates and order cancellation

<details>

<summary>Create the WooCommerce integration</summary>

#### Step 1: create API credentials

1. Log in to your WooCommerce dashboard.
2. Go to **Settings → Advanced → REST API**.
3. Click **Add Key**.
4. Save the **Consumer Key** and **Consumer Secret**.

{% hint style="info" %}
Save the key and secret when you create them. WooCommerce may not show them again later.
{% endhint %}

<figure><img src="https://301624521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyKHM836KGDAfAWvw6XL6%2Fuploads%2F5ZwKichKzs7n1RjbNrHw%2Fwoocommerce_key.png?alt=media&amp;token=9f70dd9b-096d-4083-a71a-249eed8ceaef" alt=""><figcaption><p>Create Consumer Key and Consumer Secret</p></figcaption></figure>

#### Step 2: add the integration in Aissist

1. Go to **Workspace → Integrations**.
2. Click **Add Integration**.
3. Choose **WooCommerce**.
4. Enter:
   * a name for the integration
   * the WooCommerce API URL
   * the Consumer Key
   * the Consumer Secret

Example:

* Name: My WooCommerce Store
* API URL: `https://yourstore.com/wp-json/wc/v3`
* Consumer Key: paste your key
* Consumer Secret: paste your secret

<figure><img src="https://301624521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyKHM836KGDAfAWvw6XL6%2Fuploads%2FLY8eISFwuq4T2S3JSHHE%2FScreenshot%202025-04-26%20at%2012.51.10%20PM.png?alt=media&amp;token=2714f4ab-aa83-47bb-8588-2bcccf13bf33" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Default actions</summary>

The WooCommerce integration includes default actions for common workflows.

Use them when the built-in WooCommerce methods already match your workflow.

You can choose whether each action runs:

* at the start of a session
* during an interaction
* in both places

Each default action includes predefined descriptions and parameters.

Create custom actions only when you need store-specific logic.

<figure><img src="https://301624521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyKHM836KGDAfAWvw6XL6%2Fuploads%2FwDDPpoGHxFz2LXOUe4q6%2FScreenshot%202025-04-26%20at%2012.54.00%20PM.png?alt=media&amp;token=0a726680-18ca-4480-8f18-04ec700bf534" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Custom actions</summary>

You can also create custom WooCommerce actions.

If you do, turn off overlapping default actions to avoid conflicts.

#### Create a custom action

1. Select the integration then go to **Actions**.
2. Click **Add Action**.
3. Choose a method.
4. Give the action a clear name and description.

Available methods include:

* `getOrder`
* `getCustomer`
* `getCustomerOrders`
* `getCustomerSubscription`
* `cancelOrder`
* `updateOrderAddress`

#### Configure the action

You can:

* choose whether it runs inbound, outbound
* customize parameters for your store logic

Use parameter descriptions that match your store rules.

Example store-specific guidance:

> order\_id: order IDs start with an `E` followed by 8 digits
>
> subscription\_status: use values like `active`, `on-hold`, or `cancelled`

You can also add instructions for how Aissist should summarize large action responses.

<figure><img src="https://301624521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyKHM836KGDAfAWvw6XL6%2Fuploads%2Fjvlr5WXyrlHPRC1cTqvK%2Fscreencapture-console-aissist-io-workspace-actions-4e696014-c68d-41cf-8ce7-fa9857365e36-2025-04-26-13_00_07.png?alt=media&amp;token=0754eb19-e95c-4916-ae80-f3feccf3ff7d" alt=""><figcaption><p>WooCommerce integration</p></figcaption></figure>

</details>

### Next step

After setup, test your WooCommerce actions in [Action Debugger](/integrations/action-debugger.md).