Documentação Provei

Toast de Convite

O Toast de Convite é um cartão discreto exibido em uma página de produto compatível para convidar o visitante a abrir o provador virtual. Ele não interrompe a navegação, pode ser fechado a qualquer momento e antecede a abertura do VTO de Home ou Fashion.

O que é o Toast de Convite?

Em poucas palavras

  • Aparece para visitantes no site da sua loja, em uma página de produto elegível
  • Mostra a imagem disponível do produto, título, mensagem e CTA
  • O CTA abre o provador virtual; o botão de fechar dispensa o convite
  • Pode fechar sozinho quando o fechamento automático estiver ativado
  • É uma função dos snippets VTO de Home e Fashion, não do widget de Medidas

Importante: o toast é direcionado ao visitante da loja. Ele é diferente das notificações do painel e suas configurações não são usadas pelo runtime de Medidas.

Quando ele aparece

Condições necessárias

  • O snippet VTO de Home ou Fashion precisa estar ativo, com plano e créditos elegíveis
  • O botão do widget deve estar habilitado e o modo não pode ser inline
  • A página precisa ter um produto que o runtime consiga associar

Tempo de exibição

O toast aparece depois de um tempo sorteado entre o delay mínimo e o delay máximo. Os valores iniciais do painel são 10 e 30 segundos.

Em telas pequenas, ele ocupa a largura disponível na parte inferior.

O que o visitante vê

Conteúdo do toast

  • Imagem do produto, quando houver uma URL válida
  • Título, mensagem e botão de ação
  • Ícone de fechar para dispensar o convite

Sem uma imagem válida, o toast continua funcionando sem a coluna de imagem.

Experiência na loja › Pop-up de convite

No painel, abra Experiência na loja › Pop-up de convite. As opções salvas são aplicadas aos snippets VTO de Home e Fashion; elas não configuram o runtime de Medidas.

Acesso atual: é necessário estar autenticado, ter o Provador Virtual de moda ou de óculos e possuir a permissão config.toasts. Um perfil admin ou uma impersonação administrativa confiável pode dispensar a verificação dessa permissão; o provador de moda ou de óculos continua sendo exigido.

1

Abra o Pop-up de convite

No painel, abra Experiência na loja › Pop-up de convite.

2

Ajuste aparência, conteúdo e comportamento

Escolha o tema, a posição, os textos e os tempos do convite.

3

Publique as alterações

Confira a prévia e clique em “Publicar alterações” para atualizar os snippets de Home e Fashion.

Aparência

Tema

Escolha entre Claro, Escuro ou Glass. Glass é apenas um tema visual.

Posição

Defina o canto no desktop. Em telas pequenas, o container se adapta à largura e fica na parte inferior.

Conteúdo padrão

Limites e valores sugeridos

  • Título: até 50 caracteres
  • Mensagem: até 120 caracteres
  • CTA: até 20 caracteres

O valor padrão da mensagem no painel, no preview e nos dois runtimes é “Experimente agora no nosso provador virtual.”

Quando o campo de título chega vazio ao runtime, cada linha usa seu próprio fallback: Home: “Veja no seu ambiente!”; Fashion: “Veja como fica em você!”. A mensagem padrão é “Experimente agora no nosso provador virtual.” e o CTA padrão é “Quero ver!” nas duas linhas.

Comportamento

Fechamento automático

O painel recebe o tempo em segundos, de 1 a 60, com valor inicial de 5 segundos. A API e a configuração persistida usam milissegundos: 5 segundos são armazenados como 5000.

Delay mínimo e máximo

O painel começa com delay mínimo de 10 segundos e máximo de 30 segundos. O runtime sorteia um instante nesse intervalo; os valores persistidos são enviados em milissegundos.

Barra de progresso: ela é renderizada e atualizada somente quando o fechamento automático e a opção de progresso estão ambos ativados. Com o fechamento automático desligado, ativar a opção de progresso não cria uma barra nem inicia uma contagem.

Sem um objeto toastConfig, os fallbacks atuais do runtime são:

  • Home: enabled: true, tema glass, posição bottom-right, fechamento automático desligado,8000 ms, progresso ativado, título “Veja no seu ambiente!”, mensagem padrão e CTA “Quero ver!”. O delay é 3000 ms a 3000 ms.
  • Fashion: enabled: true, tema glass, posição bottom-right, fechamento automático ligado,8000 ms, progresso ativado, título “Veja como fica em você!”, mensagem padrão e CTA “Quero ver!”. O delay é 10000 ms a 30000 ms.

Boas práticas

Faça

  • Use um título curto e direto
  • Destaque um benefício que o provador realmente entrega
  • Use um CTA claro e amigável, como “Quero ver!”
  • Confira o texto em uma tela pequena

Evite

  • Mensagens longas ou com termos técnicos
  • Delay muito curto, que pode parecer invasivo
  • Promessas que o provador não entrega

Precisa de ajuda?

Nossa equipe está pronta para ajudar você a configurar o Toast de Convite nos snippets de Home e Fashion.