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

# Shopify

> Conecte sua loja Shopify com o Jelou.

<Frame>
  <img src="https://mintcdn.com/jelouai/fqlUMrdB775NeopS/assets/images/marketplace/e-commerce/shopify-jelou-shop-pt.png?fit=max&auto=format&n=fqlUMrdB775NeopS&q=85&s=3f9172395d51b3571476ab664bcf6694" alt="Conexão Shopify com Jelou Shop no Brain Studio" width="2704" height="1298" data-path="assets/images/marketplace/e-commerce/shopify-jelou-shop-pt.png" />
</Frame>

A integração do Shopify usa **OAuth 2.0**. Você autoriza o Jelou pela sua conta Shopify em poucos passos.

<Tip>
  Quando você conecta o Shopify, o MCP do **Jelou Shop** é incluído automaticamente. Você pode iniciar a conexão pelo **Jelou Agent** (no Brain Studio) ou pelo **Marketplace**.
</Tip>

## Conecte sua loja

<Steps>
  <Step title="Abra o Shopify no Marketplace">
    No **Marketplace** do Jelou, busque e selecione **Shopify** no catálogo.

    <Frame>
      <img src="https://mintcdn.com/jelouai/ydB9wMhDYN6iEY6P/assets/images/marketplace/e-commerce/shopify/marketplace-jelou.png?fit=max&auto=format&n=ydB9wMhDYN6iEY6P&q=85&s=8d686b9cf56829d4297d442f6b9749c7" alt="Shopify no catálogo do Marketplace do Jelou" width="1394" height="703" data-path="assets/images/marketplace/e-commerce/shopify/marketplace-jelou.png" />
    </Frame>
  </Step>

  <Step title="Clique em Conectar">
    Na página da integração, clique em **Conectar**.

    <Frame>
      <img src="https://mintcdn.com/jelouai/ydB9wMhDYN6iEY6P/assets/images/marketplace/e-commerce/shopify/integracion-shopify.png?fit=max&auto=format&n=ydB9wMhDYN6iEY6P&q=85&s=9313f22c12e9b5bf390f7c3567e18420" alt="Página da integração do Shopify com o botão Conectar" width="1118" height="652" data-path="assets/images/marketplace/e-commerce/shopify/integracion-shopify.png" />
    </Frame>
  </Step>

  <Step title="Selecione sua loja no Shopify">
    Faça login no Shopify e escolha a loja que deseja conectar.

    <Frame>
      <img src="https://mintcdn.com/jelouai/ydB9wMhDYN6iEY6P/assets/images/marketplace/e-commerce/shopify/1.png?fit=max&auto=format&n=ydB9wMhDYN6iEY6P&q=85&s=e4d0d2ea8851f2266549540eb7bb357a" alt="Seleção de loja no Shopify" width="1175" height="701" data-path="assets/images/marketplace/e-commerce/shopify/1.png" />
    </Frame>
  </Step>

  <Step title="Autorize o app Jelou Commerce">
    Revise as permissões solicitadas e clique em **Install** para instalar o app **Jelou Commerce** na sua loja.

    <Frame>
      <img src="https://mintcdn.com/jelouai/ydB9wMhDYN6iEY6P/assets/images/marketplace/e-commerce/shopify/2.png?fit=max&auto=format&n=ydB9wMhDYN6iEY6P&q=85&s=8309d2dd9861244a25794d5b98a7207a" alt="Tela de instalação do app Jelou Commerce no Shopify" width="1173" height="582" data-path="assets/images/marketplace/e-commerce/shopify/2.png" />
    </Frame>
  </Step>

  <Step title="Confirme a autorização">
    Você verá a mensagem **Autorização bem-sucedida!**. Feche a janela e volte ao Jelou.

    <Frame>
      <img src="https://mintcdn.com/jelouai/ydB9wMhDYN6iEY6P/assets/images/marketplace/e-commerce/shopify/3.png?fit=max&auto=format&n=ydB9wMhDYN6iEY6P&q=85&s=789c859fcad62232279ae3e8c4f74e49" alt="Mensagem de autorização bem-sucedida do Jelou" width="1168" height="698" data-path="assets/images/marketplace/e-commerce/shopify/3.png" />
    </Frame>
  </Step>
</Steps>

Após conectar, a página da integração mostra a **conta conectada**. A partir dali você também pode **remover a integração** quando precisar.

<Frame>
  <img src="https://mintcdn.com/jelouai/ydB9wMhDYN6iEY6P/assets/images/marketplace/e-commerce/shopify/4.png?fit=max&auto=format&n=ydB9wMhDYN6iEY6P&q=85&s=e2126e6d7cc4f41fc5778926ee5b3bb4" alt="Integração do Shopify conectada mostrando a conta vinculada" width="1118" height="653" data-path="assets/images/marketplace/e-commerce/shopify/4.png" />
</Frame>

## Checkout nativo na sua loja

Se você prefere que o pagamento seja concluído na sua própria loja Shopify em vez do fluxo de pagamento do Jelou, ative `use_external_checkout: true` ao executar a ferramenta `get_and_clear_cart`. O Jelou gera um permalink do carrinho do Shopify e o retorna em `checkout_url` para que o usuário finalize a compra no checkout oficial da sua loja.

<Frame>
  <img src="https://mintcdn.com/jelouai/hBKJUHL4aHZZv5xR/assets/images/marketplace/e-commerce/external-shopify.jpeg?fit=max&auto=format&n=hBKJUHL4aHZZv5xR&q=85&s=925264e6e393b7bb8e41e84449fcfa1b" alt="Checkout nativo do Shopify aberto pelo link gerado pelo Jelou" style={{ maxWidth: "250px", width: "100%", margin: "0 auto", display: "block" }} width="717" height="1438" data-path="assets/images/marketplace/e-commerce/external-shopify.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": "35.00", "discount_value": 70, "tax_rate": 0 }
      ],
      "total": 70,
      "subTotal": 70,
      "tax": 0,
      "tax_value": 0,
      "cart_id": 12345,
      "checkout_url": "https://minha-loja.myshopify.com/cart/456:2?attributes%5Bjelou_cart_id%5D=12345"
    }
  }
  ```
</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>