Przejdź do głównej zawartości

Osadzenie skryptem

Jedna linia kodu wystarczy, aby agent pojawił się na stronie.

Pobranie kodu osadzenia

  1. Wejdź do panelu
  2. Wybierz agenta
  3. Otwórz Settings > Integration
  4. Skopiuj kod skryptu

Podstawowa instalacja

Wklej ten kod przed zamykającym tagiem </body>:

<script src="https://leezy.ai/embed.js?chatbot_id=YOUR_CHATBOT_ID"></script>

Zamień YOUR_CHATBOT_ID na identyfikator swojego agenta.

:::tip Gdzie znaleźć identyfikator Identyfikator znajdziesz w Settings > General oraz w zakładce „Integration". :::

Gdzie wkleić kod

Statyczny HTML

Przed </body>:

<!DOCTYPE html>
<html>
<head>
<title>Moja strona</title>
</head>
<body>
<!-- Treść strony -->

<!-- Widżet czatu Leezy -->
<script src="https://leezy.ai/embed.js?chatbot_id=YOUR_CHATBOT_ID"></script>
</body>
</html>

WordPress

Na WordPressie lepiej użyć oficjalnej wtyczki — przetrwa aktualizacje motywu, czego nie da się powiedzieć o zmianie w footer.php.

Jeśli wolisz skrypt, dodaj go wtyczką typu „header and footer scripts", a nie bezpośrednio w footer.php.

Shopify

  1. Wejdź w Online Store > Themes
  2. Kliknij Actions > Edit code
  3. Otwórz theme.liquid
  4. Wklej kod przed </body>

Squarespace

  1. Wejdź w Settings > Advanced > Code Injection
  2. Wklej kod w sekcji Footer

Wix

  1. Wejdź w Settings > Advanced > Custom Code
  2. Wklej kod i ustaw miejsce na „Body – end"

Next.js / React

W głównym layoucie albo w _app.js:

import Script from 'next/script'

export default function RootLayout({ children }) {
return (
<html>
<body>
{children}
<Script
src="https://leezy.ai/embed.js?chatbot_id=YOUR_CHATBOT_ID"
strategy="lazyOnload"
/>
</body>
</html>
)
}

Jak zachowuje się widżet

Po instalacji widżet:

  • pojawia się w prawym dolnym rogu (albo w ustawionym miejscu),
  • otwiera się po kliknięciu przycisku czatu,
  • zachowuje historię rozmowy w trakcie sesji,
  • automatycznie dostosowuje się do urządzeń mobilnych.

Opcje personalizacji

Wygląd widżetu ustawiasz w Settings > Interface:

  • motyw (Light/Dark/System),
  • pozycja (prawy/lewy dolny róg),
  • kolor marki,
  • wiadomość powitalna,
  • nazwa wyświetlana.

Sprawdzenie instalacji

  1. Otwórz stronę w przeglądarce
  2. Poszukaj dymka czatu w rogu
  3. Otwórz go i wyślij wiadomość testową
  4. Sprawdź, czy rozmowa pojawiła się w panelu

Rozwiązywanie problemów

Widżet się nie pojawia

  • Sprawdź konsolę: otwórz narzędzia deweloperskie (F12) i poszukaj błędów
  • Sprawdź identyfikator: czy ID agenta jest poprawne?
  • Sprawdź miejsce wstawienia: skrypt powinien być przed </body>
  • Wyczyść pamięć podręczną: przeglądarka może trzymać starą wersję strony

Widżet się pojawia, ale nie odpowiada

  • Sprawdź status agenta: musi być ustawiony na „Active"
  • Sprawdź dane treningowe: agent musi mieć jakieś źródła
  • Sprawdź limit: być może wyczerpał się limit wiadomości

Konflikty stylów

  • Sprawdź CSS, który dotyczy wszystkich przycisków albo elementów iframe
  • Widżet działa w ramce iframe, więc większość stylów strony na niego nie wpływa
  • Jeśli problem nie ustępuje, napisz do wsparcia

Bezpieczeństwo

Skrypt osadzenia:

  • ładuje się z bezpiecznego CDN,
  • korzysta z piaskownicy iframe,
  • weryfikuje pochodzenie wiadomości,
  • nie ma dostępu do danych Twojej strony.

Następne kroki