↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz
    2. Jak uruchomić czat na stronie: od czego zacząć

    Jak zainstalować czat na stronie

    17 min czytaniaZaktualizowano

    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

    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.

    Karta „Ustawienia”, karta „Funkcje czatu”: przełączniki „Aktywność” i „Pokazuj czat AI”
    1Aktywność
    2Pokazuj czat AI
    1. „Aktywność”: wyłączony widżet znika z kodu dla strony i z samej strony.
    2. „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”.

    Karta „Kod integracji” w oknie ustawień widżetu „Inteligentny asystent”: pole „Dla widżetu” z kodem i przycisk kopiowania
    1Przycisk kopiowania
    2Pole „Dla widżetu”
    1. Przycisk kopiowania bierze cały kod, nie trzeba go zaznaczać ręcznie.
    2. 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.

    1. 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).
    2. 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.
    3. 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

    1. Otwórz stronę w zwykłej przeglądarce, nie w usłudze testowania szybkości.
    2. Porusz myszą, przewiń stronę lub kliknij cokolwiek. Przycisk czatu pojawia się dopiero po pierwszym działaniu odwiedzającego (więcej poniżej).
    3. Znajdź przycisk. Bez zmian w ustawieniach jest na dole po lewej.
    4. 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”.
    Dopóki odwiedzający nic nie robi, przycisku czatu nie ma; gdy poruszy myszą, przycisk się pojawia, a kliknięcie otwiera czat

    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 konsoliCo 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 initializedPrzez 30 sekund na stronie nie było żadnego działania albo przeglądarka wygląda na robota
    Shopping Assistant: Error loading configurationUsł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.

    Każda gałąź po prawej to osobny powód, dla którego przycisku nie ma. Żółte romby idą w kolejności, w jakiej przechodzi je strona.
    Nie — bloker, CSP, siećTakTak — PageSpeed,headless, botNieNieTakNieTakNieTakStrona z kodemsię otworzyłaPlik usługowywidżetu się załadował?Czatu nie maw konsoli: Elbuz widget meta notloaded!Przeglądarka wyglądana robota?Czatu nie maOdwiedzający poruszył myszą,przewinął, kliknął — w ciągu 30sekund?Przy tym wyświetleniuczatu nie będzieWidżet ma włączoną„Aktywność”?Czatu nie maw konsoli: Error loadingconfigurationWłączone„Pokazuj czat AI”?Przycisku czatu nie maPrzycisk czatuna 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:

    1. atrybut lang tagu <html>, część przed myślnikiem (uk-UA → uk);
    2. meta tag content-language;
    3. meta tag og:locale;
    4. 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ą.

    Okno „Języki” z kolumnami kodu języka i kodu języka na stronie
    1Kod języka na stronie
    2Kod języka
    1. „Kod języka na stronie” — wypełnij, gdy strona oznacza język inaczej niż program.
    2. „Kod języka” — własny kod programu; kod strony taki jak uk dopasowuje się do języka ua automatycznie.
    Trzy górne romby — skąd widżet bierze kod języka: wygrywa pierwsza znaleziona wskazówka, język przeglądarki to ostatnia opcja zapasowa. Dolne romby — czyje teksty pokaże czat: jeśli języka nie znaleziono w oknie „Języki” albo nie ma dla niego tekstów, czat używa tekstów pierwszego języka.
    NieNieNieTakTakTakTakNieTakNieWidżet szukajęzyka stronyJest atrybut langw tagu html?Jest meta tagcontent-language?Jest meta tagog:locale?Język przeglądarkiodwiedzającegoKod bez regionuuk-UA → ukKod znaleziony w oknie „Języki”?„Kod języka”, „Kod języka nastronie”lub początek kodu, uk → uaNa karcie „Informacje”są teksty w tym języku?Teksty pierwszego językaTeksty znalezionego języka
    • Дія або результат
    • Розвилка: далі шлях залежить від відповіді

    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 stronieJak 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 maWłącz przełącznik
    Usuń kod z szablonuNie ma ani czatu, ani inteligentnej wyszukiwarki, jeśli była podłączona tym samym kodemWklej 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 widziszDlaczego tak jestCo 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.

    Blok „Narzędzia katalogu” w oknie „Kategorie” z kafelkami widżetów „Inteligentny asystent” i „Inteligentne wyszukiwanie”
    1Ustawienia widżetu - Inteligentny asystent
    2Ustawienia widżetu - Inteligentne wyszukiwanie
    1. „Ustawienia widżetu - Inteligentny asystent” — otwiera ustawienia czatu i kod dla strony.
    2. „Ustawienia widżetu - Inteligentne wyszukiwanie” — inny widżet, ale kod dla strony mają wspólny.

    Powiązane tematy

    Czy ten artykuł był pomocny?

    Brakuje funkcji? Napisz do nas.

    Dodamy ją za darmo, jeśli przyda się też innym.

    Jeśli potrzebujesz jej tylko ty — umówimy się osobno.

    Spis treści

    Zaproponuj usprawnienie

    Wypróbuj Elbuz za darmo