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

# Guia de início rápido do Upcart

> Aprenda a ativar o Upcart, habilitar os recursos principais e publicar seu cart drawer ao vivo.

Este guia mostra como configurar o Upcart com seus principais módulos, da personalização visual até a ativação na sua loja.

O Upcart substitui visualmente o cart drawer do seu tema, mas **não se integra ao cart drawer nem à página de carrinho do seu tema**. A página de carrinho do Shopify continuará acessível.

<div id="managing-modules">
  # **Gerenciando módulos**
</div>

Cada módulo do Upcart pode ser **facilmente habilitado ou desabilitado**. Basta clicar no botão **Enable/Disable** no canto superior direito para ligar ou desligar um módulo a qualquer momento. Suas alterações entram em vigor imediatamente após salvar.

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/quickstart-announcements-module-row-disabled.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=454a834d8ea953a99ba987dfdb80499a" alt="Linha do módulo Announcements marcada como Disabled com uma seta apontando para o botão Enable" width="1548" height="210" data-path="images/upcart/quickstart-announcements-module-row-disabled.png" />

<div id="cart-design">
  # Design do carrinho
</div>

Ao abrir o Cart Editor do Upcart pela primeira vez, você chega ao [módulo Design](/pt/upcart/design_module). Aqui você pode personalizar as cores base do drawer para combinar com a identidade visual da sua loja.

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/quickstart-cart-editor-design-module.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=e15c4d0893916f9200cf1884c1d0adfe" alt="Módulo Design do Cart Editor do Upcart com configurações de cores ao lado de uma pré-visualização ao vivo do cart drawer" width="600" data-path="images/upcart/quickstart-cart-editor-design-module.png" />

<div id="announcements">
  # Anúncios
</div>

Para exibir uma mensagem no carrinho ou um cronômetro de contagem regressiva, vá em **Body > [Announcements](/pt/upcart/announcements_module)**.

No canto superior direito, clique em **Enable**. O selo ao lado do nome do módulo muda de **Disabled** para **Active**.

Digite sua mensagem no campo **Announcement Text** e configure o cronômetro, se necessário.

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/quickstart-announcement-settings-timer-text.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=2a726b39f6ea92d5899e2aae2968c2d1" alt="Configurações de anúncio com cronômetro, campo de texto do anúncio e opções de cores" width="645" height="679" data-path="images/upcart/quickstart-announcement-settings-timer-text.png" />

Certifique-se de usar a variável `{TIMER}` para contagens regressivas dentro do texto do anúncio para garantir o funcionamento correto (por exemplo, "Esta oferta está disponível apenas por {TIMER}.") Evite copiar texto formatado diretamente de ferramentas de terceiros.

Quando terminar, não se esqueça de clicar em **Save** no canto superior direito.

<div id="theme-level-issues">
  #### Problemas no nível do tema
</div>

* **Conflitos de CSS ou de apps:** Verifique se propriedades CSS como `display: none;` não estão ocultando a barra de anúncios. Confira também se apps de terceiros não estão sobrescrevendo essas configurações.
* **Visibilidade do texto:** Confirme que a cor do texto da barra de anúncios contrasta com o fundo e ajuste-a nas configurações do seu tema, se necessário.

<div id="advanced-debugging-steps">
  #### Etapas avançadas de depuração
</div>

Para problemas persistentes, revise os erros do console do navegador em busca de problemas de script que afetem a barra de anúncios e desabilite temporariamente apps de terceiros para identificar conflitos.

<div id="rewards">
  # Recompensas
</div>

Para exibir uma barra de progresso que incentiva os clientes a gastar mais, habilite o módulo Rewards.

<div id="general-settings">
  ### **Configurações gerais**
</div>

Defina as cores da sua marca e a mensagem exibida depois que o último nível de recompensa é alcançado.

Escolha uma base de recompensa no cartão **Rewards calculation**, abaixo de General settings:

* **Cart total (\$)**: Acompanha o valor total do carrinho
* **Cart quantity (#)**: Acompanha a quantidade de itens

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/quickstart-rewards-module-general-settings.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=d702c06541f1304d2d2e742f79d62140" alt="Configurações gerais do módulo Rewards com cores da barra e campos de mensagem de conclusão" width="600" data-path="images/upcart/quickstart-rewards-module-general-settings.png" />

<div id="tier-settings">
  ### **Configurações de nível**
</div>

Escolha o tipo de recompensa:

* [**Shipping**](https://help.shopify.com/en/manual/fulfillment/setup/shipping-rates/flat-shipping-rates): Desbloqueia frete grátis no nível
* [**Discount**](https://help.shopify.com/en/manual/discounts/discount-types): Desbloqueia um desconto no nível
* [**Product**](/pt/upcart/set_up_a_free_product_reward_tier_in_upcart): Adiciona um produto ao carrinho

Se o progresso do nível é medido antes ou depois dos descontos é definido uma única vez para a barra inteira, com a caixa de seleção **Use pre-discounted prices for cart total** em **Rewards calculation** — não é uma propriedade do tipo de recompensa.

Defina um limite mínimo para acionar a recompensa e personalize o campo **Title before achieving tier**. Você pode criar até **quatro níveis de recompensa**.

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/quickstart-rewards-settings-reward-type.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=2085093e9f85cdd42ed163fab7d726db" alt="Configurações de nível com o seletor de tipo de recompensa, valor mínimo e campos de título do nível" width="600" data-path="images/upcart/quickstart-rewards-settings-reward-type.png" />

<Note>
  Esta captura de tela é anterior aos rótulos atuais: ela mostra a seção como "Rewards settings" e o campo como "Text before achieving". Os controles são os mesmos — agora eles aparecem como **Tier settings** e **Title before achieving tier**.
</Note>

<div id="upsells">
  # Upsells
</div>

Habilite **Use AI Recommended Upsells**, selecione o algoritmo **Related** e ative o **Smart Variant Matching** para pré-selecionar variantes de produto correspondentes com base no conteúdo do carrinho.

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/quickstart-upsells-settings-ai-recommended.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=65cddd8e07bfe9e9805ce76e43377ab3" alt="Configurações de upsells com upsells recomendados por IA, algoritmo Related e correspondência inteligente de variantes habilitados" width="600" data-path="images/upcart/quickstart-upsells-settings-ai-recommended.png" />

Personalize o título da seção e o rótulo do botão **Add**.

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/quickstart-upsell-fields-maximum-upsells.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=58ad7bd0311baa003f3ea5dae376505d" alt="Campos de upsell para o número máximo de upsells a exibir e o texto do título da seção" width="600" data-path="images/upcart/quickstart-upsell-fields-maximum-upsells.png" />

<div id="add-ons">
  # Complementos
</div>

Para mostrar um complemento com botão de alternância no rodapé, você pode habilitar uma destas opções:

<div id="shipping-protection">
  ### **Proteção de envio**
</div>

Selecione **Shipping Protection** e configure níveis de preço dinâmicos com base no valor do carrinho.\
Isso cria um produto real no seu catálogo do Shopify.

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/quickstart-shipping-protection-add-settings.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=a8432cf06443d21b7c341a0942ef7d7e" alt="Configurações do complemento Shipping Protection com título, descrição e níveis de preço" width="862" height="708" data-path="images/upcart/quickstart-shipping-protection-add-settings.png" />

<div id="product-add-on">
  ### **Complemento de produto**
</div>

Mude para a aba **Product Add-On** e selecione um produto existente para oferecer como upsell.

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/quickstart-product-add-on-energy-drink.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=d7eaf37fa102b147636bfae244fef54c" alt="Aba de complemento de produto com um produto Energy Drink selecionado e o botão Change Product" width="862" height="428" data-path="images/upcart/quickstart-product-add-on-energy-drink.png" />

<div id="activating-upcart-on-your-store">
  # Ativando o Upcart na sua loja
</div>

<div id="step-one-make-your-cart-live">
  ### Etapa um: coloque seu carrinho no ar
</div>

Depois que tudo estiver configurado, vá em **Manage All Carts** > selecione o carrinho que deseja tornar ativo > clique em **Publish**.

Depois de publicado, o carrinho passa para a seção ativa da tabela de carrinhos. Ele exibe um selo de aviso **"App embed off"** até que você habilite o app embed do Upcart no seu tema, que é a próxima etapa. Com o embed ativado, o selo se torna um selo verde **"Live"**, confirmando que o carrinho está sendo exibido na sua loja.

<Note>
  O app embed controla se o cart drawer do Upcart é exibido na sua loja. Se você tiver Descontos configurados, essas regras permanecem ativas pelo sistema de descontos do Shopify mesmo quando o app embed está desabilitado.
</Note>

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/quickstart-publish-cart-confirmation.gif?s=e8cc3d709577ee5a1ab9848afb9f6269" alt="Publicando um carrinho no Upcart com a caixa de diálogo de confirmação de publicação aberta" width="2008" height="1080" data-path="images/upcart/quickstart-publish-cart-confirmation.gif" />

<div id="step-two-enable-theme-app-embed">
  ### **Etapa dois: habilite o Theme App Embed**
</div>

Para ativar o Upcart no seu tema, vá em **Shopify Admin → Online Store → Themes → Customize → App embeds**, habilite o app embed do **Upcart** e clique em **Save**.

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/quickstart-app-embed-toggle.gif?s=9244c8509f67622ebb4e1cc2af7ecebb" alt="Habilitando o botão Upcart Cart Drawer no painel App embeds do tema do Shopify" width="1352" height="1080" data-path="images/upcart/quickstart-app-embed-toggle.gif" />

Se você encontrar qualquer problema ou tiver dificuldades de compatibilidade, fique à vontade para entrar em contato com nosso **Chat de Suporte** para obter ajuda.
