Installare Wavize su Wix

Wix richiede due configurazioni: widget e negozio

Il codice personalizzato Wix mostra il widget sul sito. La connessione commerce Wix permette a Wavize di leggere catalogo e ordini tramite API con URL base, Site ID in formato UUID e chiave API. Puoi installare il widget senza collegare Wix Stores, ma risposte catalogo e tracking non saranno disponibili.

Wavize rileva se il sito usa catalogo Wix Stores v1 o v3 e conserva questa versione nella connessione. Il test deve riuscire prima di interpretare l’assenza prodotti come problema IA.

Segreti distinti
Il token pubblico widget va nel codice personalizzato. L’API key Wix resta solo nel modulo server Wavize e mai incollata in Wix Custom Code.

Pubblica il widget con codice personalizzato

La tua offerta Wix e dominio devono permettere l’aggiunta di codice personalizzato.

1. Copia il blocco Wavize

   In Assistant > Installazione, copia lo script completo per dominio pubblico Wix. Non sostituire il token con chiave API commerce.

2. Aggiungi in Wix

   Nel dashboard Wix, apri Impostazioni > Avanzate > Codice personalizzato, inserisci il blocco nel body e scegli tutte le pagine desiderate. Pubblica dopo salvataggio.

3. Rispetta consenso e dominio

   Avvia il codice secondo politica cookie e testa URL finale. Dominio Wix gratuito e dominio personalizzato sono host diversi per controllo Wavize.

Crea una chiave API Wix dedicata

Nel dashboard account Wix, apri Impostazioni account > Chiavi API e crea chiave limitata a sito e permessi necessari.

1. Nome e ambito

   Nominala Wavize e scegli il sito. Evita chiave globale account quando possibile con ambito ristretto.

2. Permessi lettura commerce

   Concedi lettura catalogo/prodotti e ordini eCommerce necessari. Le etichette Wix possono cambiare tra Catalogo v1 e v3; cerca permessi Business Management / Wix Stores / eCommerce corrispondenti.

3. Copia una volta e ruota

   Salva la chiave alla creazione in gestore sicuro. Se persa o esposta, crea nuova, aggiorna Wavize, testa e revoca la vecchia.

Recupera Site ID preciso

Il Site ID non è nome o dominio sito. Wavize attende un UUID.

• Da strumenti sviluppatore Wix

  Apri sito nel dashboard sviluppatore o documentazione API account e copia ID sito selezionato. Assomiglia a xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

• Verifica associazione

  Il Site ID deve appartenere al sito autorizzato dalla chiave. Chiave valida per altro sito può causare rifiuto o catalogo vuoto.

• URL base

  Inserisci sito pubblico HTTPS in Wavize. Serve per link prodotto e identificare la connessione; non incollare URL editor Wix.

Testa versione catalogo e ordini

Salva connessione, clicca Test e attiva se controllo valido.

1. Rilevamento v1 / v3

   Wavize interroga API disponibili e memorizza V1_CATALOG o V3_CATALOG. Non cambiare manualmente, dipende dal sito Wix.

2. Ricerca prodotto

   Testa prodotto pubblicato con nome, prezzo e variante precisi. Prodotto nascosto o non disponibile può mancare nelle raccomandazioni.

3. Ordine e email

   Usa ordine test e email cliente. Risposta resta neutra se riferimento o email non corrispondono, anche se ordine esiste.

Diagnostica Wix rapida

Distinguere sempre assenza widget da fallimento API commerce.

• Widget assente — Controlla codice personalizzato, pubblicazione, dominio e consenso.
• Test 401 / 403 — Controlla chiave, permessi, sito autorizzato e Site ID.
• Catalogo vuoto — Controlla versione rilevata, prodotti pubblicati e ambito chiave.