Instalacja na stronie

Gdy agent jest zaindeksowany, dodanie go do strony to jeden tag skryptu. Znajdź swój fragment w Widżet → Skrypt.

Fragment do osadzenia

Wklej to tuż przed zamykającym tagiem </body> na każdej stronie, gdzie chcesz pokazać widżet czatu:

<script
  src="https://botchata.net/api/widget.js"
  data-api-key="YOUR_KEY"
  data-api-url="https://botchata.net/api"
  defer
></script>

Widżet ładuje się asynchronicznie (defer) i nie spowalnia strony. Renderuje się wewnątrz Shadow DOM, więc nie koliduje z CSS Twojej strony.

Instrukcje dla platform

Platforma	Gdzie wkleić
WordPress	Appearance → Theme File Editor → `footer.php`, przed `</body>` (lub wtyczka do skryptów header/footer)
Shopify	Online Store → Themes → Edit code → `theme.liquid`, przed `</body>`
Wix	Settings → Custom Code → Add Custom Code → „Body - end"
Squarespace	Settings → Advanced → Code Injection → Footer
Webflow	Project Settings → Custom Code → Footer Code
Tilda	Ustawienia witryny → Więcej → Kod HTML dla `<body>`
Własny HTML	Bezpośrednio przed `</body>` w szablonie

Dodaj skrypt do każdej strony (zwykle do wspólnej stopki/szablonu), nie tylko do strony głównej, aby widżet był dostępny wszędzie.

Sprawdź, czy działa

Przeładuj stronę — dymek czatu powinien pojawić się w prawym dolnym rogu.

Nie widać go? Wyświetl źródło strony (Ctrl+U) i potwierdź, że tag skryptu jest obecny, a data-api-key nie jest pusty. Sprawdź konsolę przeglądarki pod kątem błędów i upewnij się, że skrypt nie jest blokowany przez blokadę treści.

Przekazywanie tożsamości odwiedzającego (opcjonalnie)

Jeśli Twoja strona już wie, kto jest odwiedzającym (jest zalogowany), przekaż jego imię i e-mail, aby bot witał go po imieniu i wypełniał formularze kontaktu oraz rezerwacji:

<script
  src="https://botchata.net/api/widget.js"
  data-api-key="YOUR_KEY"
  data-api-url="https://botchata.net/api"
  data-user-name="Jan Kowalski"
  data-user-email="jan@example.com"
  defer
></script>

Renderuj te atrybuty po stronie serwera ze swojego systemu uwierzytelniania. Wartości są przekazywane do AI jako kontekst zidentyfikowanego odwiedzającego.

Utrzymywanie sesji

Widżet pamięta rozmowę każdego odwiedzającego przez 48 godzin (w obrębie przeglądarki). Gdy wraca lub przechodzi na inną stronę, poprzednia rozmowa i historia wiadomości są przywracane automatycznie.

Sesje są przechowywane w localStorage przeglądarki, z zakresem na klucz API — więc jeśli masz więcej niż jednego bota na tej samej stronie, ich rozmowy nigdy się nie mieszają. Odwiedzający zawsze może zacząć od nowa przyciskiem „Nowa rozmowa" w nagłówku widżetu.

Wiele botów na jednej stronie

Możesz umieścić więcej niż jeden skrypt widżetu na tej samej stronie (np. bot sprzedaży i bot wsparcia), każdy z własnym data-api-key. Działają niezależnie i prowadzą osobne rozmowy.

Usuwanie widżetu

Usuń tag skryptu z szablonu. Widżet zniknie przy następnym załadowaniu strony — nie ma nic więcej do posprzątania.