# Vitrine Real: base de conhecimento do suporte

Fonte oficial para o atendimento (pessoas e IA). Mesmo conteúdo do Manual em PDF, em texto. Atualizado em novembro de 2026.

Contato: contato@vitrinereal.com.br · Painel: app.vitrinereal.com.br · Vídeo passo a passo: vitrinereal.com.br/ajuda

Regras para quem atende: responder em português, direto e concreto; não prometer vídeos ilimitados (o limite do plano Avançado é o do plano Shopify da loja); teste grátis é de 3 dias; a instalação é feita pelo próprio lojista, a equipe não configura a loja.

## 01. O que a Vitrine Real faz
A Vitrine Real coloca vídeos de clientes em formato de stories na página de produto da sua loja Shopify. Quem está em dúvida toca na bolinha, assiste alguém de verdade usando o produto e compra sem sair do vídeo.

(Imagem: Na loja: as bolinhas aparecem junto do botão de comprar.)
(Imagem: Tocou na bolinha, o vídeo abre em tela cheia com o botão Comprar.)

- **Bolinhas na página do produto.** Um círculo só, que abre os vídeos em sequência, ou uma fileira com um círculo por vídeo.
- **Story em tela cheia, com som.** As bolinhas usam uma versão leve do vídeo para não pesar a página. O story abre em alta qualidade (1080p).
- **Comprar dentro do vídeo.** Se o produto tem opções (tamanho, cor) e o cliente ainda não escolheu, a escolha abre ali mesmo, dentro do story.
- **Vídeo por coleção.** Um vídeo pode aparecer em todos os produtos de uma coleção, com data para entrar e sair do ar.
- **Números de cada vídeo.** Visualizações, quem assistiu até o fim, cliques em comprar e idas ao carrinho.
- **Os vídeos ficam no seu próprio Shopify**, em Conteúdo > Arquivos. A Vitrine Real não cobra armazenamento.

## 02. Antes de começar
Confira estes pontos antes de instalar. Leva um minuto.

- Uma loja **Shopify** com acesso de dono ou de colaborador que pode instalar apps.
- Vídeos em **MP4, MOV ou WEBM**, de até **10 minutos**. Gravados em pé (vertical, 9:16) ficam melhores no story.
- O tamanho máximo de cada arquivo depende do seu plano (veja a tabela).
- Um e-mail para entrar no painel. Pode ser o mesmo da loja.

| Plano | Vídeos no ar | Tamanho por vídeo | Mensal | Anual (por mês) |
|---|---|---|---|---|
| Essencial | até 100 | até 200 MB | R$ 49 | R$ 36,90 |
| Profissional | até 500 | até 250 MB | R$ 79 | R$ 59,90 |
| Avançado | até o limite do seu plano Shopify | até 300 MB | R$ 129 | R$ 96,90 |

Todos os planos começam com **3 dias grátis**, com tudo liberado. A cobrança é feita pelo próprio Shopify, na fatura da sua loja. O plano anual sai cerca de 25% mais barato.

> Dica: O Shopify também tem um limite de quantos vídeos novos cada loja pode subir por semana, que depende do plano Shopify da loja. Vídeos que já estão nos Arquivos da loja entram pela **biblioteca** e não gastam esse limite.

## 03. Instalação passo a passo
Do zero até o primeiro vídeo aparecendo na loja. Na primeira vez leva uns 5 minutos.

> Atenção: As telas do Shopify nesta seção são ilustrações simplificadas. O Shopify muda o visual de vez em quando, mas os nomes dos botões continuam os mesmos.

1. **Encontre a Vitrine Real**: Na loja de apps do Shopify, busque **Vitrine Real** e clique em **Instalar**. Ou comece pelo botão **Testar 3 dias grátis** do nosso site.
2. **Autorize o app**: O Shopify pede sua autorização para o app ver seus produtos e guardar os vídeos na sua loja. Clique em **Instalar app**.
3. **Escolha o plano**: Essencial, Profissional ou Avançado, no mensal ou no anual. São **3 dias grátis**. Cancelou antes, não paga nada.
4. **Ligue no tema**: No painel, clique em **Ligar no tema**. No Shopify, clique em **Salvar**. É uma vez só.
5. **Suba o primeiro vídeo**: Em **Produtos**, clique no produto e arraste o vídeo. Escreva o @ de quem gravou e uma frase curta.
6. **Publique**: Clique em **Publicar na loja**. Até lá, nada muda na loja.
7. **Confira na loja**: Clique em **Ver na loja ↗**. As bolinhas aparecem junto do botão de comprar. Não apareceu? Veja **Algo não funcionou**.

## 04. Entrar no painel
O painel abre direto depois da instalação. Para voltar depois, entre em app.vitrinereal.com.br.

(Imagem: Entrar com link no e-mail.)
(Imagem: Entrar com senha.)

- **Receber link de acesso:** digite o e-mail e clique. Chega um link no seu e-mail. Clicou, entrou. Se não chegar em 1 minuto, olhe a caixa de spam. Para pedir outro link, espere um minuto.
- **Entrar com senha:** mais rápido no dia a dia. Primeiro entre pelo link e crie a senha no botão **Senha**, no topo do painel.
- **Usar outro e-mail:** volta para digitar o e-mail de novo.

(Imagem: Botão Senha: defina uma senha de pelo menos 6 caracteres para entrar sem esperar o e-mail.)

## 05. O tutor guiado
Na primeira vez que você entra, um tutor mostra o painel tela por tela. A tela escurece, a parte explicada fica em destaque e uma legenda diz o que é e o que fazer.

(Imagem: Boas-vindas.)
(Imagem: Cada passo destaca uma parte da tela.)

- **Próximo** e **Voltar** andam pelos passos. No teclado, as setas fazem o mesmo.
- **Pular tutorial** (ou a tecla Esc) fecha o tutor. Ele não aparece de novo sozinho.
- Para rever quando quiser: botão **Ajuda**, no topo, e depois **Ver o tutorial de novo**.

## 06. Tela Produtos
É a tela inicial. Mostra todos os produtos da loja e quantos vídeos cada um tem no ar.

Partes da tela:
1. **Abas do painel**: Produtos, Coleções, Aparência e Desempenho. A aba aberta fica em destaque.
2. **Ajuda**: Tutorial de novo, vídeo passo a passo, este manual e o campo para mandar dúvida ou sugestão.
3. **Senha e Sair**: **Senha** cria ou troca a senha de entrada. **Sair** desconecta. Se houver alteração sem publicar, o painel pergunta antes de sair.
4. **Teste grátis**: Dias que faltam do teste grátis e a data em que termina.
5. **Faixa da loja**: Verde: tudo certo, os vídeos aparecem na loja. Vermelha: falta ligar a Vitrine Real no tema (veja abaixo).
6. **Buscar produto**: Busca pelo nome do produto.
7. **Filtrar por coleção**: Mostra só os produtos de uma coleção. O número entre parênteses é quantos produtos ela tem.
8. **Todos / Com vídeos / Sem vídeos**: **Todos**, só os **Com vídeos** ou só os **Sem vídeos**. Bom para achar o que ainda falta.
9. **Seus números**: Vídeos no ar, produtos com vídeo, quanto do plano você já usou e o espaço da lista de vídeos.
10. **Cartão do produto**: A etiqueta verde mostra quantos vídeos estão no ar naquele produto. Clique no cartão para abrir o produto.

(Imagem: Faixa vermelha: os vídeos ainda não aparecem na loja.)

**Faixa vermelha "Os vídeos ainda não aparecem na loja".** Acontece na instalação e quando a loja troca de tema. Clique em **Ligar no tema**, confira se a Vitrine Real está ativada em Incorporações de app e clique em **Salvar** no editor do Shopify. Duplicar o tema mantém o widget ligado; tema novo precisa desse clique.

**"Rascunho na loja"** embaixo do nome quer dizer que o produto está como rascunho no Shopify. Os vídeos ficam guardados, mas só aparecem quando o produto estiver ativo.

**Faixa "vídeos guardados para um produto que não existe mais".** Aparece quando um produto ou coleção com vídeo foi apagado ou arquivado no Shopify. Clique em **Remover** e depois em **Publicar na loja** para limpar.

**Espaço usado.** O Shopify guarda a lista de vídeos num espaço de 128 KB. Cada vídeo ocupa muito pouco, então dá para centenas. Se passar de 80%, o número fica vermelho; perto de 100%, o painel não deixa publicar até você tirar vídeos antigos.

## 07. Página do produto
Aqui você sobe, organiza e tira os vídeos de um produto.

Partes da tela:
1. **Voltar para a lista**: Volta para a lista de produtos.
2. **Ver na loja**: Abre a página do produto na sua loja, em outra aba.
3. **Vídeos de coleção**: Aparece quando o produto também recebe vídeos de uma coleção. Mostra quais, quantos e se entram antes, depois ou no lugar dos vídeos do produto. Clique no nome para abrir a coleção.
4. **Quadro de envio**: Arraste os vídeos aqui ou clique para escolher no computador. Pode mandar vários de uma vez. O limite de tamanho e o uso do plano aparecem embaixo.
5. **Escolher da biblioteca**: Abre os vídeos que já estão nos Arquivos do seu Shopify. Entram sem novo envio e não gastam o limite semanal do Shopify.

### Enviando vídeos

(Imagem: Cada arquivo mostra o andamento: primeiro "Enviando", com a velocidade e o tempo que falta; depois "Processando no Shopify".)

Pode continuar mexendo no painel enquanto envia. Quando termina, o vídeo entra na lista abaixo. Se der erro, a linha fica vermelha com o motivo e um botão **Fechar**.

(Imagem: Biblioteca da loja: marque um ou mais vídeos e clique em Adicionar. Os que já estão no produto aparecem como "Já está aqui".)

### Cada vídeo da lista

Partes da tela:
1. **Arrastar para mudar a ordem**: Segure e arraste pelo ⋮⋮ para mudar a ordem. O primeiro da lista é o primeiro story.
2. **Posição no story**: Número da posição.
3. **Assistir o vídeo**: Clique na miniatura para assistir o vídeo.
4. **@ do criador**: O @ de quem gravou. Aparece no topo do story. O @ entra sozinho se você esquecer.
5. **Legenda**: Texto curto sobre o vídeo, até 90 caracteres. Opcional. Aparece sobre o vídeo.
6. **No ar / Pausado**: **No ar**: aparece na loja. **Pausado**: sai da loja, mas continua guardado aqui.
7. **Mover**: Leva o vídeo para uma coleção (na página do produto) ou para um produto (na página da coleção).
8. **Remover**: Primeiro clique vira **Confirmar remoção**; clique de novo em até 4 segundos para tirar.

(Imagem: Mover: escolha o destino e clique em Mover vídeo.)
(Imagem: Remover pede confirmação.)

> Atenção: Ao publicar, os vídeos que você removeu também são apagados dos Arquivos do Shopify, para não ocupar espaço. Quer só tirar da loja por um tempo? Use **Pausado**.

## 08. Publicar na loja
Tudo o que você muda fica guardado no painel até você publicar. A loja só muda quando você clica em Publicar na loja.

Partes da tela:
1. **Aviso de alteração**: Aparece sempre que existe alguma mudança que ainda não foi para a loja.
2. **Descartar**: Desfaz tudo o que não foi publicado e volta como estava. O painel pede confirmação.
3. **Publicar na loja**: Leva as mudanças para a loja na hora. Aparece "Publicado. Já está na loja."

> Dica: Pode fazer várias mudanças (em produtos, coleções e aparência) e publicar tudo de uma vez no final.

## 09. Coleções
Suba o vídeo uma vez e ele aparece em todos os produtos da coleção. Ideal para campanhas, lançamentos e Black Friday.

Partes da tela:
1. **Todos os produtos (loja inteira)**: Vale para a loja inteira: o vídeo entra em todos os produtos.
2. **Coleção com campanha**: A etiqueta mostra quantos vídeos estão no ar, se a campanha está agendada (com a data) ou encerrada.
3. **Buscar coleção**: Busca pelo nome da coleção.

Partes da tela:
1. **Situação da campanha**: **No ar agora**, **Agendado para** uma data, ou **Encerrado**.
2. **Antes / Depois / Só estes**: **Antes**: os vídeos da coleção entram na frente dos vídeos do produto. **Depois**: entram depois. **Só estes**: substituem os vídeos do produto enquanto estiverem no ar.
3. **Datas de início e fim**: Data para entrar e data para sair do ar. Deixe em branco para ficar sempre no ar. As datas seguem o horário de Brasília e a troca acontece sozinha.
4. **Tirar período**: Apaga as duas datas.
5. **Quadro de envio**: Envio de vídeos, igual ao da página do produto.

> Dica: Exemplo de Black Friday: crie os vídeos na coleção Black Friday, escolha **Antes**, marque de 24/11 até 30/11 e publique. No dia 24 os vídeos entram sozinhos; no dia 1º saem sozinhos.

## 10. Aparência
Define como as bolinhas e os stories ficam na sua loja. Vale para todos os produtos. A prévia ao lado muda na hora; a loja só muda quando você publica.

Partes da tela:
1. **Formato**: Primeiro bloco de ajustes. São cinco, de cima para baixo.
2. **Tamanho e posição**: Onde e de que tamanho as bolinhas aparecem.
3. **Prévia**: Mostra como fica com os seus vídeos.
4. **Computador / Celular**: Troque a prévia entre computador e celular.

### 1. Formato


- **Círculo único**: uma bolinha que abre todos os vídeos em sequência. Pode mostrar o número de vídeos no círculo.
- **Fileira de círculos**: um círculo por vídeo, no estilo dos destaques do Instagram. Pode mostrar o @ embaixo de cada um.

### 2. Tamanho e posição

(Imagem: Embaixo do botão de comprar.)
(Imagem: Flutuante, fixo no canto da tela.)

- **Embaixo do botão**: as bolinhas ficam junto do botão de comprar. Tamanhos **P, M, G, GG** ou **Tamanho do botão** (acompanha a altura do botão de comprar do tema). A régua ajusta em pixels.
- **No celular**: **Automático** mantém a mesma proporção do computador. **Ajustar separado** libera um tamanho só para o celular.
- **Alinhamento**: esquerda, centro ou direita. **Espaço até o botão**: distância entre o botão de comprar e as bolinhas.
- **Flutuante**: um círculo fixo no canto da tela, que acompanha a rolagem. Escolha o canto, a distância do rodapé (no computador e no celular), a distância da lateral e o tamanho. Também dá para arrastar o círculo na prévia. O cliente pode fechar no ×.

> Dica: Se o seu tema tem uma barra fixa de comprar no celular, suba o círculo flutuante até ele ficar acima dela.

### 3. Anel


- **Cor sólida** ou **Degradê** (duas cores e a direção, bom para campanhas).
- A cor do anel também é a cor do botão **Comprar** dentro do story.
- **Espessura do anel**: de 1 a 8 pixels.

### 4. Texto e detalhes


- **Texto ao lado do círculo**: título (até 40 caracteres) e linha de apoio (até 50). Use **#** onde deve entrar o número de vídeos. Ex.: "# vídeos de clientes" vira "3 vídeos de clientes".
- **Fonte**: a mesma do seu site, uma das fontes prontas (Inter, DM Sans, Manrope, Poppins, Montserrat, Space Grotesk, Playfair Display, Lora, Helvetica) ou a **fonte da marca** (arquivo WOFF2, WOFF, TTF ou OTF, até 5 MB; use só fonte que a marca tem licença para usar na web).
- **Dentro do círculo**: vídeo em movimento ou foto parada.

### 5. Stories


- **Texto do botão de compra**: até 24 caracteres. Ex.: Comprar, Quero o meu.
- **Depois de adicionar ao carrinho**: ir para o carrinho ou continuar no vídeo.
- **Abrir com som**, **Curtir**, **Compartilhar** (WhatsApp, copiar link e enviar), **Legenda sobre o vídeo** e **Comentários** (desligado por padrão). Ligue e desligue cada um.

(Imagem: Prévia no computador.)
(Imagem: Prévia no celular.)

## 11. Desempenho
Mostra como cada vídeo está indo na loja, para você saber quais gravar mais e quais trocar.

Partes da tela:
1. **Período: 7, 30 ou 90 dias**: Período dos números: últimos 7, 30 ou 90 dias.
2. **Vídeo campeão**: O vídeo que mais levou gente ao carrinho no período, com o total e a porcentagem de quem viu.
3. **Totais do período**: Visualizações, porcentagem que assistiu até o fim, cliques em comprar e idas ao carrinho, somando todos os vídeos.
4. **Ordenar pela coluna**: Clique em **Visualiz.**, **Comprar** ou **Carrinho** para ordenar a tabela por essa coluna.

| Coluna | O que conta |
|---|---|
| Visualiz. | Quantas vezes o vídeo foi aberto em story. |
| Até o fim | Porcentagem das visualizações que chegaram ao fim do vídeo. |
| Curtidas | Toques no coração dentro do story. |
| Comprar | Cliques no botão de compra dentro do vídeo. |
| Carrinho | Vezes que o produto foi para o carrinho a partir do vídeo. |
| Compart. | Compartilhamentos (WhatsApp, link copiado, enviar). |

As vendas finalizadas aparecem no próprio Shopify: cada item vendido pelo vídeo fica marcado no pedido com o vídeo e o criador.

## 12. Ajuda e suporte
Tudo o que precisa para resolver sozinho, e gente para ajudar quando não der.

(Imagem: Botão Ajuda, no topo do painel.)
(Imagem: Mandar dúvida ou sugestão.)

- **Ver o tutorial de novo**: o passo a passo com legendas, tela por tela.
- **Vídeo passo a passo**: instalação e uso, do começo ao fim, em vitrinereal.com.br/ajuda.
- **Manual em PDF**: este documento.
- **Conversar no chat**: fala com a gente sem sair do painel. Quando ninguém estiver online, a resposta chega no seu e-mail.
- **Mandar dúvida ou sugestão**: escreva do seu jeito. A resposta chega no e-mail da sua conta. Sugestão boa vira recurso.
- Ou escreva para **contato@vitrinereal.com.br**. Suporte 24h com IA, e uma pessoa da equipe quando precisar.

## 13. Algo não funcionou
Os casos mais comuns e o que fazer em cada um.

**Os vídeos não aparecem na loja.**
Confira, nesta ordem: 1) a faixa da tela Produtos está verde ("Tudo certo")? Se estiver vermelha, clique em Ligar no tema e Salvar. 2) Você clicou em Publicar na loja depois de subir o vídeo? 3) O vídeo está No ar (e não Pausado)? 4) O produto está ativo no Shopify (não está como rascunho)? 5) Se o vídeo é de uma coleção com datas, a campanha já começou? Depois, recarregue a página da loja.

**Troquei de tema e os vídeos sumiram.**
Tema novo vem com a Vitrine Real desligada. Clique em Ligar no tema, na faixa vermelha, e Salvar no editor do Shopify. Se você só duplicou o tema, o widget continua ligado.

**O envio deu erro.**
Veja o motivo escrito na linha vermelha. Os mais comuns: arquivo maior que o limite do plano, vídeo com mais de 10 minutos, formato diferente de MP4, MOV ou WEBM, ou o limite semanal de envios do Shopify. Para o limite semanal, use vídeos que já estão nos Arquivos, pela biblioteca, ou espere alguns dias.

**O vídeo ficou muito tempo em "Processando no Shopify".**
O Shopify prepara as versões do vídeo. Costuma levar segundos, mas vídeos longos podem demorar alguns minutos. Pode continuar usando o painel. Se passar de 15 minutos, mande uma dúvida pelo botão Ajuda.

**Não recebi o link de acesso.**
Olhe o spam e a aba Promoções. Espere um minuto e peça de novo. Para não depender do e-mail, crie uma senha no botão Senha.

**Apareceu "Seu teste grátis terminou".**
Os vídeos continuam guardados. Para voltar a publicar, escolha um plano.

**O "Espaço usado" está alto.**
Tire vídeos antigos ou pausados que não vai usar mais e publique. Remover também libera espaço nos Arquivos do Shopify.

**As bolinhas ficaram grandes ou pequenas demais no celular.**
Em Aparência, Tamanho e posição, troque No celular para Ajustar separado e escolha o tamanho só para o celular. Confira na prévia Celular e publique.

**O círculo flutuante ficou em cima do botão de comprar no celular.**
Em Aparência, aumente a Distância do rodapé no celular até ele ficar acima da barra de comprar do tema.

## 14. Palavras que aparecem no painel
| Palavra | Quer dizer |
|---|---|
| Widget | A parte da Vitrine Real que aparece na loja: as bolinhas e os stories. |
| Incorporações de app (app embed) | Lugar do editor de tema do Shopify onde a Vitrine Real é ligada ou desligada. |
| Story | O vídeo aberto em tela cheia, em pé, como no Instagram. |
| No ar / Pausado | Aparece ou não aparece na loja. Pausado continua guardado. |
| Publicar na loja | Levar para a loja tudo o que foi mudado no painel. |
| Biblioteca | Vídeos que já estão nos Arquivos do Shopify da sua loja. |
| Antes / Depois / Só estes | Como os vídeos de uma coleção se juntam aos vídeos do produto. |
| Visualização | Uma abertura do vídeo em story. |
