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

# WooCommerce

> Connect your WooCommerce store with Jelou.

## Connect your store

Connecting WooCommerce is a simple OAuth process: all you need is your **store domain**. Jelou creates the credentials for you when you authorize the connection from WooCommerce.

> [!TIP]
>
> When you connect WooCommerce, the **Jelou Shop** MCP is included automatically.

## Where to start the connection

You can start the integration from two places. In both cases the authorization flow is the same.

### Using the Jelou Agent

Configure the connection directly in the Jelou Agent in Brain Studio.

![Integrate WooCommerce using the Jelou Agent in Brain Studio](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/marketplace/e-commerce/woocommerce-setup-agent.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=c8d64c44cb6b1929507915056b760364)

### Via the Marketplace

Activate the integration from the Jelou Marketplace.

![Integrate WooCommerce via the Marketplace](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/marketplace/e-commerce/woocommerce-setup-marketplace.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=e34c9047af2b633cfde0c416d17c5f9e)

## Authorize the connection

**1. Enter your store domain**

In the **Store URL** field, type your store domain (e.g. `https://my-store.com`) and click **Install**.

![API credentials modal with the Store URL field](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/marketplace/e-commerce/woocommerce-oauth-domain.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=2720ac197cfb2793514280be4fe55206)

**2. Sign in to WooCommerce**

You'll be redirected to your store. Sign in with your WordPress username and password to authorize Jelou.

![WooCommerce sign-in screen to connect with Jelou](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/marketplace/e-commerce/woocommerce-oauth-login.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=aca8f3b85a1b4c89a2244700bbb68f30)

**3. Approve access**

WooCommerce will show the **Read/Write** permissions Jelou needs (create webhooks; view and manage coupons, customers, orders and sales reports, and products). Click **Approve**.

![Read/Write permissions approval screen for Jelou](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/marketplace/e-commerce/woocommerce-oauth-approve.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=09678cc4817d3c06d148e71d79af7c31)

**4. Successful connection**

You'll return to Jelou with confirmation that your store was connected successfully. You can now start syncing products and orders.

![Successful connection screen between WooCommerce and Jelou](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/marketplace/e-commerce/woocommerce-oauth-success.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=569620d169254e94817f835e0874abe1)

## Native checkout in your store

If you prefer the payment to be completed in your own WooCommerce store instead of the Jelou payment flow, enable `use_external_checkout: true` when running the `get_and_clear_cart` tool. Jelou creates the order via the WooCommerce API and returns the link to your store's checkout in `checkout_url` so the user can complete the payment.

![Native WooCommerce checkout opened from the link generated by Jelou](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/marketplace/e-commerce/external-woocommerce.jpeg?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=29baebee7c9fcbd9c44fb87e2da04c22)

> [accordion] View example response
>
> ```json theme={null}
> {
>   "success": true,
>   "data": {
>     "items": [
>       { "product_name": "Light blue t-shirt", "sku": "vj6ybab6e1", "quantity": 2, "price": "25.00", "discount_value": 50, "tax_rate": 0 }
>     ],
>     "total": 50,
>     "subTotal": 50,
>     "tax": 0,
>     "tax_value": 0,
>     "cart_id": 12345,
>     "checkout_url": "https://my-store.com/checkout/order-pay/42?key=wc_abc"
>   }
> }
> ```

## Next step

Once your store is connected, choose how you want your customers to interact with the products:

> [card] [WebView interaction](https://docs.jelou.ai/en/guides/integrations/e-commerce/webview.md)
>
> Send catalogs and carts as interactive webviews inside WhatsApp

> [card] [Conversational interaction](https://docs.jelou.ai/en/guides/integrations/e-commerce/conversational.md)
>
> The AI agent describes products and manages the cart directly in the conversation


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