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

# Uniwersalna instalacja (HTML)

> Jak dodać widget Asystent AI do dowolnej strony internetowej

<Frame>
  <iframe width="100%" height="420" src="https://www.youtube.com/embed/srekrAP-rJQ" title="Uniwersalna instalacja (HTML): Osadzenie Asystent AI" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />
</Frame>

Ta instrukcja opisuje uniwersalną metodę dodania widgetu Asystent AI do **dowolnej strony internetowej**. Działa z każdym systemem CMS, kreatorem stron i statycznym HTML-em.

<Note>
  **Nie musisz nic składać ręcznie.** Panel Asystent AI udostępnia **gotowy fragment `<script>`** — skopiuj go jednym kliknięciem ikony kopiowania i wklej na swoją stronę.
</Note>

```html theme={null}
<script async src="https://widget.wenetasystent.ai/?code=TWOJ_KOD"></script>
```

<Tip>
  Gotowy fragment znajdziesz w panelu Asystent AI — przejdź do zakładki **Chatbot** i w sekcji "Umieść chatbota na swojej stronie" kliknij **ikonę kopiowania**. Skopiuje ona **cały fragment `<script>`** z Twoim kodem już w środku — nie musisz podmieniać `TWOJ_KOD` ani samodzielnie budować tagu.
</Tip>

## Jak zainstalować widget

<Steps>
  <Step title="Skopiuj gotowy fragment widgetu">
    Zaloguj się do panelu Asystent AI.
    Przejdź do zakładki **Chatbot** (w sekcji **Konfiguracja** w menu bocznym).
    W sekcji **"Umieść chatbota na swojej stronie"** kliknij **ikonę kopiowania**.
    Skopiuje ona **cały gotowy fragment `<script>`** z Twoim kodem już w środku — nie musisz nic podmieniać ani składać samodzielnie.
  </Step>

  <Step title="Otwórz kod HTML swojej strony">
    Otwórz plik HTML swojej strony w edytorze kodu (np. VS Code, Notepad++) lub w panelu zarządzania hostingiem.
    Jeśli używasz CMS-a — poszukaj opcji typu **"Własny kod"**, **"Custom HTML"**, **"Kod w stopce"** lub **"Footer scripts"**.
  </Step>

  <Step title="Wklej kod tuż przed zamknięciem body">
    Znajdź tag `</body>` na końcu pliku HTML.
    **Tuż przed nim** wklej skopiowany fragment:

    ```html theme={null}
    <script async src="https://widget.wenetasystent.ai/?code=TWOJ_KOD"></script>
    ```

    Wklejasz go w całości — kod widgetu jest już w środku, nic nie podmieniasz.
  </Step>

  <Step title="Zapisz i sprawdź">
    Zapisz plik i odśwież swoją stronę w przeglądarce.
    Widget powinien pojawić się w dolnym rogu strony (pozycja zależy od ustawień w panelu).
  </Step>
</Steps>

<Tip>
  Atrybut `async` w kodzie oznacza, że widget ładuje się w tle i nie spowalnia wyświetlania Twojej strony. Widget pojawi się w ciągu kilku sekund po wejściu na stronę.
</Tip>

## Przykład umieszczenia w HTML

Tak powinien wyglądać koniec Twojego pliku HTML po dodaniu widgetu:

```html theme={null}
    <!-- tutaj treść Twojej strony -->

    <script async src="https://widget.wenetasystent.ai/?code=TWOJ_KOD"></script>
  </body>
</html>
```

## Najczęstsze pytania

<AccordionGroup>
  <Accordion title="Widget otwiera się automatycznie — czy tak powinno być?">
    Tak! Przy **pierwszej wizycie** użytkownika widget automatycznie otwiera się po około 3 sekundach, aby przyciągnąć uwagę odwiedzającego. Po zamknięciu widgetu ustawiane jest ciasteczko (cookie), które zapobiega ponownemu auto-otwarciu przez **15 minut**. W tym czasie użytkownik może otworzyć widget ręcznie, klikając jego ikonę.
  </Accordion>

  <Accordion title="Widget się nie pojawia — co sprawdzić?">
    **Sprawdź kolejno:**

    * Czy wkleiłeś **cały** fragment skopiowany ikoną kopiowania z panelu (razem z kodem w środku)?
    * Czy kod jest wklejony przed tagiem `</body>`, a nie np. w `<head>`?
    * Wyczyść cache przeglądarki (Ctrl+Shift+R lub Cmd+Shift+R)
    * Otwórz stronę w trybie prywatnym (incognito) przeglądarki
  </Accordion>

  <Accordion title="Używam adblocka lub rozszerzenia prywatności">
    Niektóre rozszerzenia przeglądarki (uBlock Origin, Ghostery, AdBlock) mogą blokować skrypty widgetu.

    **Rozwiązanie:** Dodaj `widget.wenetasystent.ai` do wyjątków w ustawieniach rozszerzenia lub otwórz stronę w trybie prywatnym bez rozszerzeń.
  </Accordion>

  <Accordion title="Mam dedykowaną instrukcję dla mojego CMS-a?">
    Jeśli korzystasz z popularnego systemu (WordPress, Wix, WebWave, Joomla, Drupal, Hostinger), sprawdź nasze dedykowane instrukcje w menu po lewej stronie. Są prostsze i dopasowane do Twojego panelu zarządzania.

    Ta uniwersalna instrukcja sprawdzi się jako metoda zapasowa lub dla mniej popularnych systemów.
  </Accordion>

  <Accordion title="Czy mogę dodać widget na kilka stron?">
    Tak — użyj **tego samego kodu** na każdej stronie, gdzie chcesz mieć widget. Jeśli Twoja strona korzysta ze wspólnego szablonu (np. `footer.php`, `layout.html`), wystarczy dodać kod raz w szablonie, a widget pojawi się na wszystkich podstronach.
  </Accordion>
</AccordionGroup>

## Gotowy kod do skopiowania

Najprościej skopiować gotowy fragment prosto z panelu (zakładka **Chatbot** → ikona kopiowania). Fragment będzie wyglądał tak — z Twoim kodem w miejscu `TWOJ_KOD`:

```html theme={null}
<!-- Asystent AI widget -->
<script async src="https://widget.wenetasystent.ai/?code=TWOJ_KOD"></script>
```

<Note>
  Kopiując fragment ikoną w panelu, dostajesz go **w całości i gotowy** — z Twoim rzeczywistym kodem już w środku. Nie musisz nic podmieniać.
</Note>
