Logo VTEX VTEX

Provador virtual para
VTEX

Ative o Provei.AI inserindo um script no head do seu Store Theme. Funciona em VTEX IO e Legacy sem afetar o checkout.

10 minutos Médio

Compatível com VTEX IO e Legacy

Sem interferir no checkout

Controle por ambiente e workspace

Código de instalação

Copie o script do seu painel Provei.AI e cole no head do site. O USER_ID é único para cada conta.

  • Não é necessário instalar apps ou plugins.
  • O script é assíncrono e não bloqueia o carregamento.
  • Remover o script desativa o provador instantaneamente.
Snippet Use o script do painel
					<!-- Provei Widget - Visualizador de Ambientes -->
<script src="https://app.provei.ai/api/v2/snippet/SEU_USER_ID" async></script>
				

Passo a passo de instalação

Siga o caminho abaixo para inserir o script no head da sua loja VTEX.

VTEX IO (Store Theme)

Store Theme > head.html ou bloco head

  1. 1

    Acesse o Store Theme

    No Admin da VTEX, vá em Storefront > Store Theme.

  2. 2

    Abra o head do tema

    Edite o arquivo head.html ou o bloco de head/header do tema.

  3. 3

    Cole o script do Provei.AI

    Adicione o script imediatamente antes da tag </head>.

  4. 4

    Publique o workspace

    Salve e publique as alterações no ambiente desejado.

VTEX Legacy (CMS)

Storefront > CMS > HTML Templates > head.html

  1. 1

    Abra os templates HTML

    No Admin, vá em Storefront > CMS > HTML Templates.

  2. 2

    Edite o head.html

    Abra o template head.html do site.

  3. 3

    Cole o script do Provei.AI

    Adicione o script antes da tag </head> e salve.

  4. 4

    Publique e valide

    Publique as alterações e confirme no front.

Observações importantes

  • Se você trabalha com agência, solicite a inserção no head global.
  • Depois de publicar, limpe cache se necessário.

Beneficios para lojas VTEX

O Provei.AI melhora a experiencia de compra sem exigir mudancas no seu fluxo atual.

Compatibilidade ampla

Funciona em VTEX IO e VTEX Legacy com o mesmo script.

Sem impacto no checkout

A integração acontece no head do storefront, fora do checkout.

Controle por ambiente

Aplique o script em homologação antes de publicar em produção.

Performance preservada

O carregamento assíncrono evita bloqueios no carregamento.

Sobre a integração

Em VTEX IO e VTEX Legacy, a integração do Provei.AI é feita no head global do storefront. Isso garante que o provador virtual seja carregado em todas as páginas sem impactar o fluxo de checkout.

Recomendamos validar em ambiente de homologação primeiro. Quando estiver tudo ok, publique em produção e limpe o cache se necessário.

Perguntas frequentes

Respostas rápidas sobre instalação e funcionamento.

1 Funciona com VTEX IO e Legacy?

Sim. O script pode ser inserido no head do Store Theme (IO) ou no head.html do CMS (Legacy). Para VTEX IO moderno, você também pode usar o blocks.json ou editar diretamente o tema via VTEX IO CLI.

2 Preciso de um app VTEX?

Não. A integração é feita somente via script no head.

3 Posso testar em homologação?

Sim. Aplique no workspace de homologação antes de publicar.

4 O script afeta o checkout?

Não. A inserção é no storefront, sem alterar o checkout.

5 Onde encontro meu script?

No painel da Provei.AI, com seu USER_ID único.

Pronto para ativar o Provei.AI?

Copie o script no painel e publique na sua loja em poucos minutos.

Acessar painel