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

# Conectar Shopify

> Conecte o Shopify para que o Agent possa provisionar uma loja Shopify, construir uma vitrine personalizada e gerenciar seus produtos e inventário dentro do Replit.

export const WistiaEmbed = ({videoId, title = "Wistia video", playerColor = "FF0000", controlsVisibleOnLoad = false}) => {
  if (!videoId) {
    return null;
  }
  const url = "https://fast.wistia.net/embed/iframe/" + videoId + "?seo=false&playerColor=" + playerColor + "&controlsVisibleOnLoad=" + controlsVisibleOnLoad;
  return <Frame>
      <iframe src={url} title={title} allow="autoplay; fullscreen" allowFullScreen></iframe>
    </Frame>;
};

<WistiaEmbed videoId="d3o9gwwtiw" title="Conecte o Shopify e construa uma vitrine com o Agent" />

Com o conector Shopify, o Agent provisiona uma loja Shopify, constrói uma vitrine personalizada integrada a ela e gerencia seus produtos e inventário, tudo em uma conversa, sem chaves de API. O Agent recomenda o Shopify sempre que você descreve a venda de um produto físico, e você só visita o Shopify para entrar no ar. Do primeiro prompt a pedidos reais leva cerca de dez minutos.

<Note>
  Para um passo a passo detalhado, siga [Construa uma vitrine Shopify](/pt/build/ecommerce-store).
</Note>

## O que você pode construir

* Vitrines com design personalizado para produtos físicos
* Lojas de merchandising e vestuário com identidade visual
* Lojas direto ao consumidor com carrinhos e checkout
* Ferramentas de catálogo e inventário respaldadas pela sua loja Shopify
* Páginas de produto que vendem um único item hero

## Exemplos

<Frame caption="Ember & Oak: uma loja de velas de soja artesanais, construída no tutorial">
  <img src="https://mintcdn.com/replit/HIUZSogml1gclscE/images/build-examples/ember-and-oak-candles.png?fit=max&auto=format&n=HIUZSogml1gclscE&q=85&s=f22b2300c152ac6555dd5edb8dfbcc1f" alt="A vitrine Ember & Oak: um design quente em creme e âmbar, com um hero de vela acesa e o título 'Light that feels like home'" width="3452" height="1978" data-path="images/build-examples/ember-and-oak-candles.png" />
</Frame>

<Frame caption="Petals & Purl: uma loja de flores de lã feitas à mão">
  <img src="https://mintcdn.com/replit/HIUZSogml1gclscE/images/build-examples/petals-and-purl.png?fit=max&auto=format&n=HIUZSogml1gclscE&q=85&s=8c704f8af42e1d0c010445cdf2eaee36" alt="A vitrine Petals & Purl: uma aconchegante loja de flores de lã feitas à mão com o título 'Blooms that last a lifetime'" width="1291" height="740" data-path="images/build-examples/petals-and-purl.png" />
</Frame>

## Como funciona

<Steps>
  <Step title="Descreva sua loja">
    Diga ao Agent o que você quer vender. Ele recomenda o Shopify para produtos físicos, mesmo que você não o mencione.

    <Frame>
      <img src="https://mintcdn.com/replit/pRYYKFsTVxh8-e6X/images/replitai/shopify/describe-your-store.png?fit=max&auto=format&n=pRYYKFsTVxh8-e6X&q=85&s=b25c3bc8ff45c1bc509a10f60be294bd" alt="A caixa de prompt do Replit com um prompt de loja de velas digitado" width="1440" height="900" data-path="images/replitai/shopify/describe-your-store.png" />
    </Frame>
  </Step>

  <Step title="O Agent provisiona uma loja">
    Uma loja de desenvolvimento é criada (cerca de dez segundos) na conta de Parceiro Shopify do Replit, o app Replit Sales Channel é instalado e a loja é conectada. Sem chaves de API; uma loja por app; protegida por senha até você reivindicá-la.

    <Frame>
      <img src="https://mintcdn.com/replit/pRYYKFsTVxh8-e6X/images/replitai/shopify/connect-shopify-store.png?fit=max&auto=format&n=pRYYKFsTVxh8-e6X&q=85&s=f10b41182863d7cb7afb5611d79bace1" alt="O Agent do Replit transferindo para o skill do Shopify, mostrando um cartão 'Connect to Shopify' com um botão Connect Shopify" width="3452" height="1984" data-path="images/replitai/shopify/connect-shopify-store.png" />
    </Frame>
  </Step>

  <Step title="O Agent constrói e gerencia">
    O Agent projeta a vitrine headless e mantém produtos, variantes, inventário, coleções e descontos.

    <Frame>
      <img src="https://mintcdn.com/replit/pRYYKFsTVxh8-e6X/images/replitai/shopify/add-product.png?fit=max&auto=format&n=pRYYKFsTVxh8-e6X&q=85&s=5f7a254e82ae13c1770632a9db916005" alt="Uma grade de produtos da vitrine mostrando produtos de velas com nomes e preços" width="3452" height="1978" data-path="images/replitai/shopify/add-product.png" />
    </Frame>
  </Step>

  <Step title="Entre no ar no Shopify">
    Reivindique a loja, escolha um plano, configure os pagamentos e lance quando estiver pronto para vender.

    <Frame>
      <img src="https://mintcdn.com/replit/pRYYKFsTVxh8-e6X/images/replitai/shopify/claim-store.png?fit=max&auto=format&n=pRYYKFsTVxh8-e6X&q=85&s=317bdb5509beb15270c694087e3279fe" alt="Tela 'Reivindique sua loja' do Replit com um botão 'Reivindicar loja'" width="3452" height="1978" data-path="images/replitai/shopify/claim-store.png" />
    </Frame>
  </Step>
</Steps>

## O que o Agent gerencia

Tudo na vitrine e no catálogo é editável por chat.

| Área                       | O que o Agent faz                                                                                                                                                                                                                                                                                                                                                                   |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Design                     | Gera um front end headless com base na sua orientação (sem tema Liquid, sem biblioteca de templates). Textos, layout, navegação, animações e páginas de produto são editáveis por chat, e você pode explorar direções com variantes do [Canvas](/references/design/canvas). É um projeto real do Replit, então você pode estendê-lo com um blog, lista de desejos ou landing pages. |
| Produtos                   | Criar, atualizar e excluir produtos e variantes. Campos: título, descrição, tipo, fornecedor, tags, SKU, preço, peso, opções (tamanho, cor), imagens e disponibilidade.                                                                                                                                                                                                             |
| Inventário                 | Definir e ajustar estoque por variante.                                                                                                                                                                                                                                                                                                                                             |
| Coleções                   | Agrupar produtos em coleções.                                                                                                                                                                                                                                                                                                                                                       |
| Descontos                  | Criar uma regra de preço mais um código resgatável.                                                                                                                                                                                                                                                                                                                                 |
| Publicação e sincronização | Novos produtos são publicados automaticamente na sua vitrine. A sincronização funciona nos dois sentidos: edições no seu painel Shopify aparecem no preview do Replit, e as alterações do Agent aparecem no seu painel Shopify.                                                                                                                                                     |

## Replit e Shopify: quem faz o quê

| O Replit cuida de                                                    | O Shopify cuida de                                               |
| -------------------------------------------------------------------- | ---------------------------------------------------------------- |
| Design e construção da vitrine                                       | Checkout hospedado                                               |
| Gerenciamento do catálogo por chat (produtos, inventário, descontos) | Sistema de registro de produtos, inventário, carrinhos e pedidos |
| Hospedagem e implantação da vitrine                                  | Pagamentos, verificação de identidade (KYC) e repasses           |
| Variantes de design no Canvas                                        | Impostos, frete e fulfillment                                    |
| Extensão do app (blog, landing pages e mais)                         | Venda multicanal                                                 |

Pedidos, reembolsos, repasses e fulfillment são gerenciados no seu painel Shopify, não pelo Agent.

## Escopo da conexão

* Disponível para todos os construtores em todos os apps, conectado na conversa, sem configuração no painel de Conectores e sem credenciais.
* Vinculado a um app: cada app recebe sua própria loja Shopify.
* A loja é uma loja de desenvolvimento própria do Replit até você reivindicá-la; seu e-mail é compartilhado com o Shopify para que você possa reivindicá-la depois.
* Você pode desinstalar o app do Replit no seu painel Shopify a qualquer momento.

## Entre no ar no Shopify

Entrar no ar acontece no Shopify, não no Replit. Peça ao Agent para iniciar o fluxo Entrar no Ar e conclua estas etapas de responsabilidade do lojista no seu painel Shopify:

* **Reivindique a loja** pelo link no chat ou pelo e-mail que o Shopify envia. O link expira após 7 dias. Reivindicar inicia um período de avaliação gratuito.
* **Escolha um plano**: um [plano pago](https://www.shopify.com/pricing) é necessário para processar pedidos reais.
* **Configure os pagamentos**: ative o [Shopify Payments](https://help.shopify.com/en/manual/payments/shopify-payments) ou outro provedor e conclua a verificação de identidade (KYC). A captura ao vivo funciona assim que a conta reivindicante conclui o KYC.
* **Configure o [frete](https://help.shopify.com/en/manual/shipping) e os [impostos](https://help.shopify.com/en/manual/taxes).**
* **Conecte um [domínio personalizado](/build/add-custom-domain)** (opcional) e remova a senha da vitrine para abrir a loja para compradores.

O checkout sempre redireciona para o checkout hospedado pelo Shopify, para que os compradores paguem no Shopify.

<Note>
  Pagamentos, verificação de identidade, impostos, frete e checagens de fraude
  permanecem no Shopify. O Replit nunca coleta dados bancários do lojista,
  CPF/CNPJ ou outras informações sensíveis.
</Note>

## Solução de problemas

<AccordionGroup>
  <Accordion title="A configuração da loja Shopify está demorando">
    O provisionamento chama várias APIs do Shopify e pode levar algum tempo. Aguarde o Agent concluir a configuração antes de pedir para construir a vitrine.
  </Accordion>

  <Accordion title="O checkout mostra uma página de senha durante o desenvolvimento">
    As lojas de desenvolvimento são protegidas por senha até você entrar no ar, então os previews de checkout podem chegar a uma página de senha. Isso é esperado, mas o carrinho continua funcionando. Remova a senha no Shopify apenas quando lançar.
  </Accordion>

  <Accordion title="O checkout não conclui um pagamento real">
    A captura ao vivo requer que a conta Shopify reivindicante conclua a configuração de pagamentos e o KYC. Até então, o checkout redireciona para o Shopify, mas não consegue capturar um pagamento. Conclua o KYC ou use uma conta que já tenha os pagamentos configurados.
  </Accordion>

  <Accordion title="O Agent diz que o Shopify não está conectado para este app">
    Cada loja está vinculada a um app. Se você conectou o Shopify em um app diferente, peça ao Agent para configurar uma loja Shopify para o app atual.
  </Accordion>

  <Accordion title="Os produtos não aparecem na vitrine">
    Um produto só fica visível quando está ativo e publicado. O Agent publica automaticamente os produtos que cria; se um estiver faltando, peça ao Agent para publicá-lo e atualize o preview.
  </Accordion>

  <Accordion title="A conexão precisa ser reconectada após a transferência">
    Após reivindicar ou transferir a loja, o Shopify pode solicitar que você reautorize a conexão. Peça ao Agent para reconectar o Shopify e ele restaura o acesso sem perder sua loja.
  </Accordion>
</AccordionGroup>

## Documentação relacionada

* [Construa uma vitrine Shopify](/pt/build/ecommerce-store): Guia passo a passo do prompt a uma vitrine publicada
* [Adicionar um domínio personalizado](/build/add-custom-domain): Dê à sua vitrine uma URL com sua marca
* [Integrações do Agent](/pt/references/integrations/overview): Integrações gerenciadas pelo Replit e serviços do Agent
* [Gerenciando seus conectores](/replitai/managing-connectors): Configure e gerencie conectores
* [Central de Ajuda do Shopify](https://help.shopify.com/): Configuração da loja, pagamentos e gerenciamento de conta