Zainstaluj Wavize na Wix

Wix wymaga dwóch konfiguracji: widgetu i sklepu

Własny kod Wix wyświetla widget na stronie. Połączenie handlowe Wix pozwala Wavize odczytywać katalog i zamówienia przez API z bazowym URL, Site ID w formacie UUID i kluczem API. Można zainstalować widget bez połączenia Wix Stores, ale odpowiedzi katalogu i śledzenia nie będą dostępne.

Wavize wykrywa, czy strona korzysta z katalogu Wix Stores v1 czy v3 i zapisuje tę wersję w połączeniu. Test musi się powieść przed interpretacją braku produktów jako problemu AI.

Osobne sekrety
Publiczny token widgetu trafia do kodu niestandardowego. Klucz API Wix pozostaje w formularzu serwerowym Wavize i nigdy nie powinien być wklejany do Wix Custom Code.

Publikacja widgetu z kodem niestandardowym

Twoja oferta Wix i domena muszą pozwalać na dodawanie kodu niestandardowego.

1. Skopiuj blok Wavize

   W Asystencie > Instalacja skopiuj pełny skrypt powiązany z publiczną domeną Wix. Nie zamieniaj tokena na klucz API commerce.

2. Dodaj w Wix

   W panelu Wix otwórz Ustawienia > Zaawansowane > Kod niestandardowy, dodaj blok do ciała strony i wybierz wszystkie żądane strony. Opublikuj po zapisie.

3. Poszanowanie zgody i domeny

   Wyzwalaj kod zgodnie z polityką cookie i testuj ostateczny URL. Darmowa domena Wix i domena niestandardowa to dwa różne hosty do kontroli Wavize.

Utwórz dedykowany klucz API Wix

W panelu konta Wix przejdź do Ustawienia konta > Klucze API i wygeneruj klucz ograniczony do witryny i potrzebnych uprawnień.

1. Nazwa i zakres

   Nazwij go Wavize i wybierz odpowiednią witrynę. Unikaj globalnych kluczy konta, jeśli możliwy jest bardziej ograniczony zakres.

2. Uprawnienia do odczytu e-commerce

   Zezwól na odczyt katalogu/produktów i zamówień eCommerce. Nazwy uprawnień Wix mogą się zmieniać między Katalogiem v1 a v3; szukaj odpowiednich uprawnień Business Management / Wix Stores / eCommerce.

3. Jednorazowe kopiowanie i rotacja

   Skopiuj klucz przy tworzeniu do menedżera haseł. Jeśli zgubiony lub ujawniony, wygeneruj nowy, zaktualizuj Wavize, przetestuj i odwołaj stary.

Znajdź dokładny Site ID

Site ID nie jest nazwą ani domeną strony. Wavize wymaga UUID.

• Z narzędzi deweloperskich Wix

  Otwórz stronę na dashboardzie deweloperskim lub w dokumentacji API konta i skopiuj identyfikator wybranej strony. Ma formę xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

• Weryfikacja powiązania

  Site ID musi należeć do witryny dopuszczonej przez klucz. Niepoprawny klucz innej strony może skutkować odmową lub pustym katalogiem.

• Bazowy URL

  Wpisz publiczną witrynę HTTPS w Wavize. Służy do budowy linków produktowych i identyfikacji połączenia; nie wklejaj URL edytora Wix.

Test katalogu i zamówień

Zapisz połączenie, kliknij Testuj i Aktywuj, jeśli kontrola zakończy się sukcesem.

1. Wykrywanie v1 / v3

   Wavize pyta dostępne API i zapisuje wartość V1_CATALOG lub V3_CATALOG. Nie zmieniaj tego ręcznie, zależy od strony Wix.

2. Wyszukiwanie produktu

   Przetestuj opublikowany produkt z dokładną nazwą, ceną i wariantem. Produkt ukryty lub niedostępny może być pominięty w rekomendacji.

3. Zamówienie i e-mail

   Użyj testowego zamówienia i adresu klienta. Odpowiedź pozostaje neutralna, jeśli numer lub e-mail nie pasuje, nawet jeśli zamówienie istnieje.

Szybka diagnostyka Wix

Zawsze rozdziel niewidoczność widgetu od błędów API e-commerce.

• Brak widgetu — Sprawdź kod niestandardowy, publikację, domenę i zgody.
• Test 401 / 403 — Sprawdź klucz, uprawnienia, uprawnione strony i Site ID.
• Pusty katalog — Sprawdź wykrytą wersję, opublikowane produkty i zakres klucza.