> 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="/files/o9eUhGJNu47pEA7NQcwn" 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="/files/4gynaMHZGV4YNjemBg8h" 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="/files/ycpvy6CfT7S1WlxZJ67g" 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="/files/3QcXkXVaWrZKHo542h6d" alt=""><figcaption><p>WooCommerce integration</p></figcaption></figure>

</details>

### Next step

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