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

# Google Tag Manager: Osadzenie Asystent AI

> Jak dodać widget Asystent AI przez Google Tag Manager w kilku prostych krokach

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

<Note>
  **Dla kogo jest ta metoda?** Jeśli już używasz Google Tag Manager (GTM) do zarządzania kodami na stronie, możesz przez niego dodać widget Asystent AI.
</Note>

## Wymagania

* Musisz mieć założone konto w **Google Tag Manager**
* Kontener GTM musi być już zainstalowany na Twojej stronie
* Musisz mieć uprawnienia do dodawania tagów i publikowania zmian

<Warning>
  **Nie wiesz, co to Google Tag Manager?** Ta metoda jest dla zaawansowanych użytkowników. Jeśli nie korzystasz z GTM, sprawdź prostszą instrukcję dla swojej platformy: [WordPress](wordpress), [WebWave](webwave), [Hostinger](hostinger), [Wix](wix).
</Warning>

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

## Szybki start

<Steps>
  <Step title="Zaloguj się do Google Tag Manager">
    Przejdź na [tagmanager.google.com](https://tagmanager.google.com)
    Wybierz odpowiedni kontener (Twoją stronę)
  </Step>

  <Step title="Utwórz nowy tag">
    Kliknij **Tags** (Tagi) w lewym menu
    Kliknij **New** (Nowy) → nadaj nazwę, np. "Asystent AI Widget"
  </Step>

  <Step title="Wybierz typ tagu">
    Kliknij w pole **Tag Configuration** (Konfiguracja tagu)
    Wybierz **Custom HTML** (Własny kod HTML)
  </Step>

  <Step title="Wklej kod">
    W polu HTML wklej poniższy kod (podmień `TWOJ_KOD` na swój kod z panelu):

    ```html theme={null}
    <script>
      (function() {
        if (window.__asystentCloudLoaded) return;
        window.__asystentCloudLoaded = true;

        var s = document.createElement('script');
        s.async = true;
        s.src = 'https://widget.wenetasystent.ai/?code=TWOJ_KOD';
        document.body.appendChild(s);
      })();
    </script>
    ```
  </Step>

  <Warning>
    Nie zaznaczaj opcji "Support document.write" w ustawieniach tagu — nie jest potrzebna i może powodować problemy.
  </Warning>

  <Step title="Ustaw trigger (wyzwalacz)">
    Kliknij w pole **Triggering** (Wyzwalanie)
    Wybierz **All Pages** (Wszystkie strony)
    To sprawi, że widget pojawi się na całej stronie
  </Step>

  <Step title="Zapisz tag">
    Kliknij **Save** (Zapisz) w prawym górnym rogu
  </Step>

  <Step title="Przetestuj i opublikuj">
    Kliknij **Preview** (Podgląd) w górnym menu GTM. Otworzy się Twoja strona z panelem debugowania GTM na dole.

    Sprawdź:

    * W sekcji **"Tags Fired"** powinien pojawić się Twój tag z widgetem
    * Jeśli tag jest w **"Tags Not Fired"** — sprawdź ustawienia triggera
    * Widget powinien pojawić się w dolnym rogu strony

    Wróć do GTM i kliknij **Submit** (Prześlij) → **Publish** (Opublikuj)
  </Step>
</Steps>

<Tip>
  Pamiętaj, aby **opublikować** zmiany! Sam podgląd nie sprawi, że widget będzie widoczny dla odwiedzających.
</Tip>

## Najczęstsze problemy

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

    * Czy opublikowałeś kontener? (Preview nie wystarczy!)
    * Czy podmieniłeś `TWOJ_KOD` na prawdziwy kod z panelu?
    * Trigger musi być ustawiony na **All Pages** (Wszystkie strony)
    * Wyczyść cache przeglądarki (Ctrl+Shift+R lub Cmd+Shift+R)
    * 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 przez GTM
    * Raz bezpośrednio na stronie (w kodzie HTML lub przez inną wtyczkę)

    **Rozwiązanie:** Usuń jedną z tych instancji. Kod `window.__asystentCloudLoaded` w naszym snippecie zabezpiecza przed duplikatami w GTM.
  </Accordion>

  <Accordion title="Nie mogę opublikować — brak uprawnień">
    Jeśli widzisz błąd o braku uprawnień:

    * Poproś administratora konta GTM o nadanie Ci uprawnień do publikowania
    * Lub poproś administratora o opublikowanie Twoich zmian
  </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>

  <Accordion title="Widget zablokowany przez Content Security Policy (CSP)">
    Jeśli w konsoli przeglądarki (F12) widzisz błąd "Refused to load the script":

    * Dodaj `widget.wenetasystent.ai` do dozwolonych źródeł skryptów w nagłówkach CSP (`script-src`)
    * Skontaktuj się z administratorem serwera, jeśli nie masz dostępu do konfiguracji CSP
  </Accordion>
</AccordionGroup>

## Jak usunąć widget?

<Steps>
  <Step title="Znajdź tag w GTM">
    Przejdź do **Tags** → znajdź tag "Asystent AI Widget"
  </Step>

  <Step title="Wstrzymaj lub usuń tag">
    **Opcja 1:** Kliknij tag → **Pause** (Wstrzymaj) — tag nie będzie się uruchamiał
    **Opcja 2:** Usuń tag całkowicie (ikona kosza)
  </Step>

  <Step title="Opublikuj zmiany">
    Kliknij **Submit** → **Publish**
  </Step>
</Steps>

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

## Gotowy kod do skopiowania

```html theme={null}
<!-- Asystent AI widget przez GTM -->
<script>
  (function() {
    // Zabezpieczenie przed podwójnym załadowaniem
    if (window.__asystentCloudLoaded) return;
    window.__asystentCloudLoaded = true;

    // Podmień TWOJ_KOD na swój kod z panelu
    var s = document.createElement('script');
    s.async = true;
    s.src = 'https://widget.wenetasystent.ai/?code=TWOJ_KOD';
    document.body.appendChild(s);
  })();
</script>
```

<Info>
  **Pamiętaj!** Podmień `TWOJ_KOD` na swój rzeczywisty kod widgetu z panelu Asystent AI!
</Info>