> ## Documentation Index
> Fetch the complete documentation index at: https://pomoc.wenetasystent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<Steps>
  <Step title="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ą.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Przetestuj rozmowę">
    Wpisz dowolną wiadomość w oknie czatu i sprawdź, czy asystent odpowiada.
    Jeśli tak — instalacja jest poprawna!
  </Step>
</Steps>

<Tip>
  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.
</Tip>

## Metoda 2: Konsola przeglądarki (dla zaawansowanych)

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

<Steps>
  <Step title="Otwórz narzędzia deweloperskie">
    Na swojej stronie naciśnij **F12** (lub **Ctrl+Shift+I** / **Cmd+Option+I**).
    Otworzy się panel narzędzi deweloperskich.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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)
  </Step>
</Steps>

## Najczęstsze problemy

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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**.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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`).
  </Accordion>
</AccordionGroup>

<Warning>
  Jeśli po sprawdzeniu wszystkich powyższych punktów widget nadal nie działa, skontaktuj się z nami na **[kontakt@wenet.pl](mailto:kontakt@wenet.pl)** — podaj adres strony i zrzut ekranu z konsoli przeglądarki (zakładka Console), a pomożemy Ci znaleźć problem.
</Warning>