Rozwiązywanie problemów
Ostatnia aktualizacja:
Dla operatorów warsztatów i kierowników technicznych. Poprzednie:
Znajdź komunikat, który widzisz na ekranie, a następnie postępuj zgodnie z odpowiednimi krokami w odpowiedniej tabeli. Wiadomości są przechowywane po angielsku, więc można je dopasować do interfejsu.
Szybkie sprawdzenia
Zanim rozwiążesz konkretny problem:
- Sprawdź, czy działasz we właściwym warsztacie.
- Otwórz ** PrestaKick AI → połączenie** w module.
- Sprawdź status Connected.
- Jeśli właśnie zmieniłeś konfigurację, wybierz Save configuration.
- Otwórz → logach Crona i sprawdź ostatni run.
- Na Dashboardzie sprawdź status Healthy, Degraded, Offline lub Unknown.
- Spróbuj ponownie w oknie incognito, aby wykluczyć stare dane w przeglądarce.
Błąd połączenia modułu
| Przekaz lub objaw | Przyczyna wspólna | Co robić |
|---|---|---|
| API connection required | Moduł nie łączy się lub nie wywołuje API | Otwórz Connection, połącz się ponownie i wybierz Save configuration |
| Not connected | OAuth niekompletny lub nierozłączony | Wybierz Connect with PrestaKick, wybierz odpowiedni sklep i potwierdź |
| Connected ale Features nadal zgłasza błąd | Niezapisane ustawienia, nieprawidłowy adres URL lub brak dostępu do Internetu wychodzącego | Zapisz ustawienia, sprawdź https://api.prestakick.com, a potem użyj Test connection |
| Connection failed / Connection test failed | Brakujące informacje lub niedostępne API | Sprawdź Module Secret, API Base URL, Shop ID i łączność sieciową |
| Invalid API Base URL format |
Nie przesyłaj sekretów modułu ani kluczy API w żądaniach wsparcia.
Błąd OAuth
| Wiadomość | Co robić |
|---|---|
| Invalid connection request | Zamknij aktualną stronę i zacznij od Connect with PrestaKick w module |
| OAuth connection token has expired | Zacznij od nowa od modułu; Stary link wygasł |
| OAuth connection token has already been used | Nie otwieraj ponownie starego linku; rozpocznij nowy przepływ połączenia |
| Shop is already connected to another PrestaShop URL | Sprawdź stare i nowe adresy URL, zanim zdecydujesz się na ponowne połączenie |
| Only the shop owner can connect this shop | Zaloguj się na konto właściciela lub poproś właściciela o to |
| No unconnected shops | Załóż warsztat lub ponownie połącz istniejący, jeśli tak zamierzasz |
Otwieraj tylko jeden proces OAuth naraz.
Moduł offline lub synchronizacja brakuje danych
| Zjawisko | Jak sobie z tym radzić |
|---|---|
| Raporty modułowe Offline | Sprawdź, czy moduł jest włączony, czy cron działa i czy serwer ma dostęp do Internetu |
| Raporty modułowe Degraded | Otwórz Zadania Cron → logach, sprawdź powtarzające się błędy i kolejkę, a następnie monitoruj, czy status się przywróci |
| Moduł raportuje Unknown po nowym połączeniu | Poczekaj kilka minut i raz uruchom Cron |
| Stare lub brakujące dane z panelu | Sprawdź status modułu i otwórz Data sync, aby poprosić o resynchronizację |
| Manual sync is rate limited to once per hour per entity type | Poczekaj na upływ limitu czasu, zanim ponownie uruchomisz typ danych |
| Raporty o zadaniach synchronizacji Failed | Otwórz szczegóły, rozwiąż przyczynę, a następnie uruchom zadanie ponownie |
| Unauthorized: Invalid or missing API Key | Sprawdź klucz Store API, wybierz Save configuration lub ponownie połącz się za pomocą OAuth |
| Unauthorized: invalid or missing cron token. |
Widżet się nie pojawia
Sprawdź w tej kolejności:
- Show Widget włączony, albo testowy adres IP znajduje się w Preview IPs.
- Wybrałeś Save configuration.
- Aktualna domena znajduje się w Allowed storefront domains.
- Moduł nie jest w Offline stanie.
- Przeglądarka nie korzysta ze starego JavaScriptu; Spróbuj twardego odświeżania lub okna incognito.
- Jeśli test odbywa się przez telefon, Show on Mobile jest włączony.
| Wiadomość | Co robić |
|---|---|
| Widget origin is not allowed for this shop | Właściciel dodaje właściwą nazwę domeny w ustawieniach → Domeny i dostęp, a następnie wybiera Save rules |
| Invalid widget key | Ponownie podłącz OAuth lub zaktualizuj nowy klucz widgetu w obecnej konfiguracji |
| Failed to save widget configuration | Sprawdź połączenie, uprawnienia i limity planów, a potem zapisz ponownie |
| Upgrade to Starter or higher to allow image uploads | Ulepsz do poziomu startowego lub wyższego, albo wyłącz Allow image uploads |
Czat i asystenci AI
| Przekaz lub objaw | Co robić |
|---|---|
| Czat się otwiera, ale AI nie odbiera | Sprawdź kwoty, status modułów, zsynchronizowane dane i powiadomienia o usługach |
| You are sending messages too fast... | Poczekaj kilka sekund, a potem zgłoś ponownie |
| AI credits have been exhausted | Właściciele kupują więcej kredytów, ulepszają plan lub czekają na nowy limit |
| Too many requests. Please try again later | Poczekaj i spróbuj ponownie; Jeśli dzieje się to często przy prawdziwym ruchu, skontaktuj się z pomocą techniczną |
| Service is temporarily unavailable | Spróbuj później ponownie; agenci mogą przejmować rozmowy, jeśli skrzynka odbiorcza jest nadal aktywna |
| Asystent udziela ogólnej odpowiedzi | Sprawdź opisy produktów, strony polityk, instrukcje synchronizacji i Asystenta |
| Message could not be sent. | Sprawdź połączenie i spróbuj ponownie |
| Could not send the image. | Sprawdź format obrazu, rozmiar pliku oraz czy plan pozwala na przesyłanie obrazów |
Logowanie i bezpieczeństwo
| Wiadomość | Co robić |
|---|---|
| Invalid credentials | Sprawdź e-mail, hasło i Caps Lock; Użyj Forgot password, jeśli zajdzie taka potrzeba |
| Account is not verified | Otwórz e-mail weryfikacyjny lub poproś o ponowne przesłanie linku |
| Account is suspended or locked | Skontaktuj się z pomocą techniczną przez oficjalne kanały |
| TOTP code is required | Wprowadź sześciocyfrowy kod z aplikacji uwierzytelniającej |
| TOTP code is invalid | Poczekaj na nowy kod i sprawdź, czy telefon automatycznie ustawia czas |
| Refresh token has expired | Zaloguj się ponownie do Dashboardu |
| Niepełna czuła operacja | Sprawdź swoją rolę i dokonuj ponownej weryfikacji |
| You need an active shop membership... | Sprawdź wybrany sklep i status członkostwa |
Jeśli stracisz urządzenie uwierzytelniające, użyj nieużywanego kodu odzyskiwającego. Nie wysyłaj kodów TOTP ani odzyskiwania innym osobom.
Plany i ograniczenia
| Wiadomość | Co robić |
|---|---|
| Image search is not available on the current plan | Ulepsz do Starter lub wyższy, albo wyłącz tę funkcję |
| Recommendations are not available on the current plan | Zaktualizuj do Launch lub wyższej, albo wyłącz rekomendacje |
| The monthly recommendation request quota has been reached | Poczekaj na kolejny okres limitowy lub zaktualizuj plan |
| Current usage exceeds the selected plan limits | Zmniejsz zużycie poniżej limitu lub wybierz inny plan |
| Your current plan does not allow connecting another shop | Zaktualizuj swój plan lub skorzystaj ze sklepu w ramach swoich obecnych limitów |
| Image storage quota exceeded | Usuń niepotrzebne dane, jeśli jest odpowiednia opcja, lub zaktualizuj plan |
Kiedy potrzebujesz skontaktować się z pomocą techniczną
Przygotowanie:
- Nazwa sklepu i domena strony internetowej.
- Pełny zrzut ekranu komunikatu o błędzie.
- Czas zdarzenia, wraz ze strefą czasową.
- Kroki właśnie podjęte.
- Czy błąd dotyczy wszystkich, czy tylko jednego konta, urządzenia lub adresu IP.
- Odpowiedni rekord w Cron Jobs → Logs, jeśli dotyczy.
Nie wysyłaj haseł, kodów TOTP, kodów odzyskiwania, sekretów modułów, kluczy API, kluczy widgetów ani tokenów cron.
Zobacz więcej
- [PrestaShop modułu (./prestashop-module.md)