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

# Instalacja widgetu

> Zainstaluj widżet czatu Revol na swojej stronie internetowej

## Szybka instalacja

Dodaj ten skrypt przed zamykającym tagiem `</head>` na swojej stronie:

```html theme={null}
<script src="https://revol-ai.app/tracker.js"
        data-api-key="YOUR_API_KEY"
        data-company-id="YOUR_COMPANY_ID"
        async>
</script>
```

Ten skrypt obsługuje zarówno **widżet czatu**, jak i **śledzenie odwiedzających** — nie jest potrzebny żaden dodatkowy kod.

## Konfiguracja

| Atrybut           | Wymagany | Opis                       |
| ----------------- | -------- | -------------------------- |
| `data-api-key`    | Tak      | Twój klucz API widżetu     |
| `data-company-id` | Tak      | Identyfikator Twojej firmy |

<Tip>
  Klucz API i identyfikator firmy znajdziesz w **Panelu administracyjnym** → **Ustawienia ogólne**.
</Tip>

## Co zostaje załadowane

Skrypt trackera automatycznie:

1. **Inicjalizuje śledzenie** — sesje, odsłony stron, zdarzenia
2. **Ładuje widżet** — przycisk czatu z Twoim spersonalizowanym wyglądem
3. **Leniwie ładuje moduły** — wyzwalacze, nakładki, podmiana numerów (tylko gdy są potrzebne)

## Shadow DOM

Widżet renderuje się wewnątrz kontenera **Shadow DOM**, co oznacza:

* CSS Twojej strony nie wpłynie na widżet
* CSS widżetu nie wpłynie na Twoją stronę
* Pełna izolacja stylów

## Aplikacje Single Page (SPA)

Tracker automatycznie wykrywa zmiany adresów URL poprzez zdarzenia `pushState` i `popstate`. Nie jest potrzebna dodatkowa konfiguracja dla aplikacji React, Vue ani Angular.