Inteligentny asystent Elbuz wstawia na podstrony Twojej strony własne przyciski AI: „Dobierz zamiennik” pod kartą produktu, blok „TOP parametrów”, wyjaśnienie zaznaczonego terminu. AI odpowiada z uwzględnieniem katalogu i strony, na której jest klient.
Kiedy to się przyda:
- Klienci pytają, czym różni się model — przycisk na karcie otwiera czat, a AI odpowiada właśnie o tym produkcie.
- Na wszystkich kartach potrzebna jest ta sama informacja — przycisk pokazuje gotowy tekst bez zapytania do AI.
- Klient nie rozumie terminu w opisie — zaznacza go, a pasek przy zaznaczeniu proponuje wyjaśnienie.
- Pytają „gdzie jest moje zamówienie” — przez Shop API asystent pobiera status z Twojego sklepu w chwili pytania.
Od czego zacząć: opisz kartę produktu, potem dodaj blok z przyciskiem.
Co potrafi asystent na stronach
- Bloki z przyciskami — wstawiane na stronę przed wybranym elementem, za nim lub zamiast niego.
- Trzy sposoby wyświetlania przycisku — gotowy tekst pod przyciskiem, okno wyskakujące albo pytanie do AI na czacie.
- Pasek dla zaznaczonego tekstu — przyciski przy fragmencie zaznaczonym przez klienta.
- Wybór produktów — ceny, kategorie, dostępność: asystent nie poleca tego, czego nie sprzedajesz.
- Działania z koszykiem — przyciski wywołują funkcje Twojej strony.
- Zamówienia klienta — statusy z Twojego sklepu bez synchronizacji.
Okno czatu, operatorzy i baza wiedzy — w artykule inteligentny czat dla strony. Widżet jest jeden, ustawienia są w jednym oknie, na różnych zakładkach.
Jak wyjaśnić asystentowi, na jakiej jest stronie
Aby odpowiadać rzeczowo, asystent musi wiedzieć, co klient ma teraz przed sobą: kartę produktu, listę kategorii czy składanie zamówienia. Służą do tego typy stron, a każdy z nich opisuje, jak go rozpoznać i co z niego pobrać:
- Jak rozpoznać — selektory CSS charakterystycznych elementów, fragment adresu, charakterystyczny tekst na stronie;
- Pola produktu — selektory, z których odczytać nazwę, kod, cenę, dostępność, zdjęcie, parametry;
- Przyciski strony — selektory „Kup”, „Do ulubionych”, „Do porównania”, „Zamów”;
- Linki do sekcji — wyszukiwanie, marki, promocje, blog, kontakt, dostawa i płatność.
Nie musisz wypełniać od razu wszystkich selektorów. Minimum, które daje korzyść, to rozpoznawanie karty produktu i selektor nazwy: wtedy przyciski w blokach dostają już nazwę produktu i mogą mówić „o tym produkcie”, a nie ogólnikowo.
Jak dodać własne przyciski AI na stronę
Blok to miejsce na stronie, w które asystent wstawia swoją treść. Na liście bloków widać typ, nazwę, opis, kolejność i aktywność, a wszystkie parametry umieszczenia ustawiasz w karcie bloku:
| Parametr | Co ustawia |
|---|---|
| Typ strony | gdzie blok się pojawia: na karcie produktu, w kategorii, przy składaniu zamówienia |
| Selektor | element strony, względem którego wstawiać |
| Pozycja | Przed, Po, Na początek, Na koniec albo Zamień ten element |
| Wygląd bloku | Domyślnie, Tekst albo TOP parametrów |
Pozycja „Zamień” usuwa element Twojej strony i wstawia w jego miejsce blok asystenta. Potrzebne jest to rzadko — np. by zastąpić standardową listę parametrów blokiem „TOP parametrów”. Błędny selektor z tą pozycją zepsuje układ strony, dlatego sprawdzaj wynik od razu po zapisaniu.
Przyciski bloku
Wewnątrz bloku są przyciski — to one są najważniejsze. Każdy przycisk ma:
- Nazwę i podpowiedź — to, co widzi klient;
- Sposób wyświetlania — Pod przyciskiem, Okno wyskakujące albo Czat; od niego zależy, czy przycisk w ogóle odwołuje się do AI (omówione niżej);
- Opis — gotowy tekst wyświetlany pod przyciskiem lub w oknie wyskakującym;
- Zadanie dla AI (prompt) — instrukcja dla AI; pole pojawia się w formularzu tylko dla sposobu Czat;
- Aktywność — przycisk możesz wyłączyć bez usuwania.
W prompcie działają podstawienia i to one nadają przyciskowi sens:
| Makro | Co jest podstawiane |
|---|---|
{ITEM_NAME} | nazwa produktu ze strony |
{ITEM_ID} | identyfikator produktu |
{HIGHLIGHTED_TEXT} | tekst zaznaczony przez klienta na stronie (lub pobrany selektorem) |
Przykłady przycisków: „Czym różni się od poprzedniego modelu” i „Czy to dla mnie?” — sposób Czat z promptem zawierającym {ITEM_NAME}: AI odpowiada właśnie o produkcie ze strony, a klient dopytuje dalej na tym samym czacie. „Warunki zwrotu” — sposób Pod przyciskiem lub Okno wyskakujące z gotowym tekstem w polu Opis: informacja jest taka sama dla wszystkich produktów i AI nie jest do niej potrzebne.
Co się dzieje po kliknięciu przycisku
Trzy sposoby wyświetlania działają zasadniczo inaczej, a różnica nie polega tylko na tym, gdzie pojawi się tekst:
- Pod przyciskiem — klient widzi tekst z pola Opis tego przycisku. Zapytania do AI nie ma: tekst przychodzi na stronę razem z blokiem, asystent tylko podstawia w nim
{ITEM_NAME},{ITEM_ID}i{HIGHLIGHTED_TEXT}. - Okno wyskakujące — asystent pobiera z serwera ten sam przycisk i pokazuje w oknie jego Opis. Zapytania do AI też nie ma. Makra
{ITEM_NAME},{ITEM_ID}i{HIGHLIGHTED_TEXT}są podstawiane tak samo: nazwa i identyfikator produktu ze strony oraz zaznaczony tekst. - Czat — otwiera się okno czatu, a w imieniu klienta trafia tam wiadomość z nazwą przycisku (i tekstem pobranym selektorem przycisku, jeśli jest ustawiony). AI dostaje tekst z pola Zadanie dla AI (prompt) jako instrukcję, z podstawioną nazwą i identyfikatorem produktu; w miejsce
{HIGHLIGHTED_TEXT}w prompcie trafia cała wysłana wiadomość — nazwa przycisku razem z tekstem z selektora. AI odpowiada na czacie. To zwykła, płatna odpowiedź AI — zob. koszty.
Jeśli przycisk ze sposobem Pod przyciskiem nie ma wypełnionego pola Opis, po kliknięciu otworzy się pusty obszar odpowiedzi: ten sposób nie wywołuje AI, więc nie ma czym go wypełnić. Prompt przycisku przełączonego z Czat na Pod przyciskiem lub Okno wyskakujące nie jest używany.
Pasek dla zaznaczonego tekstu
Osobny tryb: klient zaznacza dowolny tekst na stronie — i przy zaznaczeniu pojawia się Twój pasek z przyciskami. Przyciski są pogrupowane w zakładki, każdy ma wybrane działanie: wiadomość na czat (prompt AI z tym samym {HIGHLIGHTED_TEXT}), kliknięcie przycisku na stronie według selektora CSS, otwarcie linku — zwykłe albo w oknie, wykonanie kodu JS lub zdarzenia systemowego.
To rozwiązuje typowy problem długich opisów: klient nie rozumie terminu w parametrach i zamiast szukać w Google, dostaje wyjaśnienie na miejscu.
Jakie produkty i ceny pokazuje asystent
Gdy asystent pokazuje produkty — w odpowiedzi, w bloku czy w zestawieniu — bierze je z katalogu Elbuz. Dwie zakładki decydują, jak dokładnie.
Ceny
Zakładka „Ceny” decyduje, z którego pola katalogu pochodzi cena na karcie produktu, które ceny pokazywać — RRP (sugerowana cena detaliczna), promocyjną, starą cenę (kolejność, w jakiej się nadpisują, ustala program) — i jak zaokrąglać kwotę. Szczegóły: ceny i produkty na czacie.
Ograniczenia
Jakie produkty asystent może proponować, ustawia zakładka „Ograniczenia”: tylko dostępne (domyślnie włączone), „ID kategorii” z podkategoriami i warunek „Jakie produkty proponuje konsultant” według dowolnych pól katalogu. Bez niej asystent może zaproponować produkt z archiwalnej lub technicznej kategorii, której nie pokazujesz na witrynie. Warunek zapisuje tylko jego przycisk „Zapisz” (jak ustawić warunek).
Produkt wyłączony lub usunięty: co pokaże asystent
Produkty do odpowiedzi asystent znajduje na dwa sposoby i w obu, zanim przekaże produkt AI, sprawdza go w katalogu Elbuz: produkt musi być włączony i spełniać reguły wyboru według pól katalogu i atrybutów z zakładki Ograniczenia. Wyłączony lub usunięty produkt od razu znika z odpowiedzi asystenta.
Wyszukiwanie po słowach — tak AI dobiera produkty na zapytanie klienta — korzysta z indeksu inteligentnej wyszukiwarki. Nazwę produktu asystent bierze z katalogu, a opis — z indeksu.
- Do indeksu trafiają tylko produkty z włączoną aktywnością i eksportem, które leżą w aktywnej kategorii z włączonym eksportem.
- Każdy znaleziony produkt asystent odczytuje z katalogu: jeśli produkt usunięto, wyłączono lub odrzucają go reguły wyboru, nie trafia na listę dla AI, a jego miejsce zajmuje następny znaleziony.
Od aktualności indeksu zależy nie to, czy klient zobaczy wyłączony produkt, ale to, czy znajdzie się świeżo włączony lub zmieniony produkt i jaki opis dostanie AI. Wpis produktu w indeksie jest aktualizowany od razu, gdy produkt:
- zapisujesz w karcie;
- zmieniasz w tabeli — pojedynczo lub zbiorczo dla wyniku filtrowania, w tym zmieniając kategorię;
- usuwasz — wpis jest usuwany, gdy w Ustawieniach systemu włączony jest „Indeks wyszukiwania katalogu”.
Jeśli właśnie trwa lub jest już zaplanowane pełne ponowne indeksowanie (uruchamiają je m.in. import danych, aktualizacja katalogu bazowego ze wszystkich cenników i przywracanie z kopii zapasowej), zmiana produktu nie rusza indeksu — wpis zaktualizuje najbliższe pełne ponowne indeksowanie.
Produkt strony i produkt po numerze — ten, na którego stronie jest teraz klient, i ten, o który AI pyta po identyfikatorze — są odczytywane bezpośrednio z katalogu Elbuz z tymi samymi sprawdzeniami.
- Produktu wyłączonego w Elbuz, którego strona wciąż otwiera się na Twojej stronie, asystent nie opisuje: dla niego to strona bez znanego produktu.
- Jeśli produktu po numerze nie znaleziono — został usunięty lub wyłączony — asystent szuka tego numeru jako słów w indeksie, a znalezione znów przechodzi sprawdzenie w katalogu.
Jak podłączyć linki i koszyk strony
Asystent działa na Twojej stronie, więc musi znać jego adresy i umieć klikać jego przyciski.
- Linki — szablony adresów produktu, artykułu i zdjęcia z prefiksem języka, adres koszyka, powiązanie z zewnętrznym źródłem i API sklepu: linki z czatu.
- Zdarzenia — kod JS Twojej strony dla przycisków „Kup”, „Do ulubionych”, „Porównaj”; dla popularnych CMS jest podstawiany przez wybór „CMS ID”: koszyk strony z czatu.
Numer produktu dla koszyka strony
Aby koszyk strony przyjął produkt, kod zdarzeń dostaje numer produktu w Twoim CMS — z karty produktu, z powiązania z zewnętrznym źródłem lub ze strony produktu przez „Pobieranie ID produktu”. Produkt bez takiego numeru nie trafi do koszyka strony (dane produktu).
Jak pokazać klientowi jego zamówienie
To najgłębszy poziom integracji. Na zakładce „Linki” jest blok Shop : adres modułu po stronie Twojego sklepu i klucz tajny (HMAC), taki sam tutaj i w module.
Co to daje: asystent wie, kto dokładnie jest teraz na stronie — logowanie klienta jest przekazywane do czatu — i może pobierać jego zamówienia na żywo, bez synchronizacji. Czyli na pytanie „gdzie jest moje zamówienie” odpowiedź pochodzi z Twojego sklepu w chwili pytania, a nie z kopii danych.
Pytanie o konkretne zamówienie AI rozstrzyga inaczej dla klienta zalogowanego na konto na Twojej stronie, a inaczej dla gościa:
- Zalogowany klient widzi zamówienie tylko wtedy, gdy należy ono do niego; cudze jest dla niego „nie znaleziono”, nawet jeśli taki numer istnieje. Lista „moje zamówienia” jest dostępna tylko dla niego.
- Gość dostaje tylko status i tylko po podaniu e-maila, z którym składał zamówienie. Lista zamówień nie jest dostępna dla gościa — AI proponuje najpierw zalogować się na stronie.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Klucz Shop API to dostęp do danych klientów. Ustawia się go w parze: tutaj i w module sklepu. Przycisk generowania tworzy nowy klucz, ale potem trzeba go od razu wpisać w module — inaczej połączenie zostanie zerwane, a asystent przestanie rozpoznawać klientów.
Co tu jest płatne i gdzie widać koszty
Opłaty pobierane są tylko za odpowiedzi AI. Bloki i przyciski na stronach same w sobie nic nie kosztują — ważne jest, czy dane działanie odwołuje się do AI:
| Działanie klienta | Czy jest zapytanie do AI |
|---|---|
| przycisk bloku ze sposobem Pod przyciskiem lub Okno wyskakujące | nie — wyświetla się gotowy Opis, bez opłat |
| przycisk bloku ze sposobem Czat | tak — odpowiedź AI na czacie |
| przycisk paska dla zaznaczonego tekstu, który wysyła zaznaczenie na czat | tak — odpowiedź AI na czacie |
| każda kolejna wiadomość klienta na czacie | tak — każda odpowiedź AI osobno |
| przycisk paska z linkiem lub Twoim JS | nie |
Jednostką rozliczenia są tokeny. Za każdą odpowiedź AI liczone są tokeny wejściowe i wyjściowe według cen modelu wybranego w polu Model AI. Jeśli odpowiadając, AI szukało produktów lub artykułów, wszystkie pośrednie kroki tego wyszukiwania wchodzą w tę samą odpowiedź.
Proaktywne podpowiedzi i karta kontekstu na czacie (przełączniki Bloki AI na stronach i Karta kontekstu przy otwarciu czatu) też generuje AI, ale nie przy każdym wyświetleniu. Kolejność jest taka:
- jeśli dla tej strony (adres bez znaczników reklamowych — UTM, gclid, fbclid itp.) i języka podpowiedzi są już wygenerowane, wyświetlane są z zapisanej kopii — bez zapytania do AI; kopia jest przechowywana 365 dni;
- jeśli kopii nie ma, a odwiedzający jeszcze nic nie napisał na czacie, podpowiedzi nie będzie — zapytania też nie;
- jeśli kopii nie ma, a odwiedzający pisał już na czacie, AI generuje podpowiedzi raz — to generowanie jest płatne — i potem dostają je wszyscy odwiedzający tę stronę;
- na stronach, których adres wygląda na wyszukiwanie, koszyk, składanie zamówienia lub płatność (zawiera
/search,/cart,/checkout,/order,/payitp. albo parametr wyszukiwania w rodzajuq=), podpowiedzi nie są generowane.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Gdzie widać wydatki. Każda odpowiedź AI trafia do dziennika kosztów konta. Przebieg rozliczenia w tle sumuje zgromadzone wpisy i pobiera kwotę z salda jednym wierszem: Saldo → zakładka Historia operacji, kolumny Operacja i Kwota. Czyli w historii widzisz nie każde kliknięcie osobno, lecz sumę za okres między przebiegami.
Usługa asystenta przed odpowiedzią nie sprawdza salda konta, więc przy zerowym saldzie przyciski ze sposobem Czat i sam czat nadal odpowiadają. Rozliczenie odejmuje zgromadzoną kwotę bez dolnej granicy — saldo może zejść poniżej zera.
Scenariusze
Klienci na karcie produktu pytają, czym różni się model i czy będzie dla nich odpowiedni
Co ustawić. Blok z Typ strony dla karty produktu, a w nim przycisk ze sposobem wyświetlania Czat i polem Zadanie dla AI (prompt) zawierającym {ITEM_NAME}.
Efekt. Po kliknięciu otwiera się czat, w imieniu klienta trafia tam nazwa przycisku, a AI dostaje Twój prompt z podstawioną nazwą i identyfikatorem produktu ze strony. Klient może dopytywać dalej na tym samym czacie. Każda odpowiedź AI jest płatna.
Na wszystkich kartach potrzebna jest ta sama informacja bez kosztów AI
Co ustawić. Przycisk ze sposobem wyświetlania Pod przyciskiem lub Okno wyskakujące, gotowy tekst — w polu Opis.
Efekt. Klient widzi tekst z pola Opis. Zapytania do AI nie ma, więc kliknięcia są bezpłatne.
Czego nie będzie. AI nie uzupełnia ani nie przepisuje tego tekstu. Prompt takiego przycisku nie jest używany, a przy pustym Opisie pod przyciskiem otworzy się pusty obszar.
Klienci piszą „gdzie jest moje zamówienie”, a statusy są w Twoim sklepie
Co ustawić. Na zakładce Linki w bloku Shop API — pola Shop API (adres modułu po stronie sklepu) i Shop API Secret (ten sam klucz co w module).
Efekt. AI pobiera zamówienie z Twojego sklepu w chwili pytania. Klient zalogowany na konto na stronie dostaje swoje zamówienia z pełnymi danymi; gość — status zamówienia po podaniu e-maila, z którym je składał.
Czego nie będzie. Cudzego zamówienia asystent nie pokaże: dla zalogowanego klienta jest ono „nie znaleziono”, dla gościa bez właściwego e-maila — również. Dopóki adres lub klucz nie są wypełnione, zapytań do sklepu nie ma i AI nie odpowie na pytanie o zamówienie.
Potrzebne są podpowiedzi-pytania na stronach, ale bez opłaty za każde wyświetlenie
Co ustawić. Przełącznik Bloki AI na stronach lub Karta kontekstu przy otwarciu czatu — wystarczy jeden z dwóch.
Efekt. Podpowiedzi dla strony są generowane raz — gdy otworzy ją odwiedzający, który pisał już na czacie — i przez 365 dni wyświetlane wszystkim odwiedzającym tej strony i języka z zapisanej kopii, bez nowych zapytań do AI.
Czego nie będzie. Dopóki strony nie otworzy odwiedzający, który pisał już na czacie, podpowiedzi na niej nie ma. Na stronach wyszukiwania, koszyka, składania zamówienia i płatności nie pojawią się nigdy.
Co zrobić, gdy blok lub przycisk nie działa
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| Blok nie pojawił się na stronie | selektor nie znajduje elementu albo nie zgadza się typ strony | sprawdź selektor bloku i reguły rozpoznawania typu strony |
| Blok stanął nie tam, gdzie trzeba | wybrano niewłaściwą pozycję względem elementu | wypróbuj „Przed” / „Po” / „Na początek” / „Na koniec” |
| Zepsuł się układ strony | pozycja „Zamień” usunęła potrzebny element strony | zmień pozycję lub doprecyzuj selektor |
| Przycisk odpowiada ogólnikami | w prompcie nie ma makr — AI nie wie, o jaki produkt chodzi | dodaj {ITEM_NAME}, a w razie potrzeby {ITEM_ID} |
| Odpowiedź pojawia się nie tam, gdzie oczekiwano | wybrano inny „Sposób wyświetlania” | wybierz „Pod przyciskiem”, „Okno wyskakujące” lub „Czat” |
| Pasek dla zaznaczonego tekstu się nie pokazuje | brak aktywnych zakładek lub przycisków paska | dodaj co najmniej jeden przycisk i włącz go |
| Asystent poleca produkty z niewłaściwych kategorii | nie ustawiono ograniczenia według kategorii | ustaw wybór na zakładce „Ograniczenia” |
| Opisuje produkt, którego nie ma w magazynie | klient jest na stronie tego produktu: produkt strony jest pokazywany z dowolnym statusem | dodaj „Status dostępności” do warunku na zakładce „Ograniczenia” (wybór) |
| Cena w odpowiedzi jest inna niż na stronie | wybrano inne pole źródła ceny albo nie jest pokazywana cena promocyjna | sprawdź ustawienia na zakładce „Ceny” |
| Pod przyciskiem otwiera się pusty obszar | przycisk ma sposób „Pod przyciskiem”, a pole „Opis” jest puste; ten sposób nie wywołuje AI | wypełnij „Opis” albo przełącz przycisk na „Czat” z promptem |
| Przycisk „Kup” otwiera stronę produktu | nie ustawiono kodu JS Twojej strony | wybierz „CMS ID” lub wypełnij „Dodanie do koszyka” na zakładce „Zdarzenia” (zdarzenia) |
| Produkt nie dodaje się do koszyka strony | produkt nie ma numeru w Twoim CMS | uzupełnij numer produktu w CMS (numer produktu) |
| Asystent nie rozpoznaje klienta | Shop API nie jest skonfigurowane albo klucze się różnią | porównaj adres modułu i klucz tajny po obu stronach |
Najczęstsze pytania
Czym asystent różni się od czatu?
To jeden widżet. Czat to okno rozmowy z AI i operatorami, asystent — to, co ten sam widżet robi na stronach: bloki z przyciskami, pasek dla zaznaczonego tekstu, pokazywanie produktów.
Ile kosztuje kliknięcie przycisku AI?
Płatna jest tylko odpowiedź AI — przyciski ze sposobem „Czat” i wiadomości na czacie, według tokenów wybranego modelu. „Pod przyciskiem” i „Okno wyskakujące” nic nie kosztują (koszty).
Po co wypełniać selektory typów stron?
Żeby asystent rozumiał, co klient ma przed sobą, i pobierał ze strony nazwę, cenę, dostępność i przyciski. Bez tego przyciski mówią ogólnikowo, a działania z koszykiem nie wiedzą, do jakiego produktu się odnoszą.
Dlaczego asystent proponuje niewłaściwe produkty?
Ma ten sam katalog co sklep, a wybór nie jest skonfigurowany. Na zakładce „Ograniczenia” ustaw warunek „Jakie produkty proponuje konsultant” i zapisz go jego przyciskiem (ograniczenia).
Dlaczego asystent nie opisuje produktu, którego strona wciąż się otwiera?
Produkt jest wyłączony lub usunięty w Elbuz: dla asystenta to strona bez znanego produktu (wyłączony produkt).
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Kategorie → blok „Narzędzia katalogu” → kafelek „Ustawienia widżetu - Inteligentny asystent”
- Zakładki
- Linki, Ceny, Ograniczenia, Zdarzenia, Bloki; pozostałe — w artykule ustawienia widżetu
- Przygotuj
- kod widżetu na stronie (ten sam co dla czatu) i selektory CSS stron
1
Zakładka „Bloki”2
Zakładka „Ograniczenia”3
Zakładka „Ceny”4
Kolumna „Typ”- Zakładka „Bloki” — tabela bloków asystenta umieszczonych na podstronach Twojej strony.
- Zakładka „Ograniczenia” — jakie produkty asystent może proponować.
- Zakładka „Ceny” — ustawienia cen asystenta.
- Kolumna „Typ” — pierwsza kolumna tabeli bloków.
Powiązane tematy
- Jeśli potrzebujesz ogólnego obrazu czatu — inteligentny czat dla strony: od czego zacząć.
- Jeśli kodu widżetu nie ma jeszcze na stronie — jak zainstalować czat na stronie.
- Jeśli asystent nie znajduje właściwych produktów — inteligentna wyszukiwarka.
- Jeśli „TOP parametrów” pokazuje niewłaściwe cechy — atrybuty.
