# Pop-ups — Exiba mensagens e promoções diretamente na vitrine

Crie pop-ups com textos, imagens e links que aparecem automaticamente para os visitantes da loja. Configure onde, quando e para quem cada pop-up é exibido, com controle de frequência e limite de exibições por dia.

### Como funciona?

O módulo de pop-ups fica em **Marketing → Pop-ups** no menu lateral do painel. Você cria cada pop-up com um título, um conteúdo rico (texto, imagem, botão), define onde ele aparece na loja, quando é acionado e quantas vezes pode ser exibido por dia para o mesmo visitante.

O pop-up é renderizado diretamente no navegador do visitante, sem recarregar a página, e pode ser fechado pelo botão de fechar, clicando fora da janela ou pressionando Esc.

## 1 - Criando um pop-up

Acesse **Marketing → Pop-ups** no menu lateral e clique em **Novo Pop-up**.

1. Preencha o **Título**. Esse campo é apenas interno — serve para identificar o pop-up na listagem do painel e não aparece para o visitante da loja.
2. No editor de **Conteúdo**, monte o que será exibido para o visitante: texto formatado, imagens, links e botões. Use a barra de ferramentas para formatar o texto e o ícone de imagem para fazer upload diretamente pelo painel.
3. Configure as opções de exibição (detalhadas nas próximas seções): onde aparece, quando é acionado, largura, overlay e frequência.
4. Marque o campo **Ativo** e salve. O pop-up entra em funcionamento imediatamente na loja.

## 2 - Onde o pop-up aparece

O campo **Exibir em** define em quais páginas da loja o pop-up pode ser acionado.

- **Qualquer página** O pop-up pode aparecer em qualquer rota da loja: home, categorias, produtos, carrinho e checkout.
- **Página inicial** Exibido somente na home da loja. Útil para boas-vindas, banners de lançamento ou promoções gerais.
- **Categorias e produtos** Aparece nas páginas de categoria, na listagem geral de produtos, na página de um produto específico e na busca.
- **Carrinho e checkout** Aparece no carrinho e em todas as etapas de pagamento. Ideal para cupons de última hora ou avisos sobre formas de pagamento.

## 3 - Quando o pop-up é acionado

O campo **Quando mostrar** define o gatilho de exibição dentro da página.

1. **Imediatamente** — o pop-up aparece assim que a página termina de carregar, sem espera.
2. **Após N segundos** — o pop-up aguarda o número de segundos configurado antes de aparecer. Use para não interromper o visitante logo na chegada.
3. **Ao tentar sair (exit intent)** — o pop-up é exibido quando o cursor do visitante se move em direção ao topo da janela do navegador, indicando que ele está prestes a fechar a aba ou voltar ao buscador. Em dispositivos móveis, o gatilho é acionado após 30 segundos de inatividade na tela.

**Dica:** o exit intent é o gatilho mais eficaz para recuperar visitantes que estão abandonando a loja. Configure um cupom de desconto ou uma oferta especial para aparecer nesse momento.

## 4 - Frequência e público

1. **Máximo de exibições por dia:** define quantas vezes o mesmo visitante pode ver o pop-up em um único dia. O controle é feito localmente no navegador. Configure 0 para exibir sem limite.
2. **Apenas para clientes logados:** quando marcado, o pop-up só aparece para visitantes que estão com sessão ativa na loja. Útil para comunicados exclusivos para clientes cadastrados, como condições especiais ou avisos do programa de fidelidade.
3. **Ordem:** quando há mais de um pop-up ativo para a mesma página, o campo **Ordem** determina qual deles tem prioridade. O pop-up com menor número de ordem é exibido primeiro.

## 5 - Aparência

- **Largura** Define o tamanho da janela do pop-up: **Pequeno** (400 px), **Médio** (540 px), **Grande** (720 px) ou **Extra grande** (900 px). Escolha conforme o conteúdo — imagens grandes pedem janelas maiores.
- **Overlay (fundo escurecido)** Configure a **cor** e a **opacidade** do fundo que aparece atrás da janela do pop-up. Opacidade 0 deixa o fundo transparente; 100 deixa totalmente opaco. O padrão é preto com 60% de opacidade.

## 6 - O módulo não aparece no menu?

Se o item **Pop-ups** não aparece em **Marketing** no menu lateral, o perfil do seu usuário não tem permissão para acessar esse módulo. Siga os passos abaixo para liberar o acesso.

Como conceder a permissão:

1. Acesse **Configurações → Usuários → Perfis de Usuário** no menu lateral.
2. Localize o perfil associado ao seu usuário e clique em **Editar**.
3. Na seção **Marketing**, localize o item **Pop-ups** e marque as permissões desejadas: *Ver*, *Criar*, *Editar* e *Excluir*.
4. Salve o perfil e recarregue a página. O item **Pop-ups** aparecerá no menu lateral em **Marketing**.

**Atenção:** apenas usuários com permissão de administrador ou com acesso ao módulo de Perfis de Usuário conseguem alterar essas configurações. Se não tiver acesso, solicite ao responsável pela conta.

## 7 - Resumo do fluxo completo

1. Em **Marketing → Pop-ups**, clique em **Novo Pop-up** e monte o conteúdo no editor.
2. Defina **onde** aparece (página inicial, categorias, carrinho ou qualquer página) e **quando** é acionado (imediatamente, após N segundos ou ao tentar sair).
3. Configure o limite de exibições por dia, se o pop-up é apenas para logados e a ordem de prioridade.
4. Ajuste a largura da janela e o overlay conforme o visual desejado.
5. Ative o pop-up e salve. Ele entra em funcionamento imediatamente na vitrine da loja.

**Dica:** use pop-ups com exit intent no carrinho para recuperar clientes que estão abandonando a compra — um cupom de desconto ou frete grátis nesse momento pode ser decisivo para fechar o pedido.