Instalar Wavize no Wix

Wix exige duas configurações: widget e loja

O código personalizado Wix exibe o widget no site. A ligação comercial Wix permite à Wavize ler catálogo e encomendas via API com URL base, Site ID em formato UUID e chave API. Pode instalar o widget sem ligar Wix Stores, mas respostas de catálogo e seguimento não estarão disponíveis.

Wavize deteta se o site usa catálogo Wix Stores v1 ou catálogo v3 e guarda essa versão na ligação. O teste deve passar antes de interpretar ausência de produtos como problema de IA.

Segredos distintos
O token público do widget vai no código personalizado. A chave API Wix fica apenas no formulário servidor Wavize e nunca deve ser colada no Wix Custom Code.

Publicar o widget com código personalizado

A sua oferta Wix e domínio devem permitir adicionar código personalizado.

1. Copiar o bloco Wavize

   Em Assistente > Instalação, copie o script completo para o domínio Wix público. Não substitua o token por chave API comercial.

2. Adicionar no Wix

   No painel Wix, abra Definições > Avançado > Código Personalizado, adicione o bloco ao corpo e escolha todas as páginas desejadas. Publique o site depois de guardar.

3. Respeitar consentimento e domínio

   Dispare o código conforme a sua política de cookies e teste a URL final. Um domínio Wix gratuito e um domínio personalizado são hosts distintos para controlo Wavize.

Criar chave API Wix dedicada

No painel da conta Wix, abra Definições > Chaves API e crie uma chave limitada ao site e permissões necessárias.

1. Nome e âmbito

   Nomeie como Wavize e selecione o site. Evite uma chave global se um âmbito mais restrito for possível.

2. Permissões de leitura comercial

   Conceda leitura do catálogo/produtos e encomendas eCommerce necessárias. Labels Wix podem variar entre catálogo v1 e v3; procure permissões Business Management / Wix Stores / eCommerce correspondentes.

3. Cópia única e rotação

   Copie a chave quando criada para um gestor seguro. Se perdida ou exposta, crie nova, atualize a Wavize, teste e revogue a antiga.

Encontrar o Site ID exato

O Site ID não é o nome nem domínio do site. A Wavize espera um UUID.

• Pelas ferramentas de programador Wix

  Abra o site no dashboard de programador ou na documentação API da conta e copie o identificador do site selecionado. Tem formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

• Verificar associação

  O Site ID deve pertencer ao site autorizado pela chave. Uma chave válida para outro site causa recusa ou catálogo vazio.

• URL base

  Digite o site público HTTPS na Wavize. Serve para criar links de produto e identificar a ligação; não cole URL de editor Wix.

Testar versão do catálogo e encomendas

Guarde ligação, clique Testar e ative se valida.

1. Deteção v1 / v3

   Wavize consulta as APIs disponíveis e guarda V1_CATALOG ou V3_CATALOG. Não altere manualmente; depende do site Wix.

2. Pesquisa produto

   Teste produto publicado com nome, preço e variante exatos. Produto oculto ou indisponível pode faltar na recomendação.

3. Encomenda e e-mail

   Use encomenda de teste e e-mail cliente. Resposta neutra se referência ou e-mail não confere, mesmo que encomenda exista.

Diagnóstico Wix rápido

Separe invisibilidade do widget de falha na API comercial.

• Widget ausente — Verifique código personalizado, publicação, domínio e consentimento.
• Teste 401 / 403 — Verifique chave, permissões, site autorizado e Site ID.
• Catálogo vazio — Verifique versão detetada, produtos publicados e âmbito da chave.