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

# Wix: Osadzenie Asystent AI

> Jak dodać widget czatu Asystent AI do Twojej strony Wix w kilku prostych krokach

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

<Note>
  **Kod do wklejenia** — podmień `TWOJ_KOD` na swój kod z panelu Asystent AI:
</Note>

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

<Tip>
  Swój kod widgetu znajdziesz w panelu Asystent AI — przejdź do zakładki **Chatbot** i skopiuj 8-znakowy kod z sekcji "Umieść chatbota na swojej stronie".
</Tip>

<Warning>
  **Wymagania:** Aby dodać własny kod przez Custom Code (Metoda 1), potrzebujesz **płatnego planu Wix** z podłączoną własną domeną. Metoda 2 działa na wszystkich planach.
</Warning>

## Metoda 1: Custom Code (ZALECANA) ⭐

Widget pojawi się automatycznie na wszystkich stronach witryny.

<Steps>
  <Step title="Przejdź do ustawień witryny">
    W panelu Wix kliknij **Settings** (Ustawienia) w lewym menu
    Przewiń w dół do sekcji **Advanced** (Zaawansowane)
  </Step>

  <Step title="Otwórz Custom Code">
    Kliknij **Custom Code** (Własny kod)
    Jeśli nie widzisz tej opcji, spróbuj alternatywnej ścieżki: **Settings → Tracking & Analytics → + New Tool → Custom**
    Jeśli widzisz informację o potrzebie płatnego planu - musisz najpierw ulepszyć swój plan lub użyj Metody 2
  </Step>

  <Step title="Dodaj nowy kod">
    Kliknij **+ Add Custom Code** (Dodaj własny kod) w prawym górnym rogu
  </Step>

  <Step title="Wklej kod widgetu">
    W polu tekstowym wklej kod widgetu:

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

    W polu **Name** (Nazwa) wpisz: "Asystent AI Widget"
  </Step>

  <Step title="Wybierz strony">
    W sekcji **Add Code to Pages** wybierz:

    * **All pages** (Wszystkie strony) - zalecane
    * Zaznacz **Load code once** (Załaduj kod raz)
  </Step>

  <Step title="Wybierz miejsce w kodzie">
    W sekcji **Place Code in** wybierz:

    * **Body - end** (Koniec body) - zalecane
  </Step>

  <Step title="Zastosuj i opublikuj">
    Kliknij **Apply** (Zastosuj)
    Wróć do edytora i kliknij **Publish** (Opublikuj) w prawym górnym rogu
    Odśwież swoją stronę — widget powinien się pojawić
  </Step>
</Steps>

<Tip>
  Ta metoda jest najlepsza! Widget automatycznie pojawi się na wszystkich stronach i nie zniknie po zmianach w layoutcie strony.
</Tip>

## Metoda 2: Embed HTML element (dla wszystkich planów)

Ta metoda działa na wszystkich planach Wix, także darmowych.

<Warning>
  **Ograniczenia tej metody:** element Embed HTML to odizolowana ramka (iframe) — widget wyświetla się **wewnątrz niej**, a nie jako pływający dymek nad stroną. Żeby działał poprawnie, trzeba go przypiąć do ekranu i odpowiednio rozciągnąć (kroki poniżej). Element **domyślnie nie wyświetla się w wersji mobilnej** strony (obejście — zobacz "Najczęstsze problemy"). Dodatkowo Wix blokuje w takich ramkach pliki cookie i localStorage, więc widget może nie zapamiętywać rozmowy między podstronami. Jeśli to możliwe, użyj **Metody 1 (Custom Code)**.
</Warning>

<Steps>
  <Step title="Otwórz edytor strony">
    W edytorze Wix kliknij **Add Elements** (Dodaj elementy) - ikona **+** po lewej stronie
  </Step>

  <Step title="Dodaj Embed Code">
    Wybierz **Embed Code** (Osadź kod)
    Kliknij **Popular Embeds** (Popularne osadzenia)
  </Step>

  <Step title="Wybierz Embed HTML">
    Wybierz **Embed HTML**
    Element pojawi się na stronie jako szary prostokąt
  </Step>

  <Step title="Wprowadź kod">
    Kliknij na dodany element
    Kliknij **Enter Code** (Wprowadź kod)
  </Step>

  <Step title="Wklej kod widgetu">
    W polu **Add your code here** (Dodaj swój kod tutaj) wklej:

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

  <Step title="Przypnij element do ekranu">
    Kliknij **Apply** (Zastosuj)
    Kliknij **prawym przyciskiem myszy** na element Embed HTML
    Wybierz **Przypnij do ekranu** (Pin to Screen) i wskaż pozycję — zalecamy **prawy dolny róg**

    Bez przypięcia widget zostanie w miejscu na stronie i będzie przewijał się razem z treścią, zamiast być "przyklejony" do rogu ekranu.
  </Step>

  <Step title="Rozciągnij element na rozmiar okna czatu">
    Zmień rozmiar elementu tak, aby obejmował **całe okno otwartego czatu**, nie tylko ikonę dymka.

    Widget wyświetla się wyłącznie **wewnątrz ramki elementu** — jeśli ramka jest za mała, rozwinięte okno Asystenta będzie obcięte.
  </Step>

  <Step title="Pokaż na wszystkich podstronach">
    Kliknij **prawym przyciskiem myszy** na element
    Wybierz **Pokazuj na wszystkich stronach** (Show on All Pages)

    Bez tego widget pojawi się tylko na tej jednej podstronie.
  </Step>

  <Step title="Opublikuj stronę">
    Kliknij **Publish** (Opublikuj)
    Odśwież swoją stronę — widget powinien być przypięty w wybranym rogu ekranu
  </Step>
</Steps>

<Info>
  **Wersja mobilna:** element Embed HTML dodany w edytorze desktopowym domyślnie nie pojawia się na telefonach. Częściowe obejście przez edytor mobilny opisujemy w "Najczęstsze problemy" poniżej; jedyną pewną drogą jest **Metoda 1 (Custom Code)** — wymaga płatnego planu Wix z własną domeną.
</Info>

## Najczęstsze problemy

<AccordionGroup>
  <Accordion title="Nie widzę opcji Custom Code">
    Opcja **Custom Code** jest dostępna tylko na **dowolnym płatnym planie Wix** z podłączoną własną domeną.

    **Rozwiązanie:**

    * Ulepsz swój plan Wix do płatnej wersji
    * Lub użyj **Metody 2** (Embed HTML element) - ta metoda działa na wszystkich planach, także darmowych
  </Accordion>

  <Accordion title="Widget się nie pojawia">
    **Sprawdź kolejno:**

    * Czy podmieniłeś `TWOJ_KOD` na prawdziwy kod z panelu Asystent AI?
    * Czy opublikowałeś stronę? (samo zapisanie nie wystarczy!)
    * W Custom Code: czy wybrałeś **All pages** i **Body - end**?
    * Wyczyść cache przeglądarki (Ctrl+Shift+R lub Cmd+Shift+R)
    * Otwórz stronę w trybie prywatnym przeglądarki
    * Sprawdź konsolę przeglądarki (F12) — czy nie ma błędów?
  </Accordion>

  <Accordion title="Widget pojawia się dwa razy">
    To oznacza, że masz kod dodany w **dwóch miejscach**:

    * Raz globalnie (w Custom Code)
    * Raz lokalnie (jako element Embed HTML na stronie)

    **Rozwiązanie:** Usuń jedną z tych instancji. Zalecamy zostawić tylko Custom Code (Metoda 1).
  </Accordion>

  <Accordion title="Błąd: Code must use HTTPS">
    Kod Asystent AI już używa HTTPS, więc ten błąd nie powinien wystąpić.

    Jeśli jednak widzisz ten błąd - upewnij się, że wkleiłeś dokładnie ten kod:

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

    Zwróć uwagę na **https\://** na początku.
  </Accordion>

  <Accordion title="Widget jest obcięty / nie mieści się w ramce (Metoda 2)">
    Element Embed HTML to odizolowana ramka (iframe) — widget wyświetla się tylko **wewnątrz niej**. Jeśli ramka jest mniejsza niż otwarte okno czatu, Asystent będzie obcięty.

    **Rozwiązanie:** rozciągnij element tak, aby obejmował całe okno otwartego czatu (sprawdź rozmiar, otwierając czat w podglądzie strony). W Metodzie 1 (Custom Code) ten problem nie występuje — widget pływa swobodnie nad stroną.
  </Accordion>

  <Accordion title="Widget nie jest przypięty do rogu ekranu i przewija się ze stroną (Metoda 2)">
    Element Embed HTML domyślnie jest zwykłym elementem strony — zostaje tam, gdzie go umieścisz, i przewija się z treścią.

    **Rozwiązanie:** kliknij prawym przyciskiem myszy na element → **Przypnij do ekranu** (Pin to Screen) → wybierz pozycję (np. prawy dolny róg). Następnie ponownie prawym przyciskiem → **Pokazuj na wszystkich stronach** (Show on All Pages), aby widget był widoczny na całej witrynie.
  </Accordion>

  <Accordion title="Widget nie pojawia się na telefonie (Metoda 2)">
    Wix **nie przenosi automatycznie** elementów z edytora desktopowego do wersji mobilnej — przypięty element Embed HTML często w ogóle nie pojawia się na telefonach. To ograniczenie edytora Wix, nie widgetu.

    **Spróbuj w edytorze mobilnym:**

    * Przełącz edytor na widok mobilny (ikona telefonu na górnym pasku)
    * Sprawdź panel **ukrytych elementów** (Hidden Elements) — jeśli element tam jest, przywróć jego widoczność
    * Jeśli elementu nie ma wcale, dodaj Embed HTML **jeszcze raz w edytorze mobilnym** z tym samym kodem

    **Jeśli to nie działa:** jedyną pewną drogą jest **Metoda 1 (Custom Code)** — kod dodany przez Settings → Custom Code trafia bezpośrednio do strony i działa na desktopie oraz mobile. Wymaga płatnego planu Wix z podłączoną własną domeną.
  </Accordion>

  <Accordion title="Widget pojawił się raz i zniknął">
    To normalne zachowanie! Widget automatycznie otwiera się przy pierwszej wizycie (po 3 sekundach). Przy kolejnych odwiedzinach w ciągu 15 minut trzeba kliknąć ikonę czatu ręcznie.

    Aby przetestować ponowne auto-otwarcie, otwórz stronę w **nowym oknie prywatnym** (incognito).
  </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>
</AccordionGroup>

## Jak usunąć widget?

**Metoda 1 (Custom Code):**

* Wejdź do **Settings → Advanced → Custom Code**
* Znajdź "Asystent AI Widget"
* Kliknij ikonę trzech kropek (⋯) obok kodu
* Wybierz **Delete** (Usuń)
* Opublikuj stronę

**Metoda 2 (Embed HTML element):**

* Wejdź w tryb edycji podstrony
* Kliknij na element Embed HTML z kodem widgetu
* Naciśnij **Delete** na klawiaturze lub kliknij ikonę kosza
* Opublikuj stronę

Po usunięciu wyczyść cache przeglądarki.

## Gotowy kod do skopiowania

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

<Info>
  Pamiętaj, aby podmienić `TWOJ_KOD` na swój rzeczywisty kod widgetu z panelu Asystent AI!
</Info>

## Dodatkowe informacje

<AccordionGroup>
  <Accordion title="Jakie plany Wix obsługują Custom Code?">
    Funkcja Custom Code jest dostępna na **dowolnym płatnym planie Wix** z podłączoną własną domeną.

    Nazwy planów zmieniają się — ważne, żeby plan był płatny i miała podłączoną własną domenę (np. twoja-firma.pl). **Nie jest dostępna** na darmowym planie z domeną wixsite.com.
  </Accordion>

  <Accordion title="Czy mogę użyć Custom Code bez własnej domeny?">
    Nie. Custom Code wymaga:

    1. Płatnego planu Wix
    2. Podłączonej własnej domeny (np. twoja-firma.pl)

    Jeśli nie masz własnej domeny, musisz użyć **Metody 2** (Embed HTML element).
  </Accordion>

  <Accordion title="Co to znaczy 'Load code once'?">
    Opcja **Load code once** sprawia, że kod ładuje się tylko raz podczas sesji użytkownika, zamiast na każdej podstronie osobno.

    Dla widgetu Asystent AI zalecamy **zaznaczenie tej opcji** - widget załaduje się raz i będzie dostępny na wszystkich stronach, co poprawia wydajność.
  </Accordion>
</AccordionGroup>