Podłączenie Wix

Zanim zaczniesz: czy w ogóle dasz radę

To najtrudniejsza z naszych integracji i nie chcemy udawać, że jest inaczej.

Krótka odpowiedź: da się, i nie trzeba do tego zostawać programistą Wix. Nie zakładasz żadnego konta deweloperskiego, nie zgłaszasz aplikacji, nie piszesz ani linijki kodu. Ale to nie są trzy kliknięcia i nie chcemy, żebyś się o tym dowiedział w połowie. Poniżej cztery rzeczy, które trzeba wiedzieć, zanim zaczniesz.

Klucz musi wygenerować właściciel konta Wix. Współwłaściciel też umie taki klucz utworzyć, ale Wix odrzuca go przy wywołaniach na poziomie witryny, czyli przy wszystkim, co robimy. Jeżeli logujesz się na zaproszenie od kogoś innego, na przykład od agencji prowadzącej Ci stronę, tej instrukcji nie da się dokończyć i nie ma na to obejścia. Poproś właściciela konta, żeby przeszedł przez nią za Ciebie i przekazał Ci dwie wartości z końca.
To jest czternaście kroków w panelu Wix, nie trzy. Dziesięć na sam klucz i cztery na identyfikator witryny, w dwóch różnych miejscach panelu. Wix nie ma przycisku „połącz z aplikacją”, który zrobiłby to za Ciebie: klucz API generuje się ręcznie, uprawnienia zaznacza ręcznie, potwierdza kodem SMS, a identyfikator witryny wypisuje z adresu przeglądarki. Zajmuje to około kwadransa.
Klucz zobaczysz jeden raz. Wix pokazuje go w okienku po wygenerowaniu i nigdy więcej. Jeśli zamkniesz okno bez skopiowania, klucz jest bezpowrotnie stracony i trzeba wygenerować nowy.
Ten klucz to poważne uprawnienie. Klucz API Wix działa na poziomie konta i domyślnie sięga do wszystkich witryn. W kroku o dostępie do witryn pokazujemy, jak zawęzić go do jednej strony, i zdecydowanie prosimy, żebyś to zrobił. My potrzebujemy tylko tej jednej.

Co dostaniesz, a czego Wix nie umie

API bloga Wix jest węższe niż WordPress i nie zamierzamy sugerować, że jest inaczej. To jest pełna lista.

Co trafi na Twojego bloga

Tytuł wpisu.
Całą treść artykułu, z nagłówkami, akapitami, listami i odnośnikami. Wix przekształca ją do swojego własnego formatu po swojej stronie.
Zajawkę, czyli krótki opis widoczny na liście wpisów.
Zdjęcie główne, zaimportowane do Twojego Menedżera multimediów.
Kategorie, o ile podasz ich identyfikatory i o ile już istnieją na blogu.
Publikację od razu albo zostawienie wpisu jako szkicu do Twojej akceptacji.

Czego nie ustawimy, bo API tego nie przyjmuje

Tytułu SEO i opisu SEO. W dokumentacji API pola „seoData” po prostu nie ma w tym, co można wysłać, a w odpowiedzi jest oznaczone jako tylko do odczytu. Wix buduje opis z zajawki, którą wysyłamy, i to jest cały nasz wpływ na tę rubrykę.
Adresu wpisu. Wix układa go sam z tytułu. Pola „slug” nie da się wysłać.
Tworzenia nowych kategorii. Umiemy wpiąć wpis w kategorię, która już jest, ale nie umiemy jej założyć.

Piszemy to wprost, bo wygodniej byłoby przemilczeć. Jeżeli w Twojej pracy nad widocznością liczy się ręczne ustawianie tytułu SEO na każdym wpisie, Wix tego nie odda, a my nie umiemy tego obejść.

Czego potrzebujesz

Dostępu do konta Wix jako jego właściciel.
Telefonu, na który Wix wyśle kod weryfikacyjny SMS przy generowaniu klucza.
Bloga Wix dodanego do witryny. Jeśli na stronie nie ma jeszcze bloga, dodaj go w edytorze, zanim zaczniesz; bez niego klucz nie będzie miał czego obsłużyć.
Kwadransa spokoju, bo klucza nie da się zapisać w połowie i wrócić do niego później.

Krok po kroku: klucz API

Zaloguj się na Wix na koncie właściciela.
Wejdź na manage.wix.com/account/api-keys. To jest Menedżer kluczy API. Można tam też dojść przez ustawienia konta, ale adres jest pewniejszy niż szukanie pozycji w menu.
Na tej stronie widnieje też identyfikator konta. Nam nie jest potrzebny, więc go pomiń; podamy tylko identyfikator witryny.
Kliknij przycisk generowania nowego klucza.
Nadaj kluczowi nazwę, po której go poznasz, na przykład „AgentsHub SEO”.
Zaznacz uprawnienia. To najważniejszy krok i najczęstsze miejsce, w którym coś się gubi. Potrzebujemy trzech, a przy sklepie czterech. Lista jest poniżej.
Ustaw dostęp do witryn. Wybierz opcję dla wskazanych witryn i dodaj tylko tę jedną stronę, na której mamy publikować. Opcja „wszystkie witryny” też zadziała, ale daje kluczowi więcej, niż potrzebuje.
Zatwierdź. Wix poprosi o kod weryfikacyjny wysłany SMS-em.
Skopiuj klucz z okienka, które się pokaże, i wklej go od razu w bezpieczne miejsce. Zobaczysz go tylko ten jeden raz.
Zamknij okienko dopiero wtedy, gdy klucz masz skopiowany.

Co ma być widoczne: Menedżer kluczy API na manage.wix.com/account/api-keys, z widocznym przyciskiem generowania nowego klucza i listą kluczy już istniejących.

Uprawnienia do zaznaczenia

Lista uprawnień w panelu Wix jest pogrupowana produktami. Poniżej podajemy nazwy tak, jak brzmią w dokumentacji Wix, wraz z tym, do czego każde z nich służy u nas.

Manage Blog - Wymagane. Utworzenie wpisu i jego publikacja. Bez tego nie zrobimy nic.
Manage Ricos Document - Wymagane. Przekształcenie treści artykułu do formatu, w którym Wix trzyma wpisy. To osobne uprawnienie od bloga i najczęściej pomijane. Bez niego połączenie się zestawi, a każdy artykuł polegnie.
Manage Media Manager - Zalecane. Wgranie zdjęcia głównego. Bez tego artykuły wychodzą bez zdjęcia, ale wychodzą.
Read Products, Read Categories - Tylko ze sklepem. Odczyt katalogu Wix Stores, żeby artykuły mogły odsyłać do Twoich produktów. Bez sklepu pomiń.

Gdyby któraś z tych nazw brzmiała w Twoim panelu inaczej, kieruj się opisem w kolumnie obok. Wix zmienia etykiety w interfejsie częściej niż nazwy uprawnień w dokumentacji.

Co ma być widoczne: Okno wyboru uprawnień przy generowaniu klucza, z rozwiniętą grupą bloga i zaznaczonym uprawnieniem zarządzania blogiem.

Co ma być widoczne: Sekcja dostępu do witryn w tym samym oknie, z wybraną opcją wskazanych witryn i jedną stroną na liście.

Co ma być widoczne: Okienko z wygenerowanym kluczem i ostrzeżeniem, że zobaczy się go tylko raz.

Krok po kroku: identyfikator witryny

Drugą rzeczą, której potrzebujemy, jest identyfikator konkretnej strony. Wix nie pokazuje go w żadnym polu, trzeba go odczytać z adresu.

Otwórz panel tej witryny, na której mamy publikować.
Spójrz na adres w przeglądarce. Ma postać manage.wix.com/dashboard/<identyfikator>/home.
Skopiuj to, co stoi zaraz za /dashboard/, aż do następnego ukośnika. To ciąg znaków z myślnikami, wyglądający tak: 3ecba886-4267-11ee-be56-0242ac120002.
Nie kopiuj całego adresu ani adresu z edytora strony. Potrzebujemy samego identyfikatora.

Co ma być widoczne: Pasek adresu przeglądarki na panelu witryny, z zaznaczonym fragmentem identyfikatora zaraz za /dashboard/.

Wklejenie u nas i test

W panelu wybierz dodanie strony i wskaż Wix.
W polu klucza API wklej to, co skopiowałeś z okienka Wix.
W polu identyfikatora witryny wklej ciąg z adresu panelu.
Kliknij sprawdzenie połączenia.

Jeśli wszystko jest na miejscu, zobaczysz potwierdzenie, że połączyliśmy się z Wix, oraz zdanie o tym, czy na stronie jest sklep. Brak sklepu jest w porządku i nie jest błędem.

Jeśli coś nie gra, powiemy które. Sekcja na końcu tej strony tłumaczy każdą z tych odpowiedzi.

Sklep Wix Stores, jeśli go masz

Kiedy na stronie działa Wix Stores, a klucz ma uprawnienia do odczytu produktów i kategorii, umiemy wczytać Twój katalog i pozwolić artykułom odsyłać do konkretnych produktów. Sprawdzamy to sami przy teście połączenia.

Jeśli sklepu nie masz, nic się nie psuje. Napiszemy tylko, że synchronizacja katalogu jest niedostępna, i wszystko inne działa dalej. Strona firmowa z blogiem to normalny przypadek, nie awaria.

Jedno ograniczenie: API Wix nie zwraca adresów stron kategorii sklepowych, więc kategorie zaczytujemy z nazwami i strukturą, ale bez odnośników. Produkty mają swoje adresy normalnie.

Ustawienia dodatkowe

Tryb szkicu. Możesz poprosić, żebyśmy zostawiali wpisy jako szkice zamiast publikować od razu. Wtedy artykuł pojawia się w panelu bloga Wix i czeka, aż go zaakceptujesz. Kolejne poprawki treści też zostają w szkicu.
Kategorie. Podaj identyfikatory kategorii, do których mają trafiać wpisy, a będziemy je przypisywać. Kategorii nieistniejących Wix po cichu nie doda, więc muszą być założone wcześniej na blogu.
Język wpisu. Przy blogu wielojęzycznym możemy oznaczać wpisy kodem języka.

Gdy coś nie działa

Poniżej są odpowiedzi, które faktycznie zobaczysz, i co za każdą z nich stoi.

Wix nie przyjął klucza API. Klucz jest zły, został usunięty albo przy kopiowaniu wszedł dodatkowy znak. Wygeneruj nowy w Menedżerze kluczy API i wklej go jeszcze raz, bez spacji na początku i na końcu.
Wix przyjął klucz, ale odmówił dostępu do tej witryny. Trzy możliwe przyczyny. Klucz został wygenerowany przez współwłaściciela, a nie przez właściciela konta. Albo w dostępie do witryn nie ma tej konkretnej strony. Albo zabrakło uprawnienia Manage Blog. Otwórz klucz w Menedżerze kluczy API i sprawdź po kolei te trzy rzeczy.
Pod tym identyfikatorem nie odpowiedział żaden blog Wix. Albo identyfikator witryny jest nie ten, albo na stronie nie ma bloga Wix. Sprawdź, że skopiowałeś sam ciąg zza /dashboard/, a nie cały adres, i że blog jest faktycznie dodany do strony w edytorze.
Klucz nie umie przekształcić artykułów w treść bloga. To brakujące uprawnienie Manage Ricos Document. Blog odpowiada, ale sama treść nie ma jak powstać. Edytuj klucz w Menedżerze kluczy API i dołóż to uprawnienie obok Manage Blog.
Synchronizacja katalogu jest niedostępna. Albo na stronie nie ma Wix Stores, albo klucz nie ma uprawnień do odczytu produktów i kategorii. Jeśli sklepu nie prowadzisz, tak ma być i nic nie trzeba robić.
Artykuł wyszedł, ale bez zdjęcia. Zdjęcie jest wysyłane osobno i jego niepowodzenie nigdy nie blokuje publikacji. Najczęstsze powody to brak uprawnienia Manage Media Manager albo wyczerpany limit miejsca na multimedia w Twoim planie Wix. Zajrzyj też, czy Menedżer multimediów nie ma pełnego pakietu.
Tytuł SEO, opis SEO albo adres wpisu wyglądają inaczej, niż chciałeś. To nie jest usterka. API bloga Wix nie przyjmuje tych trzech pól, więc Wix ustala je sam: adres z tytułu, opis z zajawki. Zmienić je można wyłącznie ręcznie w panelu bloga Wix, już po publikacji.
Nie przyszedł SMS z kodem przy generowaniu klucza. To jest po stronie weryfikacji dwuetapowej Wix i my nic tu nie poradzimy. Wix odsyła w takim wypadku do własnego wsparcia.
Publikacja przestała działać po kilku miesiącach. Klucze API Wix nie wygasają same, ale można je usunąć albo wymienić w Menedżerze kluczy API, a wtedy stary przestaje działać z minuty na minutę. Sprawdź, czy klucz nadal tam jest i czy nadal ma tę witrynę na liście.

Skąd to wiemy

Wszystko powyżej pochodzi z dokumentacji Wix, a nie z pamięci. Odczytane 23 sierpnia 2026.

Podłącz swój Wix