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

## Access credentials

To connect your WooCommerce store you need the following credentials:

| Credential         | Example                                       |
| ------------------ | --------------------------------------------- |
| WooCommerce domain | `https://my-store.com`                        |
| Consumer key       | `ck_xxxx9042e49d750f683089d3673c4037145fxxxx` |
| Consumer secret    | `cs_xxxxb0e7e5aff9900be8a0551e56d65101abxxxx` |

### How to generate the credentials

<Steps>
  <Step title="Open your WordPress dashboard">
    Sign in to your WordPress site's admin panel.
  </Step>

  <Step title="Go to WooCommerce > Settings">
    From the side menu, navigate to **WooCommerce > Settings**.
  </Step>

  <Step title="Open the REST API keys">
    Click the **Advanced** tab and then **REST API**.
  </Step>

  <Step title="Add a new key">
    Click **Add key**.
  </Step>

  <Step title="Fill in the details">
    * **Description:** a name to identify the key (e.g. "Jelou App").
    * **User:** select an administrator user.
    * **Permissions:** choose **Read/Write**.
  </Step>

  <Step title="Generate the API key">
    Click **Generate API key**.
  </Step>

  <Step title="Copy and save the credentials">
    Store the `Consumer key` and `Consumer secret` in a safe place.

    <Warning>
      You won't be able to see the secret key again after leaving this screen.
    </Warning>
  </Step>
</Steps>

<Tip>
  When you connect WooCommerce, the **Jelou Shop** MCP is included automatically.
</Tip>

## Integration

You can integrate your WooCommerce store with Jelou in two ways: **using the Jelou Agent** (in Brain Studio) or **via the Marketplace**. In both cases you will need your store domain and the `Consumer key` and `Consumer secret` generated in the previous step.

### Using the Jelou Agent

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

<Frame>
  <img src="https://mintcdn.com/jelouai/KOhq3oKHKW_8vZ0w/assets/images/marketplace/e-commerce/woocommerce-setup-agent.png?fit=max&auto=format&n=KOhq3oKHKW_8vZ0w&q=85&s=711490bf1a3a143bf9cbad8b9aac4ce9" alt="Integrate WooCommerce using the Jelou Agent in Brain Studio" width="1300" height="648" data-path="assets/images/marketplace/e-commerce/woocommerce-setup-agent.png" />
</Frame>

### Via the Marketplace

Activate the integration from the Jelou Marketplace.

<Frame>
  <img src="https://mintcdn.com/jelouai/KOhq3oKHKW_8vZ0w/assets/images/marketplace/e-commerce/woocommerce-setup-marketplace.png?fit=max&auto=format&n=KOhq3oKHKW_8vZ0w&q=85&s=862d9d44ee49743d6263c0a81e2dcd06" alt="Integrate WooCommerce via the Marketplace" width="1160" height="599" data-path="assets/images/marketplace/e-commerce/woocommerce-setup-marketplace.png" />
</Frame>

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

<Frame>
  <img src="https://mintcdn.com/jelouai/hBKJUHL4aHZZv5xR/assets/images/marketplace/e-commerce/external-woocommerce.jpeg?fit=max&auto=format&n=hBKJUHL4aHZZv5xR&q=85&s=93cc12253c96328e221d2de5ce302cbf" alt="Native WooCommerce checkout opened from the link generated by Jelou" style={{ maxWidth: "250px", width: "100%", margin: "0 auto", display: "block" }} width="859" height="1600" data-path="assets/images/marketplace/e-commerce/external-woocommerce.jpeg" />
</Frame>

<Accordion title="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"
    }
  }
  ```
</Accordion>

## Next step

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

<CardGroup cols={2}>
  <Card title="WebView interaction" icon="window" href="/en/guides/integraciones/e-commerce/webview">
    Send catalogs and carts as interactive webviews inside WhatsApp
  </Card>

  <Card title="Conversational interaction" icon="comments" href="/en/guides/integraciones/e-commerce/conversacional">
    The AI agent describes products and manages the cart directly in the conversation
  </Card>
</CardGroup>
