Wavize installeren op Wix

Wix vraagt twee configuraties: widget en winkel

De Wix custom code toont de widget op de site. De Wix Stores commerceverbinding laat Wavize via API het catalogus en bestellingen lezen met basis-URL, Site ID (UUID-formaat) en API-sleutel. Widget kan zonder Wix Stores verbinding worden geïnstalleerd, maar catalogus- en trackingantwoorden ontbreken dan.

Wavize detecteert of site Wix Stores catalogus v1 of v3 gebruikt en slaat versie op in verbinding. Test moet slagen vóór interpretatie van productafwezigheid als AI-probleem.

Gescheiden geheimen
De publieke widget-token gaat in de custom code. Wix API-sleutel blijft alleen in Wavize serverformulier en nooit in Wix Custom Code.

Publiceer widget met custom code

Wix-plan en domein moeten custom code toelaten.

1. Kopieer Wavize block

   In Assistent > Installatie, kopieer volledig script voor publiek Wix-domein. Vervang token niet door commerce API-sleutel.

2. Voeg toe in Wix

   In Wix dashboard, open Instellingen > Geavanceerd > Custom Code, voeg block toe aan body en kies alle gewenste pagina's. Publiceer na opslaan.

3. Respecteer toestemming en domein

   Trigger code volgens cookiestatus en test finale URL. Gratis Wix domein en aangepast domein zijn twee verschillende hosts voor Wavize controle.

Maak aparte Wix API-sleutel

In Wix account dashboard, open Accountinstellingen > API-sleutels en maak sleutel beperkt tot site en benodigde permissies.

1. Naam en scope

   Noem het Wavize en selecteer de site. Gebruik geen globale keys als beperkte scope kan.

2. Leespermissies commerce

   Geef leesrechten voor catalogus/producten en e-commerce bestellingen. Wix labels kunnen wisselen tussen Catalogus v1 en v3; zoek naar Business Management / Wix Stores / eCommerce rechten.

3. Unieke kopie en rotatie

   Bewaar sleutel bij aanmaak in veilige manager. Verloren of gelekte sleutel vervangen, Wavize updaten, testen en oude intrekken.

Exact Site ID vinden

Site ID is niet site-naam of domein. Wavize verwacht een UUID.

• Via Wix developer tools

  Open site in developer dashboard of API-documentatie en kopieer geselecteerde site-ID. Deze lijkt op xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

• Verificatie koppeling

  Site ID moet bij sleuteltoegelaten site horen. Sleutel van andere site kan weigering of lege catalogus geven.

• Basis-URL

  Voer publieke site HTTPS URL in Wavize in. Dit bouwt productlinks en identificeert verbinding; plak geen Wix editor URL.

Test catalogus versie en orders

Sla verbinding op, klik Test en activeer bij geldige controle.

1. Detectie v1 / v3

   Wavize bevraagt beschikbare API’s en onthoudt V1_CATALOG of V3_CATALOG. Verander deze handmatig niet; hangt van Wix site af.

2. Product zoeken

   Test gepubliceerde product met precieze naam, prijs en variantie. Verborgen of niet-beschikbaar product kan ontbreken in aanbeveling.

3. Bestelling en e-mail

   Gebruik testbestelling en klant-e-mail. Antwoord blijft neutraal bij mismatch referentie of e-mail, ook als bestelling bestaat.

Snel Wix-diagnose

Maak altijd onderscheid tussen widget onzichtbaar en commerce API-fout.

• Widget afwezig — Controleer custom code, publicatie, domein en toestemming.
• Test 401 / 403 — Controleer sleutel, permissies, toegestane site en Site ID.
• Lege catalogus — Controleer gedetecteerde versie, gepubliceerde producten en sleutelscope.