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

> Conecte sua loja WooCommerce com o Jelou.

## Credenciais de acesso

Para conectar sua loja WooCommerce você precisa das seguintes credenciais:

| Credencial          | Exemplo                                       |
| ------------------- | --------------------------------------------- |
| Domínio WooCommerce | `https://minha-loja.com`                      |
| Consumer key        | `ck_xxxx9042e49d750f683089d3673c4037145fxxxx` |
| Consumer secret     | `cs_xxxxb0e7e5aff9900be8a0551e56d65101abxxxx` |

### Como gerar as credenciais

<Steps>
  <Step title="Abra o painel do WordPress">
    Acesse o painel de administração do seu site WordPress.
  </Step>

  <Step title="Vá em WooCommerce > Configurações">
    No menu lateral, acesse **WooCommerce > Configurações**.
  </Step>

  <Step title="Abra as chaves da API REST">
    Clique na aba **Avançado** e depois em **Chaves da API REST**.
  </Step>

  <Step title="Adicione uma nova chave">
    Clique em **Adicionar chave**.
  </Step>

  <Step title="Preencha os detalhes">
    * **Descrição:** um nome para identificar a chave (ex.: "App Jelou").
    * **Usuário:** selecione um usuário administrador.
    * **Permissões:** escolha **Leitura/Escrita**.
  </Step>

  <Step title="Gere a chave de API">
    Clique em **Gerar chave de API**.
  </Step>

  <Step title="Copie e guarde as credenciais">
    Guarde o `Consumer key` e o `Consumer secret` em um lugar seguro.

    <Warning>
      Você não poderá ver a chave secreta novamente depois de sair desta tela.
    </Warning>
  </Step>
</Steps>

<Tip>
  Quando você conecta o WooCommerce, o MCP do **Jelou Shop** é incluído automaticamente.
</Tip>

## Integração

Você pode integrar sua loja WooCommerce ao Jelou de duas formas: **pelo Jelou Agent** (no Brain Studio) ou **pelo Marketplace**. Em ambos os casos você precisará do domínio da sua loja, do `Consumer key` e do `Consumer secret` gerados no passo anterior.

### Pelo Jelou Agent

Configure a conexão diretamente no Jelou Agent no 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 pelo Jelou Agent no Brain Studio" width="1300" height="648" data-path="assets/images/marketplace/e-commerce/woocommerce-setup-agent.png" />
</Frame>

### Pelo Marketplace

Ative a integração pelo Marketplace do Jelou.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/jelouai/assets/images/marketplace/e-commerce/woocommerce-setup-marketplacewoocommerce.png" alt="Integrar WooCommerce pelo Marketplace" />
</Frame>

## Checkout nativo na sua loja

Se você prefere que o pagamento seja concluído na sua própria loja WooCommerce em vez do fluxo de pagamento do Jelou, ative `use_external_checkout: true` ao executar a ferramenta `get_and_clear_cart`. O Jelou cria o pedido pela API do WooCommerce e retorna em `checkout_url` o link para o checkout da sua loja para que o usuário conclua o pagamento.

<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 do WooCommerce aberto pelo link gerado pelo 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 exemplo de resposta">
  ```json theme={null}
  {
    "success": true,
    "data": {
      "items": [
        { "product_name": "Camiseta azul claro", "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://minha-loja.com/checkout/order-pay/42?key=wc_abc"
    }
  }
  ```
</Accordion>

## Próximo passo

Após conectar sua loja, escolha como você quer que seus clientes interajam com os produtos:

<CardGroup cols={2}>
  <Card title="Interação por WebView" icon="window" href="/pt/guias/integracoes/e-commerce/webview">
    Envie catálogos e carrinhos como webviews interativos dentro do WhatsApp
  </Card>

  <Card title="Interação conversacional" icon="comments" href="/pt/guias/integracoes/e-commerce/conversacional">
    O agente de IA descreve os produtos e gerencia o carrinho diretamente na conversa
  </Card>
</CardGroup>