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

> Conecta tu tienda de WooCommerce con Jelou.

## Credenciales de acceso

Para conectar tu tienda de WooCommerce necesitas las siguientes credenciales:

| Credencial         | Ejemplo                                       |
| ------------------ | --------------------------------------------- |
| WooCommerce domain | `https://mi-tienda.com`                       |
| Consumer key       | `ck_xxxx9042e49d750f683089d3673c4037145fxxxx` |
| Consumer secret    | `cs_xxxxb0e7e5aff9900be8a0551e56d65101abxxxx` |

### Cómo generar las credenciales

<Steps>
  <Step title="Abre tu escritorio de WordPress">
    Ingresa al panel de administración de tu sitio de WordPress.
  </Step>

  <Step title="Ve a WooCommerce > Ajustes">
    Desde el menú lateral, dirígete a **WooCommerce > Ajustes**.
  </Step>

  <Step title="Abre las claves de la API REST">
    Haz clic en la pestaña **Avanzado** y luego en **Claves de la API REST**.
  </Step>

  <Step title="Añade una nueva clave">
    Haz clic en **Añadir clave**.
  </Step>

  <Step title="Rellena los detalles">
    * **Descripción:** nombre para identificar la clave (ej. "App Jelou").
    * **Usuario:** selecciona un usuario administrador.
    * **Permisos:** elige **Lectura/Escritura**.
  </Step>

  <Step title="Genera la clave de API">
    Haz clic en **Generar clave de API**.
  </Step>

  <Step title="Copia y guarda las credenciales">
    Guarda el `Consumer key` y el `Consumer secret` en un lugar seguro.

    <Warning>
      No podrás volver a ver la clave secreta después de cerrar esta pantalla.
    </Warning>
  </Step>
</Steps>

<Tip>
  Al conectar WooCommerce, el MCP de **Jelou Shop** se incluye automáticamente.
</Tip>

## Integración

Puedes integrar tu tienda de WooCommerce a Jelou de dos formas: **desde el Jelou Agent** (en Brain Studio) o **desde el Marketplace**. En ambos casos necesitarás el dominio de tu tienda, el `Consumer key` y el `Consumer secret` generados en el paso anterior.

### Desde el Jelou Agent

Configura la conexión directamente en el Jelou Agent en 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="Integrar WooCommerce desde el Jelou Agent en Brain Studio" width="1300" height="648" data-path="assets/images/marketplace/e-commerce/woocommerce-setup-agent.png" />
</Frame>

### Desde el Marketplace

Activa la integración desde el Marketplace de Jelou.

<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="Integrar WooCommerce desde el Marketplace" width="1160" height="599" data-path="assets/images/marketplace/e-commerce/woocommerce-setup-marketplace.png" />
</Frame>

## Checkout nativo en tu tienda

Si prefieres que el pago se complete en tu propia tienda de WooCommerce en lugar del flujo de pago de Jelou, activa `use_external_checkout: true` al ejecutar la herramienta `get_and_clear_cart`. Jelou crea el pedido a través de la API de WooCommerce y devuelve en `checkout_url` el enlace al checkout de tu tienda para que el usuario complete el pago.

<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="Checkout nativo de WooCommerce abierto desde el enlace generado por 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="Ver ejemplo de respuesta">
  ```json theme={null}
  {
    "success": true,
    "data": {
      "items": [
        { "product_name": "Camiseta celeste", "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://mi-tienda.com/checkout/order-pay/42?key=wc_abc"
    }
  }
  ```
</Accordion>

## Siguiente paso

Una vez conectada tu tienda, elige cómo quieres que tus clientes interactúen con los productos:

<CardGroup cols={2}>
  <Card title="Interacción por WebView" icon="window" href="/guides/integraciones/e-commerce/webview">
    Envía catálogos y carritos como webviews interactivas dentro de WhatsApp
  </Card>

  <Card title="Interacción conversacional" icon="comments" href="/guides/integraciones/e-commerce/conversacional">
    El agente de IA describe productos y gestiona el carrito directamente en la conversación
  </Card>
</CardGroup>
