Wavize auf Wix installieren

Wix erfordert zwei Konfigurationen: Widget und Shop

Der benutzerdefinierte Wix-Code zeigt das Widget auf der Seite an. Die Commerce-Verbindung erlaubt Wavize, Katalog und Bestellungen über die API mit Basis-URL, Site ID im UUID-Format und API-Schlüssel abzurufen. Das Widget kann ohne Verbindung zu Wix Stores installiert werden, aber Katalog- und Tracking-Antworten stehen dann nicht zur Verfügung.

Wavize erkennt, ob die Seite den Wix Stores Katalog v1 oder v3 nutzt und speichert diese Version in der Verbindung. Der Test muss bestehen, bevor das Fehlen von Produkten als KI-Problem interpretiert wird.

Getrennte Secrets
Der öffentliche Widget-Token wird im benutzerdefinierten Code eingefügt. Der Wix API-Schlüssel bleibt nur im Wavize-Serverformular und darf nie in Wix Custom Code eingefügt werden.

Widget mit benutzerdefiniertem Code veröffentlichen

Ihr Wix-Tarif und Ihre Domain müssen das Hinzufügen von benutzerdefiniertem Code erlauben.

1. Wavize-Block kopieren

   Im Assistenten > Installation kopieren Sie das komplette Skript, das an Ihre öffentliche Wix-Domain gebunden ist. Ersetzen Sie den Token nicht durch den Commerce API-Schlüssel.

2. In Wix hinzufügen

   Im Wix-Dashboard öffnen Sie Einstellungen > Erweitert > Benutzerdefinierter Code, fügen den Block im Body ein und wählen alle gewünschten Seiten. Nach dem Speichern wird die Seite veröffentlicht.

3. Cookie-Einwilligung und Domain beachten

   Aktivieren Sie den Code gemäß Ihrer Cookie-Richtlinie und testen Sie die finale URL. Eine kostenlose Wix-Domain und eine benutzerdefinierte Domain sind zwei verschiedene Hosts für die Wavize-Kontrolle.

Dedizierten Wix API-Schlüssel erstellen

Im Wix-Kontodashboard öffnen Sie Kontoeinstellungen > API-Schlüssel und erstellen einen Schlüssel, beschränkt auf die nötige Site und Berechtigungen.

1. Name und Umfang

   Benennen Sie ihn Wavize und wählen Sie die betroffene Site. Vermeiden Sie einen globalen Kontoschlüssel, wenn ein eingeschränkter Bereich möglich ist.

2. Commerce-Lese-Berechtigungen

   Erteilen Sie Lesezugriff auf Katalog/Produkte und eCommerce-Bestellungen. Wix-Bezeichnungen können sich zwischen Katalog v1 und v3 ändern; suchen Sie nach Berechtigungen für Business Management / Wix Stores / eCommerce.

3. Einmaliges Kopieren und Rotation

   Speichern Sie den Schlüssel nach der Erstellung sicher. Bei Verlust oder Kompromittierung generieren Sie einen neuen, aktualisieren Wavize, testen und widerrufen den alten.

Genauen Site ID finden

Der Site ID ist weder der Site-Name noch die Domain. Wavize erwartet ein UUID.

• Aus Wix Entwickler-Tools

  Öffnen Sie die Seite im Entwickler-Dashboard oder in der Kontodokumentation und kopieren Sie die ausgewählte Site-ID. Sie sieht aus wie xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

• Verbindung prüfen

  Die Site ID muss zur mit dem Schlüssel autorisierten Site gehören. Ein gültiger Schlüssel eines anderen Sites kann eine Ablehnung oder leeren Katalog verursachen.

• Basis-URL

  Geben Sie die öffentliche HTTPS-Seite in Wavize ein. Sie dient zur Produktlinkerstellung und Identifikation der Verbindung; fügen Sie keine Wix-Editor-URL ein.

Katalogversion und Bestellungen testen

Speichern Sie die Verbindung, klicken auf Test und aktivieren Sie sie, wenn die Kontrolle erfolgreich ist.

1. Erkennung v1/v3

   Wavize fragt verfügbare APIs ab und speichert V1_CATALOG oder V3_CATALOG. Ändern Sie diesen Wert nicht manuell; er hängt vom Wix-Site ab.

2. Produktsuche

   Testen Sie ein veröffentlichtes Produkt mit genauem Namen, Preis und Variante. Ein verborgenes oder nicht verfügbares Produkt kann in der Empfehlung fehlen.

3. Bestellung und E-Mail

   Verwenden Sie eine Testbestellung mit Kunden-E-Mail. Die Antwort bleibt neutral, falls Referenz oder E-Mail nicht matchen, selbst wenn die Bestellung existiert.

Schnelle Wix-Diagnose

Trennen Sie immer Widget-Invisible und Commerce-API-Fehler.

• Widget nicht vorhanden — Prüfen Sie benutzerdefinierten Code, Veröffentlichung, Domain und Einwilligung.
• Test 401 / 403 — Prüfen Sie Schlüssel, Berechtigungen, befugte Site und Site ID.
• Leerer Katalog — Prüfen Sie erkannte Version, veröffentlichte Produkte und Umfang des Schlüssels.