Sprawdzanie poprawności instalacji

Jak sprawdzić czy widget Asystent AI działa poprawnie na Twojej stronie

Po dodaniu kodu widgetu na stronę warto upewnić się, że wszystko działa poprawnie. Poniżej znajdziesz dwie metody weryfikacji — prostą (wizualną) i zaawansowaną (przez konsolę przeglądarki).

Metoda 1: Sprawdzenie wizualne

Najszybszy sposób na weryfikację. Nie wymaga żadnej wiedzy technicznej.

1. Otwórz stronę w trybie incognito

   Otwórz nowe okno przeglądarki w trybie prywatnym (incognito):

   • Chrome / Edge: Ctrl+Shift+N (Windows) lub Cmd+Shift+N (Mac)
   • Firefox: Ctrl+Shift+P (Windows) lub Cmd+Shift+P (Mac)
   • Safari: Cmd+Shift+N

   Wpisz adres swojej strony i wejdź na nią.

2. Poczekaj na pojawienie się widgetu

   Widget powinien pojawić się w dolnym rogu strony (pozycja zależy od ustawień w panelu). Po około 3 sekundach widget automatycznie się otworzy — zobaczysz dymek z powitaniem.

3. Przetestuj rozmowę

   Wpisz dowolną wiadomość w oknie czatu i sprawdź, czy asystent odpowiada. Jeśli tak — instalacja jest poprawna!

Tryb incognito jest ważny, bo zapewnia “czystą” wizytę — bez ciasteczek z poprzednich testów. Dzięki temu widget zachowa się tak, jak dla nowego odwiedzającego.

Metoda 2: Konsola przeglądarki (dla zaawansowanych)

Jeśli widget się nie pojawia, konsola przeglądarki pomoże znaleźć przyczynę problemu.

1. Otwórz narzędzia deweloperskie

   Na swojej stronie naciśnij F12 (lub Ctrl+Shift+I / Cmd+Option+I). Otworzy się panel narzędzi deweloperskich.

2. Sprawdź zakładkę Console

   Przejdź do zakładki Console. Poszukaj błędów (czerwone komunikaty) związanych z widget.wenetasystent.ai. Jeśli nie ma żadnych błędów — to dobry znak.

3. Sprawdź zakładkę Network

   Przejdź do zakładki Network i odśwież stronę (F5). W filtrze wpisz widget.wenetasystent.ai. Powinieneś zobaczyć request (żądanie) do widget.wenetasystent.ai/?code=....

   • Status 200 — widget załadował się poprawnie
   • Status 404 — nieprawidłowy kod widgetu (sprawdź czy kod ma 8 znaków)

Najczęstsze problemy

Widget się nie pojawia

Sprawdź po kolei:

1. Czy kod widgetu jest poprawny? Powinien mieć dokładnie 8 znaków. Znajdziesz go w panelu Asystent AI w zakładce Chatbot → “Umieść chatbota na swojej stronie”.
2. Wyczyść cache strony — jeśli Twoja strona korzysta z systemu cache (np. wtyczka WordPress, Cloudflare), wyczyść go i sprawdź ponownie.
3. Wyczyść cache przeglądarki — naciśnij Ctrl+Shift+R (Windows) lub Cmd+Shift+R (Mac), aby wymusić pełne odświeżenie strony.
4. Sprawdź, czy nie masz zainstalowanego ad blockera lub rozszerzenia prywatności (uBlock Origin, Ghostery, AdBlock). Takie rozszerzenia mogą blokować ładowanie widgetu.

Widget pojawia się z opóźnieniem

To normalne zachowanie. Widget ładuje się asynchronicznie (atrybut async w kodzie), co oznacza, że nie blokuje wyświetlania Twojej strony, ale może potrzebować kilku sekund na załadowanie. Jest to zamierzone — Twoja strona ładuje się szybko, a widget dołącza w tle.

Widget pojawił się raz i zniknął

Widget automatycznie otwiera się po 3 sekundach przy pierwszej wizycie na stronie. Po zamknięciu ustawiane jest ciasteczko, które zapobiega ponownemu auto-otwarciu przez 15 minut. W tym czasie ikona widgetu jest widoczna w rogu strony — wystarczy ją kliknąć, aby otworzyć czat ręcznie.

Aby ponownie zobaczyć auto-otwarcie, otwórz stronę w nowym oknie incognito.

W konsoli widzę błąd 404

Błąd 404 oznacza, że podany kod widgetu nie istnieje. Sprawdź:

• Czy skopiowałeś kod poprawnie (8 znaków, bez spacji)?
• Czy nie zostawiłeś domyślnego TWOJ_KOD zamiast prawdziwego kodu?
• Wróć do panelu Asystent AI → zakładka Chatbot → “Umieść chatbota na swojej stronie” i skopiuj kod ponownie.

W konsoli widzę błędy CORS lub blocked script

Może to być spowodowane przez:

• Rozszerzenie przeglądarki blokujące skrypty zewnętrzne — wyłącz ad blockera lub otwórz stronę w trybie incognito.
• Content Security Policy (CSP) na Twojej stronie — jeśli Twoja strona ma skonfigurowane nagłówki CSP, dodaj widget.wenetasystent.ai do dozwolonych źródeł skryptów (script-src).

Jeśli po sprawdzeniu wszystkich powyższych punktów widget nadal nie działa, skontaktuj się z nami na [e-mail] — podaj adres strony i zrzut ekranu z konsoli przeglądarki (zakładka Console), a pomożemy Ci znaleźć problem.