Vizzoro

Central de ajuda para desenvolvedores

Leve a Vizzoro para seu website.

Tudo que um implementador precisa para conectar um catálogo autorizado, abrir o visualizador e entender o fluxo de produção.

Comece aqui

A Vizzoro permite que clientes coloquem um material real do seu catálogo na foto do próprio ambiente. Sua equipe gerencia os produtos no app Vizzoro. Seu website carrega o visualizador por um pequeno SDK JavaScript.

1. Prepare o catálogo

Crie um produto de piso texturizado com imagem e dimensões físicas no app Vizzoro.

2. Autorize seu website

Adicione o hostname exato em Integração e crie uma chave pública para esse domínio.

3. Adicione o SDK

Adicione o script e chame Vizzoro.start na página ou botão do produto.

Instale o SDK

Adicione este código uma vez na página em que o cliente poderá abrir o visualizador. A chave pública foi criada para uso no navegador.

<script src="https://vizzoro-app.web.app/sdk.js" data-key="vz_pk_..."></script>
<script>
  Vizzoro.start({
    category: "floor",
    productId: "PRODUCT_ID",
    locale: "pt"
  });
</script>

Substitua PRODUCT_ID pelo ID do documento do produto no catálogo Vizzoro. Use o mesmo domínio que foi autorizado no app.

Referência do SDK

Vizzoro.start abre um visualizador acessível em tela cheia. Uma nova chamada substitui o visualizador atual.

Vizzoro.start({
  category: "floor",
  productId: "PRODUCT_ID",
  locale: "pt",
  onLeadCapture: ({ productId, jobId }) => {
    console.log("Visualization completed", productId, jobId);
  }
});
categoryobrigatório

Categoria do material. O MVP atual suporta floor.

productIdobrigatório

ID de um produto no catálogo autorizado.

localeopcional

en, pt ou es. Sem esse campo, a Vizzoro usa o idioma do navegador.

onLeadCaptureopcional

Callback após uma visualização concluída. Recebe productId e jobId.

Chaves e domínios autorizados

Uma chave pública Vizzoro pode ficar no código do navegador porque tem uma finalidade limitada. Ela abre o visualizador apenas em um domínio aprovado.

  • Crie chaves somente depois de adicionar todos os hostnames de produção e homologação.
  • A Vizzoro valida a chave e o domínio do website sempre que o visualizador é aberto.
  • Nunca coloque credenciais de serviço ou chaves não publicáveis no website.
  • Crie uma chave nova e remova a anterior quando um domínio mudar de proprietário.

Use em uma página de produto

Coloque a chamada Vizzoro.start dentro do botão ou interação que o cliente usa para visualizar um material. Use o ID do produto exibido naquela página.

Páginas de produto

Use o ID do produto da sua plataforma de vendas para relacionar cada página ao produto correspondente no catálogo Vizzoro.

Botões personalizados

Chame Vizzoro.start por qualquer botão, card ou chamada para ação existente. O visualizador abre sobre a página atual.

Solução de problemas

O visualizador não abre

Confirme que o script SDK carregou sem erro no navegador e que Vizzoro.start recebeu um productId.

O domínio não foi autorizado

Adicione o hostname exato em Integração. Inclua example.com e www.example.com se seu website usar os dois.

O produto não carrega

Confirme que o ID do produto pertence à mesma organização Vizzoro da chave pública.

A renderização falhou

Use uma foto JPG ou PNG comum, com até 25 MB. Confirme que o produto tem textura e dimensões.

Precisa de ajuda na implementação?

Envie a URL da página, o erro do navegador, o ID do produto e o hostname autorizado. Assim nosso time consegue reproduzir a integração rapidamente.

Falar com o suporte Vizzoro