---
lastModified: 2026-10-19
title: Adicionar plugins da loja
description: Instale recursos prontos para a loja, como a lista de desejos e o Klaviyo, em Apps e gerencie-os em Operações da loja.
seo:
  description: "Instale recursos prontos para a loja, como a lista de desejos e o Klaviyo, em Apps e gerencie-os em Operações da loja. Projeto → Apps → Plugins da loja."
---

Os **Plugins da loja** adicionam recursos prontos à sua loja. A **Lista de desejos** permite que os clientes salvem produtos para voltar a eles depois. O **Klaviyo** envia seus clientes e pedidos para a sua conta do Klaviyo, para marketing por e-mail e SMS. Instalar um plugin adiciona o recurso ao backend da sua loja. Depois, **Adicionar à loja virtual** pede ao Runner que o coloque no design da sua loja, e **Gerenciar** abre as páginas do próprio plugin em **Operações da loja → Plugins**.

## Antes de começar

**Caminho de entrada:** **Projeto → Apps → Plugins da loja**

- A seção lista os plugins que o Runner oferece. Um cartão que mostra **É necessário atualizar o backend** precisa de um backend da loja mais recente antes de poder ser instalado.
- A instalação reinicia o backend da sua loja, então a loja fica indisponível por um momento. As migrações dos plugins podem levar mais tempo em lojas maiores.
- Só uma alteração no backend é executada por vez. Enquanto um plugin é instalado ou removido, os outros cartões mostram **Bloqueado por outra alteração no backend**.
- Os clientes só veem o recurso de um plugin depois que o Runner o adiciona à sua loja virtual e você publica a loja.

### Vídeo: instale a lista de desejos e veja o que os clientes salvam

<video controls playsInline preload="metadata" poster="https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgedkaq5Yt82iKld0T5W2hAarkBbqj4mrolQPq" aria-label="Instalando a lista de desejos, adicionando-a à loja virtual, salvando gravuras como cliente e vendo-as em Operações da loja" style={{ width: '100%', aspectRatio: '1440 / 976' }}>
  <source src="https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgKMO17ZlNlrZ2ZIPkE1IAL6YaKHtMu8z0bFgO" type="video/mp4" />
  <a href="https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgKMO17ZlNlrZ2ZIPkE1IAL6YaKHtMu8z0bFgO">Abrir a gravação</a>
</video>

Esta gravação, com interface, narração e legendas em inglês, instala a **Lista de desejos** em **Plugins da loja**, seleciona **Adicionar à loja virtual** e publica a loja depois que o Runner informa o que adicionou. Em seguida, uma cliente cria uma conta, salva duas gravuras e abre a página da lista de desejos. Depois, **Gerenciar** abre a **Wishlist** em **Operações da loja → Plugins**, onde **Wishlists** mostra as gravuras que os clientes mais salvam e **Product widgets** mostra em quantas listas de desejos uma gravura está. Nesta loja, a instalação levou cerca de 8 minutos e o trabalho do Runner na loja virtual cerca de 7; os dois tempos dependem da sua loja. A gravação não conecta pagamentos nem faz pedidos.

## Controles dos plugins da loja

| Controle ou estado | Por que é útil | O que acontece a seguir |
| --- | --- | --- |
| **Instalar** | Adiciona o plugin ao backend da sua loja. | O Runner pede sua confirmação, porque a loja reinicia por um momento. |
| **Continuar** | Confirma a instalação ou a remoção. | O cartão mostra **Instalando** ou **Removendo** até a alteração terminar. |
| **Instalando** ou **Removendo** | Mostra que a alteração no backend está em andamento. | Aguarde. O cartão muda quando o Runner termina; você pode sair da página. |
| **Instalado** | Confirma que o plugin está funcionando no backend da sua loja. | Plugins com uma parte para a loja virtual mostram **Adicionar à loja virtual**. |
| **Adicionar à loja virtual** | Coloca o recurso do plugin no design da sua loja. | O Runner abre um chat com o pedido e faz a alteração na sua loja virtual. |
| **Gerenciar** | Abre as páginas do próprio plugin. | O Runner abre a aba do plugin em **Operações da loja → Plugins**. |
| **Remover** | Tira o plugin do backend da sua loja. | O Runner pede sua confirmação e depois mostra **Removendo**. |
| **É necessário atualizar o backend** | Mostra que o backend da sua loja é antigo demais para este plugin. | O plugin só pode ser instalado depois que o backend da loja for atualizado. |
| **Bloqueado por outra alteração no backend** | Mostra que outra alteração de plugin está em andamento. | Tente de novo quando essa alteração terminar. |
| **A última alteração falhou** | Mostra que a última instalação ou remoção não terminou. | Leia a mensagem no cartão e tente de novo ou fale com o suporte. |

## Adicione a lista de desejos à sua loja

1. Abra **Projeto → Apps** e encontre **Plugins da loja**.
2. Em **Lista de desejos**, selecione **Instalar** e depois **Continuar**.
3. Aguarde até o cartão mostrar **Instalado** e **Adicionar à loja virtual**. Isso leva alguns minutos.
4. Selecione **Adicionar à loja virtual**. O Runner abre um chat que pede para adicionar o plugin e depois adiciona botões de salvar nos cartões e nas páginas de produto, uma página de lista de desejos e um contador no cabeçalho.
5. Quando o Runner terminar, confira a prévia: cada produto mostra um coração.
6. Selecione **Publicar** e confirme, para que os clientes tenham a lista de desejos na sua loja publicada.

## O que os clientes veem

- Um coração em cada cartão e página de produto. Selecionar salva o produto; selecionar de novo remove.
- Um coração no cabeçalho com o número de produtos salvos. Ele abre a página da lista de desejos, com todos os produtos salvos.
- Salvar sem conta vem desativado, então os clientes entram na conta para salvar. Quem não entrou vê **Entre na sua conta para salvar itens na sua lista de desejos.** e vai para a página da conta; depois de entrar, a lista de desejos fica na conta e aparece em qualquer dispositivo.
- Para permitir que os clientes salvem sem conta, abra **Operações da loja → Plugins → Wishlist**, selecione **Wishlists** e depois **Settings**, e ative **Allow guest wishlists**.

## Veja o que os clientes salvam

**Caminho de entrada:** **Operações da loja → Plugins → Wishlist**, ou **Gerenciar** no cartão **Lista de desejos** em **Apps → Plugins da loja**

- **Wishlists** mostra a atividade das listas de desejos no período que você escolher, com os produtos que os clientes mais salvam. A aba **Settings** tem **Allow guest wishlists**.
- **Product widgets** mostra em quantas listas de desejos um produto está. Escolha o produto, e o painel **Wishlist** mostra a contagem.

## Conecte o Klaviyo

O **Klaviyo** recebe o que os clientes fazem na sua loja publicada e os pedidos que eles fazem. Seus fluxos e campanhas do Klaviyo podem então fazer o acompanhamento por e-mail ou SMS. O Klaviyo usa a sua própria conta do Klaviyo.

O Klaviyo ainda não está ativo em todos os espaços de trabalho. Se **Plugins da loja** não mostrar o **Klaviyo**, ele ainda não está disponível para você.

### Vídeo: conecte o Klaviyo e veja seus clientes no Klaviyo

<video controls playsInline preload="metadata" poster="https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgFXqEdHByel9bMuRDBPQ92L7PfoNwMZrPtMjI" aria-label="Conectando o Klaviyo em Apps e vendo a atividade e o pedido de uma cliente no Klaviyo" style={{ width: '100%', aspectRatio: '1440 / 976' }}>
  <source src="https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgsmh5qb2ukCMNGBahR48Ldn68olrMHVI3PoUv" type="video/mp4" />
  <a href="https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgsmh5qb2ukCMNGBahR48Ldn68olrMHVI3PoUv">Abrir a gravação</a>
</video>

Esta gravação, com interface, narração e legendas em inglês, instala o **Klaviyo** em **Plugins da loja** e seleciona **Gerenciar** para abrir a aba dele em **Operações da loja → Plugins**. Em seguida, uma cliente cria uma conta, adiciona uma gravura ao carrinho e começa o checkout. No Klaviyo, o perfil da cliente mostra essas etapas, o pedido com os produtos, e a transportadora e o código de rastreamento do envio. A página de autorização do Klaviyo, o pagamento e o envio não aparecem na gravação.

1. Abra **Projeto → Apps** e encontre o **Klaviyo** em **Plugins da loja**.
2. Selecione **Instalar**. O Klaviyo abre e pede que você entre na sua conta e dê ao Runner acesso a ela.
3. Aprove o acesso. O Runner leva você de volta para **Apps**, e o cartão mostra **Conectado a** e o nome da sua conta do Klaviyo.
4. Selecione **Gerenciar** para abrir o **Klaviyo** em **Operações da loja → Plugins**. A aba mostra a mesma conta e o mesmo botão **Remover** do cartão.

## O que o Klaviyo recebe

Os eventos costumam aparecer no perfil do cliente no Klaviyo em poucos minutos.

- **Da sua loja virtual publicada:** um perfil com o nome e o e-mail do cliente quando ele cria uma conta ou entra nela, e depois **Viewed Product**, **Added to Cart** e **Started Checkout**.
- **Dos pedidos da sua loja:** **Placed Order**, com um evento **Ordered Product** para cada produto, e depois **Fulfilled Order** com a transportadora e o código de rastreamento quando o pedido é enviado. **Refunded Order** e **Cancelled Order** acompanham reembolsos e cancelamentos.

Os pedidos que você faz na prévia do Runner não vão para o Klaviyo. Use a sua loja publicada.

## Remova o Klaviyo

1. Selecione **Remover** no cartão **Klaviyo** ou na aba dele em **Operações da loja → Plugins**.
2. Selecione **Remover** de novo para confirmar. Sua loja deixa de enviar pedidos e clientes para esta conta do Klaviyo, e o Runner perde o acesso a ela. O Klaviyo mantém os perfis e eventos que já recebeu.

## Se um plugin da loja não funcionar

- **O cartão mostra É necessário atualizar o backend.** O backend da sua loja é mais antigo do que o plugin precisa. Fale com o suporte para atualizá-lo.
- **A instalação não termina.** Deixe-a em andamento e confira o cartão depois. Se aparecer **A última alteração falhou**, leia a mensagem e selecione **Instalar** mais uma vez.
- **Não há corações na loja publicada.** Confirme que o Runner terminou o chat de **Adicionar à loja virtual** e publique a loja de novo.
- **Os clientes vão para a página da conta.** Salvar sem conta está desativado, então os clientes entram na conta para salvar. Para mudar isso, ative **Allow guest wishlists** em **Operações da loja → Plugins → Wishlist**.
- **O cartão do Klaviyo mostra O acesso ao Klaviyo terminou.** O Runner não consegue mais acessar a sua conta do Klaviyo, por exemplo porque o acesso foi revogado no Klaviyo. Selecione **Reconectar** e aprove o Runner de novo.
- **Um cliente de teste não aparece no Klaviyo.** O Klaviyo ignora alguns endereços de teste, como os de example.com. Use um endereço de e-mail que receba mensagens e a sua loja publicada.

## Guias relacionados

- [Visão geral de aplicativos e integrações](../apps-and-integrations)
- [Operações da loja](../store-operations)
- [Conversar com o Runner](../work-with-runner/chat-with-runner)
- [Publicar e republicar](../storefront-and-publishing/publish-and-republish)
