# WooCommerce

*Last updated: May 5, 2026*

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

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.

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.

<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. Go to **Workspace → Action**.
2. Click **Add Action**.
3. Select the WooCommerce integration.
4. Choose a method.
5. Give the action a clear name and description.

Available methods include:

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

#### Configure the action

You can:

* link the action to sub agents
* choose whether it runs inbound, outbound, or both
* customize parameters for your store logic

Example parameter guidance:

> order\_id: order IDs start with an `E` followed by 8 digits
>
> order\_id: order IDs are usually 10 digits long

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


---

# Agent Instructions: 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://doc.aissist.io/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.