Jak zainstalować czat na stronie jedną linijką kodu: Elbuz przygotowuje kod, Ty wklejasz go do szablonu stron na OpenCart, WooCommerce, Shopify, Horoshop lub innym CMS. Potem na stronie działa czat online z konsultantem AI dla strony. Wygląd i teksty czatu zmieniasz potem w programie.
Kiedy to się przyda:
- Na stronie nie ma jeszcze czatu — cztery kroki od kafelka w programie do przycisku na stronie.
- Na stronie działa już inteligentna wyszukiwarka — jeden kod podłącza oba widżety, druga linijka nie jest potrzebna.
- Kod wklejony, a przycisku nie ma — wiersze w konsoli przeglądarki pokazują, na którym sprawdzeniu widżet się zatrzymał.
Od czego zacząć: krok 1 — kafelek „Ustawienia widżetu - Inteligentny asystent” w oknie „Kategorie”.
Co daje instalacja
- Jeden kod na dwa widżety — ta sama linijka podłącza czat i inteligentną wyszukiwarkę.
- Ustawienia bez zmian na stronie — kolor, teksty i model AI strona pobiera przy każdym wczytaniu.
- Dowolny CMS — wystarczy strona, do której szablonu można dodać własny kod HTML.
- Język strony — czat sam rozpoznaje język i bierze teksty w tym języku.
- Ochrona przed robotami — usługi testujące i roboty wyszukiwarek nie ładują czatu.
Krok 1. Otwórz ustawienia i sprawdź „Aktywność”
Otwórz kafelek. Jeśli okno otwiera się po raz pierwszy, program w tej chwili sam tworzy widżet, a przełącznik „Aktywność” jest w nim już włączony. Na konto przypada jeden widżet: kolejne otwarcie pokazuje ten sam widżet i nie tworzy nowego.
Karta „Ustawienia”, u góry karta „Funkcje czatu”. Przy instalacji liczą się dwa z jej przełączników:
- „Aktywność” — wyłączony widżet w ogóle nie trafia do kodu dla strony, a jeśli kod jest już na stronie, czat przestaje się pojawiać.
- „Pokazuj czat AI” — po wyłączeniu przycisk czatu znika ze stron, choć sam widżet nadal się na stronie ładuje. Domyślnie włączony.
Przycisku „Zapisz” w oknie nie ma i nie jest potrzebny. Każda zmiana pola od razu zapisuje cały formularz, a przy zamykaniu okna formularz zapisuje się jeszcze raz.
1
Aktywność2
Pokazuj czat AI- „Aktywność”: wyłączony widżet znika z kodu dla strony i z samej strony.
- „Pokazuj czat AI”: po wyłączeniu znika przycisk czatu, ale widżet nadal się ładuje.
Krok 2. Skopiuj kod
Na tej samej karcie „Ustawienia” przewiń na dół, do karty „Kod integracji”. W polu „Dla widżetu” jest gotowy kod. Pole jest tylko do odczytu. Przycisk po prawej nad polem (podpowiedź „Kopiuj”) kopiuje cały kod, po czym pojawia się komunikat „Tekst skopiowano do schowka”.
1
Przycisk kopiowania2
Pole „Dla widżetu”- Przycisk kopiowania bierze cały kod, nie trzeba go zaznaczać ręcznie.
- Tę linijkę wkleja się do szablonu strony raz, przed zamykającym tagiem body.
Co warto wiedzieć o tym kodzie:
- Nie ma w nim Twoich ustawień. Tylko adres usługi, identyfikator konta i numer widżetu. Kolor przycisku, teksty i model AI strona pobiera na nowo przy każdym wczytaniu, więc po zmianie ustawień kodu na stronie nie trzeba zmieniać.
- Kod jest jeden na dwa widżety. Jeśli włączone jest też „Inteligentne wyszukiwanie”, ta sama linijka podłącza oba. W ustawieniach inteligentnej wyszukiwarki widać właśnie ten kod. Na stronie powinna być jedna taka linijka, nie dwie.
- Pole odświeża się tylko przy otwieraniu okna. Jeśli włączysz „Aktywność” w już otwartym oknie, w polu nadal jest stary kod, bez czatu. Zamknij okno, otwórz je ponownie i dopiero wtedy kopiuj.
To, czy skopiowany kod zawiera czat, sprawdzisz na oko: powinien być w nim adres widget-esa.elbuz.com. Jeśli jest tylko widget-ess.elbuz.com, to kod samej inteligentnej wyszukiwarki.
Krok 3. Wklej kod do szablonu strony
Kod to zwykły blok <script>. Specjalnego modułu dla tu nie ma: wystarczy dowolna strona, do której szablonu można dodać własny kod HTML.
- Otwórz wspólny szablon wyświetlany na wszystkich stronach: zwykle to stopka strony. W sklepie Elbuz CMS niczego nie trzeba wklejać: czat włącza się sam przy tworzeniu sklepu (co włącza się samo).
- Wklej kod przed zamykającym tagiem
</body>. Jeśli CMS ma osobne pole na zewnętrzne skrypty w stopce lub nagłówku, możesz wkleić go tam. - Zapisz szablon.
W OpenCart 3 wspólna stopka to plik catalog/view/theme/<Twój motyw>/template/common/footer.twig.
Czat pojawia się tylko na tych stronach, na których załadował się kod. Jeśli wkleisz go do szablonu karty produktu, a nie do wspólnego, na stronie głównej i w koszyku czatu nie będzie. Czasem właśnie o to chodzi (zob. typowe sytuacje).
Jeśli przez przypadek wkleisz kod dwa razy, drugiego czatu nie będzie: widżet uruchamia się na stronie raz. Zbędną linijkę lepiej jednak usunąć, żeby potem nie szukać, która jest właściwa.
Krok 4. Sprawdź, czy czat działa
- Otwórz stronę w zwykłej przeglądarce, nie w usłudze testowania szybkości.
- Porusz myszą, przewiń stronę lub kliknij cokolwiek. Przycisk czatu pojawia się dopiero po pierwszym działaniu odwiedzającego (więcej poniżej).
- Znajdź przycisk. Bez zmian w ustawieniach jest na dole po lewej.
- Otwórz czat i napisz wiadomość testową. Rozmowa pojawi się w oknie „Rozmowy na czacie” (Organizer → Rozmowy na czacie) jako zwykłe zgłoszenie. Jak z nim pracować, opisuje artykuł o oknie „Rozmowy na czacie”.
Wiadomość testowa to prawdziwe zgłoszenie, a odpowiedź robota na nią to takie samo wywołanie modelu AI jak dla każdego odwiedzającego.
Przeglądarka zapamiętuje rozmowę: jeśli jutro otworzysz stronę w tej samej przeglądarce, będzie kontynuowany ten sam czat. Do czystego testu otwórz stronę w oknie prywatnym.
Jeśli przycisku nie ma, otwórz konsolę przeglądarki (F12, karta Console) i znajdź wiersze widżetu:
| Wiersz w konsoli | Co oznacza |
|---|---|
Smart Assistant: Initializing widget... | Sprawdzenie zaliczone, widżet pobiera ustawienia |
Elbuz widget meta not loaded! | Przeglądarka nie pobrała pliku usługowego widżetu: bloker reklam, polityka bezpieczeństwa strony lub sieć |
Smart Assistant: Bot detected or timeout, widget not initialized | Przez 30 sekund na stronie nie było żadnego działania albo przeglądarka wygląda na robota |
Shopping Assistant: Error loading configuration | Usługa nie zwróciła ustawień — najczęściej wyłączona jest „Aktywność” |
Wiersz Smart Assistant Widget initialized successfully pojawia się nawet wtedy, gdy ustawienia się nie załadowały. Sam w sobie niczego nie potwierdza — sprawdź, czy nad nim nie ma wierszy z tabeli.
Dlaczego przycisku czatu może nie być
Widżet przechodzi kilka sprawdzeń, a każde może go zatrzymać po cichu, bez błędu na stronie.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Najwięcej pytań budzi sprawdzenie, czy to robot. Aby nie zużywać zasobów na roboty wyszukiwarek i usługi testujące strony, widżet czeka na pierwsze działanie człowieka: ruch myszą o co najmniej 10 pikseli, kliknięcie, przewinięcie, naciśnięcie klawisza, dotknięcie ekranu lub fokus w polu wprowadzania.
- Brak jakiegokolwiek działania przez 30 sekund — przy tym wyświetleniu strony czatu nie będzie; pojawi się po ponownym wczytaniu i działaniu.
- Przeglądarki przedstawiające się jako roboty (PageSpeed, Lighthouse, przeglądarki headless, roboty wyszukiwarek) nigdy nie widzą czatu. Dlatego raport usługi testowania szybkości bez czatu to norma.
Jak czat wybiera język strony
Widżet sam ustala język strony, sprawdzając po kolei:
- atrybut
langtagu<html>, część przed myślnikiem (uk-UA→uk); - meta tag
content-language; - meta tag
og:locale; - język przeglądarki odwiedzającego.
Ostatni punkt to właśnie pułapka. Jeśli w szablonie nie ma lang ani meta tagów języka, odwiedzający z angielską przeglądarką dostanie czat po angielsku nawet na ukraińskiej stronie. Sprawdź, czy każda wersja językowa strony ma poprawny lang.
Kod języka ze strony program szuka wśród języków w oknie „Języki” (Słowniki → Języki): w kolumnie „Kod języka”, w kolumnie „Kod języka na stronie” albo po pierwszych literach kodu.
uk ze strony sam dopasowuje się do języka ua, a ru, en, pl pasują bez zmian. „Kod języka na stronie” wypełnia się tylko wtedy, gdy strona oznacza język inaczej niż program; wpisuj część przed myślnikiem, bo widżet przekazuje tylko ją.
1
Kod języka na stronie2
Kod języka- „Kod języka na stronie” — wypełnij, gdy strona oznacza język inaczej niż program.
- „Kod języka” — własny kod programu; kod strony taki jak uk dopasowuje się do języka ua automatycznie.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Co zależy od znalezionego języka:
- Teksty czatu — tytuł okna, wiersze w nagłówku i stopce: puste pole pokazuje standardowy tekst w języku odwiedzającego, a własny tekst jest jeden dla wszystkich języków.
- Napisy systemowe samego okna czatu są dostępne w ośmiu językach aplikacji: ukraińskim, rosyjskim, angielskim, polskim, niemieckim, francuskim, hiszpańskim i włoskim; dla pozostałych języków — po angielsku.
- Linki do produktów, które czat podaje odwiedzającemu, składają się z pola „Adres strony” na karcie „Ustawienia” i adresu produktu.
Na jakich domenach działa kod
Kod działa na każdej stronie, na którą go wklejono: usługa nie sprawdza domeny strony, a „Adres strony” na karcie „Ustawienia” nie ogranicza dostępu. Co z tego wynika:
- Zgłoszenia z kopii testowej lub drugiej domeny trafiają do tego samego okna „Rozmowy na czacie”, a linki do produktów w czacie prowadzą do „Adresu strony”.
- Aby czatu nie było na stronie testowej, usuń kod z szablonu właśnie tej strony. Przełącznik „Aktywność” wyłączy czat od razu na wszystkich stronach.
Jak tymczasowo usunąć czat ze strony
| Co zrobić | Co będzie na stronie | Jak przywrócić |
|---|---|---|
| Wyłącz „Aktywność” | Czatu nie ma od następnego wczytania strony. Kodu na stronie można nie ruszać | Włącz „Aktywność”: czat wróci ze wszystkimi ustawieniami |
| Wyłącz „Pokazuj czat AI” | Widżet się ładuje, ale przycisku czatu nie ma | Włącz przełącznik |
| Usuń kod z szablonu | Nie ma ani czatu, ani inteligentnej wyszukiwarki, jeśli była podłączona tym samym kodem | Wklej kod ponownie |
Dopóki „Aktywność” jest wyłączona, kod skopiowany z pola „Dla widżetu” nie zawiera części dotyczącej czatu. Nie wklejaj na stronę kodu skopiowanego w tym czasie — po włączeniu czat się nie pojawi.
Scenariusze
Pierwsza instalacja
Otwórz kafelek, upewnij się, że „Aktywność” jest włączona, skopiuj kod z pola „Dla widżetu” i wklej przed </body> we wspólnej stopce. Otwórz stronę, porusz myszą — przycisk pojawi się na dole po lewej. Dalej skonfiguruj wygląd i teksty oraz źródła odpowiedzi AI.
Na stronie działa już inteligentna wyszukiwarka
Stary kod podłącza tylko wyszukiwarkę. Otwórz ustawienia czatu, skopiuj kod na nowo i zastąp nim starą linijkę — nie dodawaj drugiej obok. Nowy kod podłącza oba widżety. O samej wyszukiwarce — w artykule o inteligentnej wyszukiwarce.
Czat nie zawsze jest potrzebny
Na przykład na czas, gdy nie ma kto odpowiadać. Wyłącz „Aktywność”, a kod na stronie zostaw. Po włączeniu czat wróci z tymi samymi ustawieniami, niczego nie trzeba wklejać.
Sklep w dwóch językach
Sprawdź lang w tagu <html> w każdej wersji językowej. Wypełnij „Adres strony” na karcie „Ustawienia” i tłumaczenia w danych firmy. Jeśli strona oznacza język kodem, którego nie ma w kolumnie „Kod języka”, wpisz go w „Kod języka na stronie”.
Czat tylko na wybranych stronach
Wklej kod tylko do szablonów tych stron, na przykład do karty produktu. Aby czat otwierał się nie pływającym przyciskiem, tylko własnymi przyciskami na stronie, jest położenie „Ukryty” (wygląd przycisku) i bloki z przyciskami AI (inteligentny asystent).
Co zrobić, gdy nie ma przycisku czatu
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| Przycisku nie ma, a w konsoli nie ma żadnego wiersza widżetu | Kod nie trafił do szablonu tej strony | Otwórz źródło strony (Ctrl+U) i poszukaj widget-esa. Jeśli go nie ma — wklej kod do wspólnego szablonu (krok 3) |
W źródle strony jest widget-ess, ale nie ma widget-esa |
Kod skopiowano, gdy czat był wyłączony — jest w nim tylko inteligentna wyszukiwarka | Włącz „Aktywność”, otwórz okno ponownie, skopiuj kod na nowo i zastąp stary (krok 2) |
| „Elbuz widget meta not loaded!” | Przeglądarka nie pobrała pliku z widget-esa.elbuz.com |
Na czas sprawdzenia wyłącz bloker reklam. Jeśli strona ma politykę bezpieczeństwa (CSP), zezwól w niej na https://widget-esa.elbuz.com i wss://rt-messaging.elbuz.com |
| „Smart Assistant: Bot detected or timeout, widget not initialized” | 30 sekund bez żadnego działania na stronie albo przeglądarka wygląda na robota | Wczytaj stronę ponownie i od razu porusz myszą (dlaczego tak jest) |
| „Shopping Assistant: Error loading configuration” | Wyłączona jest „Aktywność” widżetu | Włącz „Aktywność” (krok 1); kodu na stronie nie trzeba zmieniać |
| W konsoli nie ma błędów, a przycisku nie ma | Wyłączone jest „Pokazuj czat AI” albo wybrano położenie przycisku „Ukryty” | Włącz przełącznik (krok 1) lub zmień położenie na karcie „Wygląd” |
| Czat mówi w innym języku niż strona | W szablonie nie ma lang i widżet wziął język przeglądarki odwiedzającego |
Dodaj lang do tagu <html> w każdej wersji językowej (język czatu) |
| Linki do produktów w czacie prowadzą do nieistniejącej strony | Pusty lub błędny „Adres strony” na karcie „Ustawienia” | Wpisz adres wersji językowej strony na karcie tego języka (język czatu) |
Najczęstsze pytania
Czy po zmianie ustawień czatu trzeba zmieniać kod na stronie?
Nie. W kodzie nie ma Twoich ustawień, tylko adres usługi i identyfikatory. Kolor, teksty i model AI strona pobiera na nowo przy każdym wczytaniu.
Na stronie jest już kod inteligentnej wyszukiwarki. Dodać drugi?
Nie, zastąp go. Kod jest jeden na oba widżety: ten z pola „Dla widżetu” podłącza i wyszukiwarkę, i czat, jeśli oba są włączone.
Czy można dopuścić czat tylko na mojej domenie?
Nie, białej listy domen nie ma. Kod działa na każdej stronie, na którą go wklejono, a zgłoszenia stamtąd trafiają do Twojego okna „Rozmowy na czacie”. Aby czatu nie było na danej stronie, usuń kod z jej szablonu.
Dlaczego PageSpeed i usługi testujące nie widzą czatu?
Widżet nie uruchamia się w przeglądarkach przedstawiających się jako roboty i czeka na pierwsze działanie człowieka na stronie. Dla usług testujących oznacza to, że czat się nie pojawi. Dla ludzi — że przycisk pojawia się po ruchu myszą lub przewinięciu.
Czy można umieścić czat tylko na niektórych stronach?
Tak. Czat jest tylko tam, gdzie załadował się kod, więc wklej go do szablonów potrzebnych stron, a nie do wspólnej stopki.
Czy można mieć dwa różne czaty dla dwóch stron?
Na jednym koncie jest jeden widżet. Kod można wkleić na obie strony, ale wygląd, teksty i ustawienia AI będą na nich takie same.
Gdzie to jest i kto ma dostęp
Ustawienia widżetu nie mają osobnej pozycji w menu. Otwiera je kafelek w oknie „Kategorie”.
- Menu
- Słowniki → Kategorie → blok „Narzędzia katalogu” → kafelek „Ustawienia widżetu - Inteligentny asystent”
- Uprawnienia
- okno „Kategorie”: kafelek ustawień widżetu jest tylko tam
- Przygotuj
- dostęp do szablonu strony albo osobę, która może wkleić do niego kod
W tym samym bloku jest kafelek „Ustawienia widżetu - Inteligentne wyszukiwanie”. To inny widżet, wyszukiwarka w katalogu, ale kod dla strony mają wspólny — o tym w kroku 2.
1
Ustawienia widżetu - Inteligentny asystent2
Ustawienia widżetu - Inteligentne wyszukiwanie- „Ustawienia widżetu - Inteligentny asystent” — otwiera ustawienia czatu i kod dla strony.
- „Ustawienia widżetu - Inteligentne wyszukiwanie” — inny widżet, ale kod dla strony mają wspólny.
Powiązane tematy
- Jeśli potrzebujesz ogólnego obrazu czatu — inteligentny czat na stronę: od czego zacząć.
- Jeśli przycisk się pojawił i trzeba dobrać wygląd i teksty — ustawienia widżetu czatu.
- Jeśli robot po instalacji nic nie wie o sklepie — skąd AI na czacie bierze odpowiedzi.
- Jeśli przyszły już pierwsze zgłoszenia — okno „Rozmowy na czacie”.
