1. Wstęp i wymagania

Czym jest Sell.AI?

Sell.AI to inteligentny asystent sprzedaży dla sklepów WooCommerce, napędzany przez modele językowe OpenAI (GPT-4o, GPT-5). Działa jako pływający widget czatu w rogu Twojego sklepu — klienci mogą pisać do niego tak samo naturalnie, jak piszą do prawdziwego doradcy.

W odróżnieniu od zwykłych chatbotów FAQ, Sell.AI aktywnie sprzedaje: przeszukuje katalog produktów w czasie rzeczywistym, wyświetla interaktywne karty produktów z ceną i przyciskiem „Dodaj do koszyka", przechwytuje leady, śledzi konwersje i zapamiętuje kontekst rozmowy przez całą sesję zakupową.

Jak to działa — w skrócie

Klient pisze pytanie

↓ Sell.AI analizuje intencję (co szuka, jaki budżet, jakie preferencje) ↓ Przeszukuje Twój katalog WooCommerce (słowa kluczowe + rozumienie semantyczne) ↓ GPT-4o formułuje odpowiedź i dobiera produkty ↓ Klient widzi odpowiedź + karty produktów z przyciskiem „Dodaj do koszyka" ↓ Zakup bezpośrednio z okna chatu

Całość dzieje się w ciągu 2–4 sekund. Klient nigdy nie musi opuszczać strony, którą aktualnie przegląda.

Dla kogo jest Sell.AI?

Wtyczka działa z każdym rodzajem sklepu WooCommerce, niezależnie od branży:

• Moda i odzież
• Elektronika i AGD
• Dom i ogród
• Kosmetyki i zdrowie
• Artykuły spożywcze
• Zoologiczny i weterynaryjny
• Budownictwo i narzędzia
• Motoryzacja
• Zabawki i artykuły dziecięce
• Sport i outdoor
• Medyczny i farmaceutyczny
• Elektryczny i przemysłowy

Wtyczka zawiera 12 gotowych szablonów branżowych, które dostosowują zachowanie AI do specyfiki Twojego asortymentu.

Wymagania systemowe

Przed instalacją upewnij się, że Twój serwer spełnia poniższe wymagania:

Klucz API OpenAI

Sell.AI używa modeli OpenAI do generowania odpowiedzi. Potrzebujesz własnego klucza API:

1. Wejdź na stronę platform.openai.com
2. Zarejestruj konto lub zaloguj się
3. Przejdź do sekcji API keys i wygeneruj nowy klucz
4. Skopiuj klucz — będziesz go potrzebować podczas konfiguracji wtyczki

Koszt korzystania z API OpenAI jest naliczany osobno przez OpenAI, niezależnie od licencji Sell.AI. Dla typowego sklepu z 50–100 rozmowami dziennie wynosi on 5–15 USD miesięcznie.

2. Instalacja wtyczki

Metoda 1 — Instalacja przez panel WordPress (zalecana)

Jest to najszybszy i najprostszy sposób instalacji.

Krok 1. Zaloguj się do panelu administracyjnego WordPress (zazwyczaj twojasklep.pl/wp-admin).

Krok 2. W menu po lewej stronie kliknij Wtyczki → Dodaj nową.

Krok 3. Kliknij przycisk Wyślij wtyczkę (w górnej części strony).

Krok 4. Kliknij Wybierz plik i wskaż pobrany plik ZIP wtyczki Sell.AI (np. sell-ai-woocommerce.zip).

Krok 5. Kliknij Zainstaluj teraz i poczekaj, aż WordPress prześle plik na serwer.

Krok 6. Po zakończeniu instalacji kliknij Aktywuj wtyczkę.

Po aktywacji zostaniesz automatycznie przeniesiony do Kreatora konfiguracji (Setup Wizard), który przeprowadzi Cię przez pierwsze uruchomienie.

Metoda 2 — Instalacja przez FTP

Jeśli nie możesz zainstalować wtyczki przez panel WordPress (np. limit rozmiaru pliku), użyj FTP:

Krok 1. Pobierz i rozpakuj plik ZIP wtyczki na swoim komputerze.

Krok 2. Połącz się z serwerem przez klienta FTP (np. FileZilla).

Krok 3. Przejdź do katalogu /wp-content/plugins/ na serwerze.

Krok 4. Wgraj tam cały rozpakowany folder sell-ai-woocommerce (nie ZIP, lecz folder).

Krok 5. Wróć do panelu WordPress → Wtyczki → Zainstalowane wtyczki.

Krok 6. Znajdź Sell.AI na liście i kliknij Aktywuj.

Co dzieje się podczas aktywacji?

Po pierwszej aktywacji wtyczka automatycznie:

• Tworzy niezbędne tabele w bazie danych WordPress (logi rozmów, leady, indeks słów kluczowych)
• Rejestruje zadania cron (m.in. nocne odświeżanie indeksu o 3:00, automatyczne czyszczenie logów)
• Przekierowuje do Kreatora konfiguracji

Aktualizacja do nowszej wersji

Gdy pojawi się nowa wersja Sell.AI, zostaniesz o tym poinformowany w panelu WordPress (sekcja Wtyczki → Zainstalowane wtyczki).

Krok 1. Przed aktualizacją zalecamy wykonanie kopii zapasowej bazy danych.

Krok 2. Kliknij Aktualizuj teraz przy wtyczce Sell.AI.

Krok 3. WordPress automatycznie pobierze i zainstaluje nową wersję. Wszystkie Twoje ustawienia, logi i dane zostają zachowane.

3. Kreator konfiguracji (Setup Wizard)

Kreator uruchamia się automatycznie po pierwszej aktywacji wtyczki lub gdy klucz API OpenAI nie jest jeszcze skonfigurowany. Przeprowadza Cię przez 5 kroków niezbędnych do uruchomienia chatbota.

Możesz w dowolnym momencie pominąć kreator przyciskiem Pomiń i skonfigurować wszystko ręcznie w sekcji Ustawienia. Możesz też uruchomić go ponownie klikając Sell.AI → Dashboard → Uruchom kreator.

Krok 1 — Ekran powitalny

Pierwszy ekran przedstawia ogólny opis wtyczki oraz jej najważniejsze funkcje. Kliknij dalej, aby przejść do konfiguracji.

Kliknij Dalej, aby przejść do konfiguracji API.

Krok 2 — Klucz API OpenAI

To najważniejszy krok — bez klucza API chatbot nie będzie działał.

Jak uzyskać klucz API:

1. Otwórz nową kartę i przejdź na stronę platform.openai.com
2. Zaloguj się lub zarejestruj konto (rejestracja jest bezpłatna)
3. W menu kliknij API keys (po lewej stronie lub w prawym górnym menu)
4. Kliknij Create new secret key
5. Nadaj kluczowi nazwę (np. „Sell.AI – mój sklep") i kliknij Create secret key
6. Skopiuj wygenerowany klucz (zaczyna się od sk-...) — uwaga, wyświetli się tylko raz!

Jak wpisać klucz w kreatorze:

1. Wklej skopiowany klucz w pole Klucz API OpenAI
2. Kliknij Przetestuj klucz — wtyczka wyśle testowe zapytanie do OpenAI i potwierdzi poprawność
3. Jeśli test zakończy się sukcesem, zobaczysz zielony komunikat ✓
4. Wybierz Model AI — domyślnie ustawiony jest GPT-4o (polecany dla większości sklepów)
5. Kliknij Dalej

Dostępne modele:

Krok 3 — Wygląd chatbota

W tym kroku dostosowujesz wygląd widgetu do swojej marki.

Tytuł chatu — tekst wyświetlany w nagłówku okna chatbota (np. „Asystent zakupowy", „Pomoc", „Chat z AI"). Domyślnie: AI Shopping Assistant.

Ikona przycisku — wybierz ikonę pływającego przycisku w rogu strony:

• 💬 Dymek czatu (domyślna)
• 🤖 Robot
• ⭐ Gwiazda
• ⚡ Błyskawica
• ❤️ Serce
• ✨ Iskierki
• Własna — możesz wkleić URL do własnego obrazka (PNG/SVG, 56×56 px)

Kolor akcentu — główny kolor widgetu (przyciski, nagłówek). Kliknij pole kolorów, aby otworzyć picker i wybrać kolor pasujący do Twojej marki. Możesz też wpisać kod HEX, np. #e63946.

Wiadomość powitalna — tekst, który chatbot wyświetla automatycznie po otwarciu okna. Możesz używać emoji i prostego formatowania.

Przykład: Cześć! 👋 Jestem Twoim asystentem zakupowym. Powiedz mi, czego szukasz, a pomogę Ci znaleźć idealny produkt!

Kliknij Dalej, gdy skończysz.

Krok 4 — Zachowanie chatbota

Pozycja widgetu — wybierz, gdzie ma się wyświetlać pływający przycisk:

• Prawy dolny róg (domyślnie)
• Lewy dolny róg

Widoczność na urządzeniach:

• Pokaż na urządzeniach mobilnych — zaznacz, jeśli chatbot ma działać na telefonach i tabletach (domyślnie włączone)
• Pokaż na komputerach — zaznacz, jeśli chatbot ma działać na desktopie (domyślnie włączone)

Auto-otwieranie (Pro) — chatbot może automatycznie otworzyć się po określonym czasie od wejścia na stronę. Ustaw opóźnienie w sekundach (1–60). Przydatne np. na stronach produktów. Domyślnie wyłączone.

Karty produktów — gdy włączone, chatbot wyświetla produkty jako interaktywne karty z zdjęciem, ceną i przyciskiem „Dodaj do koszyka". Zdecydowanie zalecamy pozostawienie tej opcji włączonej.

Przyciski szybkich akcji — do 3 przycisków widocznych na starcie rozmowy, które klient może kliknąć zamiast pisać. Każdy przycisk ma:

• Etykieta — tekst na przycisku (krótki, np. „Bestsellery")
• Wiadomość — pytanie wysyłane automatycznie po kliknięciu (np. „Pokaż mi wasze bestsellery")

Domyślne przyciski: Bestsellery, Promocje, Pomysły na prezent.

Kliknij Dalej.

Krok 5 — Gotowe!

Kreator jest zakończony. Chatbot jest już aktywny na Twoim sklepie.

Na ekranie końcowym znajdziesz dwa przyciski:

• Przejdź do panelu głównego — zobaczysz statystyki i stan systemu
• Przejdź do ustawień — możesz dalej konfigurować zaawansowane opcje

4. Panel główny (Dashboard)

Panel główny to pierwsze miejsce, do którego trafiasz po zalogowaniu do Sell.AI. Znajdziesz go klikając Sell.AI w menu WordPress po lewej stronie.

Statystyki ogólne

W górnej części panelu wyświetlane są cztery kluczowe wskaźniki z bieżącego dnia:

Alerty i status systemu

Poniżej statystyk wyświetlana jest sekcja Status systemu, która informuje o ewentualnych problemach:

• Brak klucza API — chatbot jest wyłączony; kliknij link, aby przejść do ustawień i wpisać klucz
• Indeks produktów pusty — wyszukiwanie nie działa poprawnie; kliknij „Odbuduj indeks", aby uruchomić indeksowanie
• Licencja nieaktywna (tylko Pro) — chatbot jest zablokowany; wpisz klucz licencyjny w zakładce Sell.AI → System → Licencja

Zielony status oznacza, że wszystko działa prawidłowo.

Szybkie linki

W panelu głównym znajdziesz skróty do najczęściej używanych funkcji:

• Ustawienia — konfiguracja API, wyglądu i zachowania
• Analityka — wykresy i dane konwersji
• Leady — lista przechwyconych kontaktów
• Historia rozmów — podgląd rozmów klientów z chatbotem
• Search & AI — odbudowa indeksu, synonimy, wyszukiwanie semantyczne, wzbogacanie AI
• System — diagnostyka, licencja

Uruchomienie kreatora ponownie

Jeśli chcesz przejść przez Kreator konfiguracji od nowa (np. po zmianie domeny lub całkowitym resecie ustawień), kliknij przycisk Uruchom kreator w prawym górnym rogu panelu głównego.

5. Ustawienia — API i Model

Ustawienia znajdziesz klikając Sell.AI → Ustawienia w menu WordPress. Strona ustawień podzielona jest na cztery zakładki. Ta sekcja opisuje zakładkę API i Model.

Klucz API OpenAI

Pole: Klucz API OpenAI

Wklej tutaj swój klucz API OpenAI (format: sk-...). Klucz jest przechowywany bezpiecznie w bazie danych Twojego WordPressa — nigdy nie jest ujawniany publicznie.

Po wklejeniu klucza kliknij przycisk Przetestuj klucz API — wtyczka natychmiast wyśle testowe zapytanie do OpenAI i poinformuje Cię, czy klucz jest poprawny i aktywny.

Co zrobić, jeśli test się nie powiedzie:

• Upewnij się, że skopiowałeś cały klucz (zaczyna się od sk-)
• Sprawdź, czy masz aktywną metodę płatności na koncie OpenAI (bezpłatne konto ma ograniczony limit)
• Upewnij się, że Twój serwer ma dostęp do internetu (niektóre serwery mają zablokowane wychodzące połączenia HTTPS)

Wybór modelu AI

Pole: Model AI

Wybierz model OpenAI, który ma generować odpowiedzi chatbota:

Limit tokenów (Długość odpowiedzi)

Pole: Maksymalna liczba tokenów odpowiedzi

Token to mniej więcej ¾ słowa w języku angielskim (lub ok. ½–⅔ słowa po polsku). Limit tokenów kontroluje, jak długa może być pojedyncza odpowiedź chatbota.

Domyślna wartość: 600. Dla większości sklepów nie ma potrzeby zmiany tej wartości.

Temperatura (Kreatywność odpowiedzi)

Pole: Temperatura

Temperatura to parametr kontrolujący „kreatywność" i zmienność odpowiedzi AI. Skala od 0 do 1:

Domyślna wartość: 0.7. Dla sklepów wymagających precyzji (elektronika, medycyna, części zamienne) zalecamy obniżenie do 0.3–0.5.

Globalny włącznik chatbota

Przełącznik: Chatbot aktywny

Ten przełącznik natychmiast włącza lub wyłącza chatbota na całym sklepie. Gdy jest wyłączony:

• Pływający przycisk znika ze wszystkich stron sklepu
• Klienci nie mogą inicjować rozmów
• Wszystkie ustawienia i dane pozostają nienaruszone

Przydatne np. podczas prac konserwacyjnych, gdy chcesz tymczasowo wyłączyć chatbota bez zmiany żadnych ustawień.

Zapisywanie ustawień

Po dokonaniu zmian w dowolnej zakładce kliknij przycisk Zapisz zmiany na dole strony. Zmiany wchodzą w życie natychmiast — nie jest wymagane ponowne uruchamianie strony ani czyszczenie cache.

6. Ustawienia — Wygląd i Zachowanie

Zakładka Wygląd i Zachowanie w sekcji Sell.AI → Ustawienia. Tutaj konfigurujesz to, co widzi klient — wygląd widgetu, jego zawartość oraz sposób działania.

Wygląd widgetu

Tytuł chatu

Tekst wyświetlany w nagłówku okna chatbota. Krótki i zachęcający — maks. kilkanaście znaków.

Przykłady: Asystent zakupowy, Pomoc, Chat, Doradca AI

Ikona przycisku

Ikona pływającego przycisku w rogu strony. Do wyboru 6 presetów lub własna grafika:

• 💬 Dymek czatu (domyślna)
• 🤖 Robot
• ⭐ Gwiazda
• ⚡ Błyskawica
• ❤️ Serce
• ✨ Iskierki
• Własna — wklej URL do obrazka PNG lub SVG (optymalne wymiary: 56×56 px)

Kolor akcentu

Główny kolor marki stosowany do: nagłówka okna chatu, przycisku pływającego, przycisków akcji, bąbelków wiadomości AI.

Kliknij pole kolorów, aby otworzyć picker, lub wpisz bezpośrednio kod HEX (np. #7c3aed).

Wiadomość powitalna

Pierwsza wiadomość, którą chatbot wysyła automatycznie po otwarciu okna. Możesz używać emoji.

Przykład dla sklepu odzieżowego:

Cześć! 👗 Jestem Twoim osobistym stylistą AI.

Opisz mi okazję, do której szukasz stroju, swój styl lub budżet — a dobiorę dla Ciebie idealne propozycje!

Placeholder pola tekstowego

Szara podpowiedź wewnątrz pola do wpisywania wiadomości. Wyświetla się, gdy pole jest puste.

Przykład: Napisz, czego szukasz... lub Zapytaj mnie o produkt...

Wymiary okna

• Szerokość — szerokość okna chatu w pikselach (280–900 px). Domyślnie: 380 px
• Wysokość — wysokość okna chatu w pikselach (300–900 px). Domyślnie: 560 px

Na urządzeniach mobilnych okno automatycznie dostosowuje się do szerokości ekranu.

Pozycja i offset

Pozycja widgetu

Wybierz, w którym rogu ekranu ma się pojawić przycisk:

• Prawy dolny róg (domyślna)
• Lewy dolny róg

Odstęp od krawędzi (Offset)

Odległość przycisku od krawędzi ekranu w pikselach:

• Offset poziomy (X) — odległość od prawej lub lewej krawędzi. Domyślnie: 24 px
• Offset pionowy (Y) — odległość od dolnej krawędzi. Domyślnie: 24 px

Możesz zwiększyć te wartości, jeśli inne elementy strony (np. belka cookie, ikonki mediów społecznościowych) nachodzą na przycisk chatbota.

Przyciski szybkich akcji

Maksymalnie 3 przyciski wyświetlane na starcie rozmowy, zanim klient napisze pierwszą wiadomość. Kliknięcie przycisku automatycznie wysyła skonfigurowaną wiadomość.

Dla każdego przycisku ustawiasz:

• Etykieta — krótki tekst na przycisku (np. Bestsellery, Nowości, Prezenty)
• Wiadomość — pełne pytanie wysyłane do chatbota (np. Pokaż mi wasze bestsellery, Co nowego pojawiło się w tym tygodniu?)

Przykładowe konfiguracje:

Sklep odzieżowy:

Sklep elektroniczny:

Widoczność i zachowanie

Pokaż na urządzeniach mobilnych

Gdy wyłączone, chatbot nie będzie wyświetlany na telefonach i tabletach (ekrany < 768 px). Domyślnie: włączone.

Pokaż na komputerach

Gdy wyłączone, chatbot nie będzie wyświetlany na desktopie. Domyślnie: włączone.

Auto-otwieranie (Pro)

Chatbot automatycznie otwiera się po określonym czasie od wejścia na stronę. Ustaw opóźnienie w sekundach (1–60). Domyślnie: wyłączone.

Karty produktów

Gdy włączone, chatbot wyświetla rekomendacje jako interaktywne karty z:

• Zdjęciem produktu
• Nazwą i ceną (z rabatem jeśli dostępny)
• Statusem dostępności (dostępny / wyprzedany)
• Przyciskiem „Dodaj do koszyka"

Domyślnie: włączone. Zdecydowanie zalecamy pozostawienie włączonego.

Przycisk „Dodaj do koszyka"

Wyświetla przycisk bezpośrednio na kartach produktów w chacie. Klient może dodać produkt do koszyka bez wychodzenia z rozmowy. Domyślnie: włączone.

Integracja z listą życzeń

Wyświetla przycisk „Dodaj do listy życzeń" na kartach produktów. Wymaga zainstalowanej wtyczki YITH WooCommerce Wishlist. Domyślnie: wyłączone.

Upsell i cross-sell

• Upsell — AI może proponować droższe alternatywy dla oglądanego produktu
• Cross-sell — AI może proponować produkty uzupełniające (np. „do tego laptopa pasuje ta torba")

Obydwie opcje domyślnie: włączone.

Liczba produktów w kontekście

Ile produktów z katalogu wyszukiwarka AI pobiera dla każdego zapytania (5–100). Domyślnie: 12.

Wyższa wartość = więcej opcji do wyboru, ale nieznacznie wolniejsza odpowiedź. Dla dużych katalogów (1000+ produktów) zalecamy wartość 15–20.

Minimalna / maksymalna liczba kart

Ile kart produktów chatbot wyświetla w jednej odpowiedzi:

• Minimum: 1 (domyślnie: 1)
• Maksimum: 6 (domyślnie: 6)

Dla szybkiej odpowiedzi ustaw max 3–4. Dla prezentacji szerokiego wyboru zostaw 6.

Ukryj na stronach

Wpisz ID stron WordPress (po jednym w linii lub rozdzielone przecinkami), na których chatbot NIE ma się pojawiać.

Przykład zastosowania: strona kasy (checkout), strona logowania, strona regulaminu — jeśli nie chcesz, żeby chatbot rozpraszał klientów podczas finalizacji zakupu.

Jak znaleźć ID strony: wejdź w Strony → Wszystkie strony w panelu WordPress, najedź na wybraną stronę — ID pojawi się w adresie URL w stopce przeglądarki (np. post=42).

7. Ustawienia — Zaawansowane

Zakładka Zaawansowane zawiera najważniejsze opcje wpływające na jakość i charakter odpowiedzi chatbota. Większość sklepów nie musi zmieniać wszystkich ustawień — skup się na tych opisanych jako ważne.

Personalizacja AI

Szablon branżowy (ważne)

Sell.AI zawiera 12 gotowych profili branżowych, które dostosowują zachowanie AI do specyfiki Twojego asortymentu. Wybierz szablon najbardziej pasujący do Twojego sklepu:

Po wybraniu szablonu AI automatycznie dostosowuje pytania doprecyzowujące, słownictwo i sposób rekomendacji.

Język sklepu

Domyślnie: Auto-detekcja — chatbot odpowiada w języku, którym pisze klient. Możesz wymusić konkretny język (np. zawsze po polsku), jeśli Twój sklep działa wyłącznie na jeden rynek.

Własny system prompt (zaawansowane)

Pole tekstowe, w którym możesz wpisać własne instrukcje dla AI. Nadpisuje wybrany szablon branżowy.

Używaj tego pola, jeśli:

• Twoja branża nie pasuje do żadnego szablonu
• Chcesz nadać chatbotowi specyficzny charakter lub imię
• Masz szczególne wymagania dotyczące tego, co chatbot może lub nie może mówić

Przykład fragmentu własnego promptu:

Jesteś Kasią, przyjazną doradczynią w sklepie z naturalnymi kosmetykami EkoBeauty.

Zawsze pytaj o typ skóry klienta przed poleceniem produktu. Nie polecaj produktów zawierających parabeny — nasz sklep ich nie sprzedaje.

Kontekst sklepu

FAQ sklepu

Wklej tutaj najczęściej zadawane pytania i odpowiedzi dotyczące Twojego sklepu. AI będzie używała tych informacji, gdy klient zapyta o coś związanego z Twoją polityką.

Co warto wpisać:

• Czas i koszty dostawy
• Polityka zwrotów i reklamacji
• Dostępne metody płatności
• Godziny obsługi klienta
• Informacje o programie lojalnościowym
• Czy sklep wysyła za granicę

Przykład:

Czas dostawy: 1-3 dni robocze (kurier DPD/InPost)

Dostawa: darmowa od 199 zł, poniżej tej kwoty – 12 zł Zwroty: 30 dni bez podawania przyczyny Płatności: karta, BLIK, przelew, PayPal, za pobraniem

Aktualne promocje

Wpisz informacje o bieżących promocjach, rabatach i wyprzedażach. AI uwzględni je w rekomendacjach.

Przykład:

Weekend sale: -20% na wszystkie sukienki (kod: SUKIENKA20)

Darmowa dostawa na zamówienia powyżej 150 zł (tylko do końca tygodnia) Nowa kolekcja wiosna/lato 2026 już dostępna

Styl odpowiedzi

Ton odpowiedzi

Jak AI komunikuje się z klientem:

• Formalny — „Dzień dobry, w czym mogę Panu/Pani pomóc?" — dla sklepów profesjonalnych (medyczny, B2B)
• Przyjazny (domyślny) — „Cześć! Chętnie pomogę!" — dla większości sklepów
• Luźny — „Hej! Co cię interesuje?" — dla sklepów młodzieżowych, lifestyle'owych

Długość odpowiedzi

• Zwięzła — krótkie odpowiedzi, minimum tekstu, od razu do rzeczy
• Wyważona (domyślna) — kilka zdań kontekstu + produkty
• Szczegółowa — obszerne odpowiedzi z wyjaśnieniami, porównaniami, wskazówkami

Tryb sprzedaży

Jak aktywnie AI stara się zachęcić do zakupu:

• Pasywny — odpowiada na pytania, nie narzuca. Dla sklepów gdzie klient jest ekspertem (B2B, części zamienne)
• Aktywny (domyślny) — naturalnie sugeruje zakup, pyta o potrzeby, zachęca do finalizacji
• Agresywny — mocno ukierunkowany na sprzedaż, częste CTA, podkreślanie promocji. Może być irytujący jeśli użyty niewłaściwie

Persona AI

Charakter asystenta:

• Pomocnik (domyślny) — neutralny, kompetentny, pomocny
• Ekspert — autorytatywny, szczegółowy, techniczny. Dla sklepów specjalistycznych
• Stylista — kreatywny, inspirujący. Dla mody, dekoracji, kosmetyków
• Sprzedawca — skoncentrowany na zamknięciu sprzedaży

Emoji w odpowiedziach

Gdy włączone, AI używa emoji, aby odpowiedzi były bardziej żywe i przyjazne. Domyślnie: wyłączone.

Tematy zabronione

Lista tematów, o których chatbot ma odmawiać rozmowy. Wpisz tematy oddzielone przecinkami.

Przykład: polityka, religia, konkurencja, ceny u konkurentów

Historia i limity

Długość historii rozmowy

Ile ostatnich tur rozmowy (pytanie + odpowiedź = 1 tura) AI przechowuje w kontekście. Zakres: 1–30 tur. Domyślnie: 10 tur.

Większa historia = AI lepiej rozumie kontekst i poprzednie pytania klienta, ale = wyższy koszt API (więcej tokenów wysyłanych z każdym zapytaniem).

Dla typowego sklepu 8–10 tur jest wystarczające. Dla złożonych rozmów (B2B, konsultacje) zwiększ do 15–20.

Rate limiting — Ograniczenie liczby wiadomości

Możesz ograniczyć liczbę wiadomości, jaką klient może wysłać. Ustaw 0, aby wyłączyć limit (bez ograniczeń):

• Limit na sesję — maks. wiadomości w jednej sesji (od otwarcia do zamknięcia przeglądarki)
• Limit na godzinę — maks. wiadomości w ciągu godziny
• Limit na dzień — maks. wiadomości w ciągu doby

Przydatne do ochrony przed nadużyciami i kontroli kosztów API.

Katalog produktów

Czarna lista produktów

Lista ID produktów WooCommerce, które nigdy nie pojawią się w rekomendacjach chatbota. Wpisz ID oddzielone przecinkami lub po jednym w linii.

Użycie: produkty wycofane ze sprzedaży, produkty tylko dla wybranych klientów, produkty z błędnymi danymi.

Jak znaleźć ID produktu: wejdź w Produkty → Wszystkie produkty, najedź na produkt — ID pojawi się w URL.

Biała lista produktów

Lista ID produktów, które jako jedyne mogą pojawić się w rekomendacjach. Gdy lista jest pusta — nie ma ograniczeń. Gdy wypełniona — chatbot rekomenduje wyłącznie te produkty.

Użycie: sklepy chcące ograniczyć chatbota tylko do wybranych kategorii lub kolekcji.

Logi i powiadomienia

Logi rozmów

Gdy włączone, wszystkie rozmowy klientów są zapisywane w bazie danych. Możesz je przeglądać w sekcji Sell.AI → Analityka → Rozmowy. Domyślnie: włączone.

Retencja logów (dni)

Jak długo przechowywać logi rozmów (1–365 dni). Po upłynięciu tego czasu stare logi są automatycznie usuwane. Domyślnie: 30 dni.

Dłuższy okres retencji = więcej danych do analizy, ale większa baza danych. Dla RODO ustaw maksymalnie 30–90 dni.

Dzienny raport emailowy (Pro)

Gdy włączony, każdego ranka (ok. 7:00) na podany adres email wysyłane jest podsumowanie aktywności chatbota z poprzedniego dnia: liczba rozmów, leady, szacowany przychód.

Adres email do alertów

Email, na który trafiają powiadomienia o nowych leadach i dzienny raport. Domyślnie: adres administratora WordPress.

Linki prawne

Opcjonalne linki wyświetlane w stopce okna chatbota:

• Polityka prywatności — URL do Twojej strony z polityką prywatności
• Regulamin — URL do regulaminu sklepu
• FAQ — URL do strony z często zadawanymi pytaniami

Test A/B (Pro)

Możliwość testowania dwóch wersji chatbota jednocześnie:

• Wariant A — chatbot z aktualnym system promptem
• Wariant B — chatbot z alternatywnym promptem (wpisz go w pole „System prompt B")

50% klientów zobaczy wariant A, 50% wariant B. W analityce możesz porównać konwersje obu wariantów.

Inne opcje

Usuń dane przy deinstalacji

Gdy włączone, po usunięciu wtyczki z WordPressa wszystkie dane (ustawienia, logi, leady, embeddingi, tabele w bazie) zostaną trwale usunięte.

Domyślnie: wyłączone — przy deinstalacji dane pozostają (możesz je przywrócić reinstalując wtyczkę).

8. Przechwytywanie leadów

Moduł przechwytywania leadów pozwala zbierać adresy email klientów, którzy są zainteresowani produktem, ale go nie kupili — np. dlatego, że jest niedostępny lub potrzebują czasu do namysłu.

Co to jest lead capture?

Kiedy chatbot wykryje, że klient jest zainteresowany produktem (pyta o dostępność, cenę, specyfikację), ale zakup nie dochodzi do skutku — w oknie chatu automatycznie pojawia się krótki formularz z prośbą o podanie adresu email i imienia.

Zebrane dane trafiają do listy leadów w panelu administracyjnym, skąd możesz je eksportować lub ręcznie obsługiwać.

Włączenie i konfiguracja

Przejdź do Sell.AI → Ustawienia → Zaawansowane i znajdź sekcję Lead Capture.

Przechwytywanie leadów (włącz/wyłącz)

Główny przełącznik. Domyślnie: wyłączone.

Trigger — kiedy pojawia się formularz?

Wybierz, w jakim momencie chatbot wyświetla formularz zbierania danych:

Opóźnienie (sekundy)

Ile sekund po spełnieniu warunku triggera chatbot poczeka, zanim wyświetli formularz. Domyślnie: 3 sekundy.

Małe opóźnienie jest naturalne — formularz nie wyskakuje od razu, tylko po chwili, co wygląda bardziej organicznie.

Powiadomienie emailowe

Gdy włączone, za każdym razem gdy klient poda swój email, na adres administratora sklepu (lub adres z ustawień) trafia powiadomienie z:

• Imieniem i emailem klienta
• Produktem, którym był zainteresowany
• Fragmentem rozmowy (kontekst)

Lista leadów w panelu

Przejdź do Sell.AI → Analityka → Leady, aby zobaczyć wszystkich zebranych leadów.

Dla każdego leadu widoczne są:

• Imię i nazwisko (jeśli podał)
• Adres email
• Zainteresowany produktem — produkt, o który pytał w chacie
• Status — aktualny etap obsługi
• Data — kiedy lead został przechwycony

Zarządzanie statusami leadów

Każdy lead może mieć jeden z czterech statusów:

Aby zmienić status leadu: kliknij na status przy danym leadzie i wybierz nowy z listy. Zmiana jest zapisywana automatycznie.

Eksport leadów do CSV

Aby wyeksportować całą listę leadów do pliku Excel/CSV:

1. Przejdź do Sell.AI → Analityka → Leady
2. Kliknij przycisk Eksportuj CSV (w prawym górnym rogu tabeli)
3. Plik zostanie pobrany automatycznie na Twój komputer

Plik CSV zawiera wszystkie kolumny: imię, email, produkt, status, data. Możesz go otworzyć w Excelu lub zaimportować do systemu CRM czy Mailchimp.

Integracja z CRM / Mailchimp

Sell.AI udostępnia specjalny hook PHP, który pozwala zintegrować przechwytywanie leadów z zewnętrznymi systemami (Mailchimp, ActiveCampaign, HubSpot itp.). Wystarczy, że Twój deweloper doda odpowiedni kod do motywu lub wtyczki:

add_action( 'wooaic_lead_captured', function( $email, $name, $context, $session_id ) {

// Tutaj kod integracji z Mailchimp, CRM itp. }, 10, 4 );

9. Analityka i raporty

Panel analityczny znajdziesz w Sell.AI → Analityka. Pokazuje pełny obraz wydajności chatbota: ile kosztuje, ile zarabia i jak klienci z niego korzystają.

Wybór okresu

W prawym górnym rogu strony wybierz zakres dat:

• 7 dni — ostatni tydzień
• 14 dni — ostatnie dwa tygodnie
• 30 dni (domyślny) — ostatni miesiąc
• 90 dni — ostatnie 3 miesiące (Pro)

Kluczowe wskaźniki

Rozmowy

Łączna liczba sesji chatbota (unikalnych rozmów) w wybranym okresie. Jedna sesja = jedna wizyta klienta w chacie, niezależnie od liczby wiadomości.

Wiadomości

Łączna liczba wiadomości wysłanych przez klientów w wybranym okresie.

Wskaźnik konwersji Chat → Zamówienie

Procent sesji chatbota, które zakończyły się złożeniem zamówienia. Obliczany jako: (liczba zamówień z chatbota / łączna liczba sesji chatbota) × 100%.

Typowy dobry wynik: 5–15% dla e-commerce. Jeśli jest niższy — sprawdź jakość rekomendacji produktów.

Przychód z chatbota

Suma wartości zamówień złożonych przez klientów, którzy korzystali z chatbota podczas sesji zakupowej. Waluta wyświetlana jest w walucie Twojego sklepu.

Dodano do koszyka

Ile razy klienci kliknęli przycisk „Dodaj do koszyka" bezpośrednio w oknie chatbota.

Dodano do listy życzeń

Ile razy klienci kliknęli „Dodaj do listy życzeń" w kartach produktów chatbota.

Koszt API OpenAI (szacunkowy)

Przybliżony koszt tokenów OpenAI zużytych przez chatbota w wybranym okresie (w USD). Obliczany na podstawie liczby tokenów według cennika OpenAI.

Łączna liczba tokenów

Suma tokenów wejściowych i wyjściowych zużytych przez chatbota. Pomocne przy monitorowaniu kosztów.

Wykresy

Rozmowy w czasie

Wykres liniowy pokazujący liczbę rozmów dziennie w wybranym okresie. Pozwala zauważyć trendy, sezonowość i wpływ kampanii marketingowych na aktywność chatu.

Przychód w czasie

Wykres liniowy pokazujący dzienny przychód przypisany do chatbota. Koreluj z innymi kanałami marketingowymi.

Top produkty

Lista produktów najczęściej omawianych przez AI w rekomendacjach. Dla każdego produktu widoczna jest:

• Nazwa produktu
• Liczba wystąpień w rozmowach
• Link do edycji produktu w WooCommerce

Użyj tej listy, aby zrozumieć, które produkty cieszą się największym zainteresowaniem klientów przez chatbota — i czy odpowiednio je promuje.

Dystrybucja intencji

Wykres kołowy pokazujący, w jakim celu klienci używają chatbota:

Eksport danych

Aby wyeksportować dane analityczne do pliku CSV:

1. Wybierz interesujący Cię okres
2. Kliknij przycisk Eksportuj CSV w prawym górnym rogu
3. Plik zostanie automatycznie pobrany

Plik zawiera: datę, liczbę rozmów, wiadomości, konwersje, przychód, tokeny i szacowany koszt API dla każdego dnia okresu.

10. Historia rozmów

Historia rozmów to archiwum wszystkich sesji chatbota. Znajdziesz ją w Sell.AI → Analityka → Rozmowy.

Do czego służy historia rozmów?

• Zrozumienie, czego szukają Twoi klienci
• Identyfikacja pytań, na które chatbot odpowiada słabo
• Sprawdzenie jakości rekomendacji produktów
• Analiza najczęstszych problemów i potrzeb klientów
• Weryfikacja, czy chatbot działa zgodnie z Twoimi oczekiwaniami

Przeglądanie rozmów

Na stronie historii wyświetlana jest lista sesji w kolejności od najnowszej. Dla każdej sesji widoczne są:

• Data i godzina rozpoczęcia rozmowy
• ID sesji — unikalny identyfikator (anonimowy)
• Liczba wiadomości — ile wiadomości wymieniły strony
• Podgląd — pierwsze kilka słów pierwszej wiadomości klienta

Kliknij na dowolną sesję, aby rozwinąć pełną rozmowę.

Podgląd pełnej rozmowy

Po rozwinięciu sesji widzisz kompletną rozmowę:

• Wiadomości klienta wyświetlają się po prawej stronie (jak w prawdziwym czacie)
• Odpowiedzi chatbota wyświetlają się po lewej stronie
• Każda wiadomość ma znacznik czasu

Filtrowanie i wyszukiwanie

Filtr po dacie: Zawęź wyniki do wybranego przedziału czasowego (od–do).

Filtr po typie wiadomości:

• Wszystkie wiadomości
• Tylko wiadomości klientów (role: user)
• Tylko odpowiedzi chatbota (role: assistant)

Wyszukiwanie w treści: Wpisz słowo kluczowe, aby znaleźć rozmowy zawierające konkretną frazę. Przydatne np. gdy chcesz znaleźć wszystkie rozmowy, w których klienci pytali o konkretny produkt lub problem.

Automatyczne czyszczenie logów

Stare logi są automatycznie usuwane co noc. Czas przechowywania konfigurujesz w Ustawienia → Zaawansowane → Retencja logów (domyślnie 30 dni).

Jeśli chcesz zachować logi dłużej — zwiększ wartość retencji przed upłynięciem terminu. Logi, które już zostały usunięte, nie mogą być odtworzone.

Prywatność i RODO

Wszystkie logi rozmów są przechowywane wyłącznie na Twoim serwerze WordPress — żadne dane nie są wysyłane do zewnętrznych serwerów Sell.AI. Rozmowy są powiązane z anonimowym ID sesji, nie z danymi osobowymi klienta (chyba że klient sam podał swoje dane w trakcie rozmowy).

Przy konfiguracji czasu retencji uwzględnij wymagania RODO obowiązujące w Twojej jurysdykcji.

11. Indeks wyszukiwania AI

Indeks wyszukiwania to „baza wiedzy" chatbota o Twoich produktach. Im lepiej zbudowany indeks, tym trafniejsze rekomendacje. Znajdziesz go w Sell.AI → Search & AI (zakładka Search Index dla indeksu słów kluczowych; zakładka Pro Semantic Search (RAG) dla embeddingów).

Co to jest indeks i embeddingi? (wyjaśnienie dla laika)

Wyobraź sobie, że chatbot to sprzedawca, który musi znać cały asortyment sklepu na pamięć. Indeks to właśnie ta „pamięć":

Indeks słów kluczowych — lista wszystkich ważnych słów z nazw, opisów i atrybutów Twoich produktów. Gdy klient wpisuje „czarne buty rozmiar 42", chatbot szybko przeszukuje indeks i znajduje pasujące produkty.

Embeddingi (wektory semantyczne, RAG) — bardziej zaawansowana warstwa. Każdy produkt jest zamieniany na matematyczny „odcisk palca" (wektor liczb), który reprezentuje jego znaczenie. Dzięki temu chatbot rozumie, że „ciepła kurtka na zimę" = kurtki puchowe/zimowe, nawet jeśli klient nie użył dokładnie tych słów.

Zakładka Search Index zawiera kartę indeksu słów kluczowych; zakładka Pro Semantic Search (RAG) zawiera kartę indeksu wektorowego.

Kiedy indeks buduje się automatycznie?

Sell.AI automatycznie aktualizuje indeks w kilku sytuacjach:

• Gdy dodasz nowy produkt do WooCommerce
• Gdy zaktualizujesz istniejący produkt (zmiana nazwy, opisu, ceny)
• Gdy usuniesz produkt (wpis jest usuwany z indeksu)
• Każdej nocy o 3:00 — pełne odświeżenie indeksu wektorowego (nightly refresh)

W większości przypadków indeks jest zawsze aktualny bez żadnej ręcznej interwencji.

Status indeksu

Kliknij Check status w odpowiedniej karcie, żeby zobaczyć aktualny stan:

Indeks słów kluczowych:

• Products in index — liczba produktów w indeksie
• Tokens — liczba zaindeksowanych tokenów/słów kluczowych
• To synchronize — produkty czekające na synchronizację (czerwone = wymaga akcji)

Indeks wektorowy (RAG):

• Total products — łączna liczba produktów w sklepie
• In index — ile produktów ma już wygenerowany wektor semantyczny
• Missing — ile produktów jeszcze nie jest w indeksie (czerwone = wymaga akcji)
• Estimated time — szacowany czas do zakończenia indeksowania
• Backend — silnik harmonogramowania (action_scheduler lub wp-cron)
• Last full indexing — data ostatniego pełnego indeksowania

Dąż do 0 brakujących w obu indeksach. Jeśli Missing > 0 — uruchom indeksowanie.

Ręczne odbudowanie indeksu słów kluczowych

Kiedy używać: Po imporcie dużej liczby produktów, po zmianie struktury katalogu, po zbiorczym wzbogacaniu produktów (AI Enrichment).

Jak uruchomić:

1. Przejdź do Sell.AI → Search & AI → zakładka Search Index
2. W karcie Search index kliknij Rebuild index
3. Poczekaj na komunikat potwierdzający (operacja synchroniczna, zwykle kilkadziesiąt sekund)
4. Przycisk Synchronize aktualizuje tylko produkty zmienione od ostatniego przebudowania — szybsza opcja dla bieżącej konserwacji

Ręczne odbudowanie indeksu wektorowego (RAG)

Kiedy używać: Po imporcie produktów, gdy chatbot nie rozumie zapytań semantycznych, gdy Missing > 0 w statusie.

Jak uruchomić:

1. Przejdź do Sell.AI → Search & AI → zakładka Semantic Search (RAG) (Pro)
2. W karcie Vector index (RAG) wybierz jedną z opcji:
   • Reindex all — usuwa cały indeks i buduje go od nowa (potwierdź w oknie dialogowym). Używaj po imporcie lub gdy indeks jest niespójny.
   • Index new only — dodaje tylko produkty których jeszcze nie ma w indeksie, bez kasowania istniejących wektorów. Szybsza opcja po dodaniu kilku nowych produktów.
3. W trakcie indeksowania pojawi się pasek postępu oraz scrollowalny log produktów (✓ lub ✗ przy każdym produkcie)
4. Kliknij Stop aby przerwać w dowolnym momencie — dotychczas zaindeksowane produkty zostają zachowane
5. Po zakończeniu zobaczysz komunikat „Indexing complete!"

Czyszczenie indeksu wektorowego

Przycisk Clear index w karcie Vector index (RAG) usuwa wszystkie wektory semantyczne. Jest to operacja nieodwracalna.

Kiedy używać: Gdy indeks semantyczny jest mocno niespójny (np. po imporcie/eksporcie bazy danych), lub gdy Sell.AI rekomenduje to w komunikacie diagnostycznym.

Po wyczyszczeniu uruchom Reindex all, żeby odbudować indeks od nowa.

Tryb debug wyszukiwania

Dostępny w Sell.AI → System → zakładka Diagnostyka → sekcja Debug Reports.

Po wykonaniu wyszukiwania w chacie wyświetla szczegółowe informacje techniczne:

• Które produkty zostały znalezione i z jakim wynikiem podobieństwa
• Które słowa kluczowe zostały dopasowane
• Ile kandydatów przeszło do finalnego wyboru

Używaj tylko podczas diagnostyki — nie włączaj trwale w środowisku produkcyjnym.

12. Synonimy i Baza wiedzy

Synonimy i baza wiedzy to narzędzia, które pomagają chatbotowi lepiej rozumieć specyficzne słownictwo Twojego sklepu i branży. Dostępne w zakładce Sell.AI → Search & AI → Synonimy.

Czym są synonimy i dlaczego są ważne?

Różni klienci opisują ten sam produkt różnymi słowami:

• Klient pisze „pendrive" → sklep ma to w katalogu jako „pamięć USB"
• Klient pisze „lodówka" → produkt nazywa się „chłodziarka"
• Klient pisze „kurtka zimowa" → w sklepie kategoria to „kurtki puchowe"

Synonimy uczą chatbota, że te wyrażenia oznaczają to samo — dzięki czemu wyszukiwanie jest trafniejsze, nawet gdy klient nie użył dokładnie tych słów co Ty w nazwie produktu.

Przeglądanie listy synonimów

Na stronie Synonimy wyświetlana jest tabela wszystkich skonfigurowanych par synonimów:

• Termin główny — słowo/fraza używane w katalogu sklepu
• Synonimy — alternatywne wyrażenia klientów prowadzące do tego terminu
• Źródło — skąd pochodzi synonim (własny / automatyczny / atrybuty WooCommerce)

Dodawanie synonimu ręcznie

1. Kliknij Dodaj synonim
2. W polu Termin główny wpisz słowo z Twojego katalogu (np. pamięć USB)
3. W polu Synonimy wpisz alternatywne wyrażenia oddzielone przecinkami (np. pendrive, flashdrive, klucz USB, usb key)
4. Kliknij Zapisz

Auto-generowanie synonimów przez AI (Pro)

Sell.AI Pro może automatycznie zaproponować synonimy na podstawie kategorii i tagów Twoich produktów, dodając je od razu do listy powyżej:

1. Przejdź do zakładki Sell.AI → Search & AI → Synonimy
2. W karcie AI Synonym Auto-generate kliknij Generate synonyms
3. AI skanuje kategorie i tagi produktów i zapisuje sugerowane alternatywne nazwy (regionalne, slangowe, skróty) od razu na liście synonimów — bez etapu ręcznego zatwierdzania
4. Terminy, które już mają wpis synonimu (dodany ręcznie lub przez wcześniejsze uruchomienie), są pomijane, więc ponowne uruchomienie uzupełnia tylko braki

Baza wiedzy

Baza wiedzy to rozszerzony słownik kontekstowy, który Sell.AI buduje automatycznie, analizując Twoje produkty. Zawiera:

• Marki — nazwy marek wykryte w tytułach produktów (Samsung, Nike, Bosch itp.)
• Urządzenia i kompatybilność — np. „PS5 → HDMI 2.1", „iPhone 15 → USB-C"
• Przypadki użycia — mapowania „do czego" na kategorie produktów (np. „gaming" → konsole, słuchawki gamingowe)
• Pary synonimów — z bazy auto-generacji

Baza wiedzy jest odświeżana automatycznie co noc. Nie wymaga ręcznej konfiguracji — działa w tle.

13. Wzbogacanie produktów (Product Enrichment)

Pro Ta funkcja jest dostępna w Sell.AI Pro.

Wzbogacanie produktów to proces, w którym AI analizuje każdy produkt i generuje dla niego dodatkowe słowa kluczowe oraz wzbogacony opis. Znajdziesz tę funkcję w zakładce Sell.AI → Search & AI → AI Enrichment.

Po co wzbogacać produkty?

Standardowe dane produktu w WooCommerce to zazwyczaj: nazwa, krótki opis, długi opis, atrybuty. Często są one napisane technicznie lub skrótowo.

AI wzbogacanie dodaje do każdego produktu:

• Słowa kluczowe AI — synonimy, potoczne nazwy, przypadki użycia, powiązane terminy
• Wzbogacony opis — bardziej konwersacyjne frazy opisujące produkt z perspektywy potrzeb klienta

Dzięki temu chatbot dużo lepiej dopasowuje produkty do naturalnych pytań klientów.

Przykład:

Produkt: „Słuchawki Sony WH-1000XM5"

Standardowe dane: „Słuchawki nauszne z ANC, Bluetooth 5.2, 30h bateria"

Po wzbogaceniu AI: dodane słowa kluczowe: słuchawki do pracy zdalnej, słuchawki wyciszające, słuchawki do podróży, ANC, noise cancelling, home office, bezprzewodowe, długa bateria, premium

Wzbogacanie pojedynczego produktu

1. Przejdź do WooCommerce → Produkty → edytuj produkt
2. W dolnej części strony edycji znajdź metabox Sell.AI — Wzbogacanie AI
3. Kliknij Generuj słowa kluczowe AI
4. Poczekaj chwilę — AI wygeneruje i zapisze słowa kluczowe dla tego produktu

Wzbogacanie masowe

Aby wzbogacić wszystkie produkty naraz:

1. Przejdź do zakładki Sell.AI → Search & AI → AI Enrichment
2. Zobaczysz listę produktów z informacją, które zostały już wzbogacone
3. Kliknij Wzbogać wszystkie produkty
4. Pasek postępu pokaże aktualny stan. Dla 100 produktów trwa ok. 5–10 minut
5. Po zakończeniu kliknij Odbuduj indeks, aby chatbot od razu korzystał z nowych danych

Monitorowanie postępu

Na stronie wzbogacania widoczne są statystyki:

• Liczba produktów do wzbogacenia
• Liczba już wzbogaconych
• Procent ukończenia
• Szacowany czas pozostały

Możesz zamknąć stronę — wzbogacanie trwa w tle i wznowi się przy następnym odwiedzeniu strony lub automatycznie podczas kolejnego zadania cron.

14. Diagnostyka

Panel diagnostyczny pomaga sprawdzić, czy wszystkie komponenty wtyczki działają prawidłowo. Znajdziesz go w Sell.AI → System (zakładka Diagnostyka).

Stan systemu

Sekcja pokazuje listę kontrolnych z wynikiem OK / Błąd:

Wszystkie pozycje powinny mieć status OK. Jeśli któraś ma status Błąd — postępuj zgodnie ze wskazówką wyświetlaną obok.

Tabele bazy danych

Lista tabel WordPress utworzonych przez Sell.AI z liczbą rekordów w każdej:

Jeśli któraś tabela jest pusta lub brakuje jej — użyj przycisku Napraw tabele, który stworzy brakujące tabele od nowa.

Zadania cron

Lista zaplanowanych zadań (WordPress cron):

Kolumna Następne uruchomienie pokazuje, kiedy zadanie zostanie wykonane. Jeśli data jest w przeszłości — zadanie jest „przeterminowane" i uruchomi się przy najbliższej wizycie na stronie sklepu.

Test połączenia z API

Kliknij Testuj połączenie OpenAI, aby sprawdzić, czy serwer może połączyć się z API OpenAI. Wynik pokaże:

• Status połączenia (OK / Błąd)
• Czas odpowiedzi (ms)
• Aktualnie wybrany model
• Dostępne saldo kredytów (jeśli klucz ma przypisane kredyty)

15. Shortcody — osadzanie chatu na stronie

Oprócz pływającego widgetu w rogu strony, Sell.AI można osadzić bezpośrednio w treści strony lub posta WordPress za pomocą shortcodów.

[woo_ai_chatbot] — Chat inline

Osadza okno chatbota bezpośrednio w treści strony (nie jako pływający widget, lecz jako element strony).

[woo_ai_chatbot]

Opcjonalny parametr product_id — jeśli podasz ID produktu, chatbot od razu będzie „wiedział" o którym produkcie rozmawiamy i dopasuje kontekst:

[woo_ai_chatbot product_id="123"]

Zastosowanie: Dedykowana strona „Pomoc / Doradca zakupowy", strona kategorii, landing page z chatbotem.

[wooaic_fullpage] — Pełnoekranowy chat

Wyświetla chatbota w trybie pełnoekranowym — cała strona jest poświęcona rozmowie. Po lewej stronie widoczny jest czat, po prawej produkty rekomendowane przez AI.

[wooaic_fullpage]

Opcjonalny parametr product_id:

[wooaic_fullpage product_id="456"]

Zastosowanie: Tworzenie strony „AI Shopping Assistant" jako osobnej podstrony sklepu, na którą możesz kierować ruch z reklam.

[wooaic_recommendations] — Karuzela rekomendacji AI

Wyświetla siatkę/karuzelę produktów rekomendowanych przez AI — bez okna chatbota. Produkty są dobierane dynamicznie na podstawie aktywności klienta (historia przeglądania, koszyk).

[wooaic_recommendations]

Dostępne parametry:

Przykład pełny:

[wooaic_recommendations limit="12" columns="4" title="Może Ci się spodobać" context="cart"]

Zastosowanie: Sekcja „Polecane" na stronie głównej, strona „Dziękujemy za zakup", sidebar, stopka kategorii.

Jak dodać shortcode do strony?

Metoda 1 — Edytor Gutenberg (blok):

1. W edytorze strony kliknij + (Dodaj blok)
2. Wyszukaj i dodaj blok Shortcode
3. Wpisz shortcode i zapisz stronę

Metoda 2 — Classic Editor:

1. Wpisz shortcode bezpośrednio w treści strony
2. Kliknij Aktualizuj/Opublikuj

16. Proaktywne zaproszenia (Triggers)

Pro Ta funkcja jest dostępna w Sell.AI Pro.

Sell.AI może sam inicjować kontakt z klientem, wyświetlając wiadomość zachęcającą do rozmowy w odpowiednim momencie — bez czekania, aż klient sam kliknie przycisk chatbota.

Jak to działa?

Gdy trigger się uruchomi, w oknie chatbota pojawia się „bąbelek" z zachęcającą wiadomością. Klient może ją kliknąć (co otwiera pełne okno chatu) lub zignorować. Każdy trigger uruchamia się tylko raz na sesję — nie „spamuje" klienta wielokrotnie.

Dostępne triggery

1. Głębokość przewinięcia (Scroll Depth)

Uruchamia się gdy: Klient przewinie stronę w dół do określonego procentu jej długości.

Domyślne ustawienie: 60% strony

Przykładowa wiadomość: Szukasz czegoś konkretnego? Chętnie pomogę! 👋

Najlepiej sprawdza się na: Stronach kategorii, stronach produktów, długich stronach z dużą ilością treści.

2. Exit Intent (Zamiar wyjścia)

Uruchamia się gdy: Kursor myszy opuszcza obszar strony (górna krawędź przeglądarki) — co sugeruje, że klient zamierza zamknąć kartę lub przejść do innej strony.

Działa tylko na: Komputerach stacjonarnych i laptopach (na mobilnych ten trigger nie działa ze względu na brak kursora myszy).

Przykładowa wiadomość: Zanim wyjdziesz — mogę pomóc Ci znaleźć coś odpowiedniego? 😊

Najlepiej sprawdza się na: Stronach produktów, koszyku, stronach kategorii.

3. Powrót na stronę (Return Visitor)

Uruchamia się gdy: Klient wraca na stronę po wcześniejszej wizycie (np. zamknął przeglądarkę i wrócił innego dnia).

Okno czasowe: 30 dni — jeśli klient odwiedził stronę w ciągu ostatnich 30 dni, jest traktowany jako powracający.

Przykładowa wiadomość: Witaj z powrotem! 🙌 Pamiętam, że byłeś/aś tu ostatnio. Mogę Ci w czymś pomóc?

4. Czas na stronie (Time on Page)

Uruchamia się gdy: Klient spędzi na stronie określoną liczbę sekund.

Domyślne ustawienie: 45 sekund

Przykładowa wiadomość: Przeglądasz już chwilę — widzę, że poświęcasz czas na wybór. Mogę pomóc? 🛍️

Najlepiej sprawdza się na: Stronach produktów, stronach kategorii z dużą liczbą produktów.

Konfiguracja triggerów

Triggery konfiguruje się w Sell.AI → Ustawienia → Zaawansowane → Proaktywne zaproszenia. Dla każdego triggera możesz ustawić:

• Czy jest włączony
• Próg (% strony / sekundy)
• Treść wiadomości w bąbelku

17. Integracje

WooCommerce

Sell.AI jest w pełni zintegrowany z WooCommerce:

• Przeszukuje katalog produktów WooCommerce (nazwy, opisy, kategorie, tagi, atrybuty, ceny)
• Obsługuje produkty proste i produkty z wariantami (rozmiar, kolor itp.)
• Dodaje produkty bezpośrednio do koszyka WooCommerce
• Śledzi zamówienia i przypisuje je do sesji chatbota
• Jest zgodny z WooCommerce HPOS (High-Performance Order Storage)
• Działa z blokami Gutenberg (koszyk, checkout)

YITH WooCommerce Wishlist

Jeśli masz zainstalowaną wtyczkę YITH WooCommerce Wishlist, Sell.AI automatycznie wykryje ją i doda przycisk „Dodaj do listy życzeń" na kartach produktów w chacie.

Konfiguracja:

1. Zainstaluj i aktywuj YITH WooCommerce Wishlist
2. W Sell.AI → Ustawienia → Wygląd i Zachowanie włącz opcję Integracja z listą życzeń
3. Gotowe — przycisk pojawi się automatycznie

Mailchimp / CRM / Newsletter

Sell.AI nie ma wbudowanej integracji z Mailchimp, ale zapewnia specjalny punkt integracji (hook PHP), z którego mogą korzystać deweloperzy:

// Dodaj do functions.php motywu lub własnej wtyczki:

add_action( 'wooaic_lead_captured', function( $email, $name, $context, $session_id ) { // Przykład: dodaj email do listy Mailchimp $mailchimp = new MailchimpMarketing\ApiClient(); $mailchimp->setConfig(['apiKey' => 'TWOJ_KLUCZ', 'server' => 'us1']); $mailchimp->lists->addListMember('ID_LISTY', [ 'email_address' => $email, 'status'        => 'subscribed', 'merge_fields'  => ['FNAME' => $name], ]); }, 10, 4 );

Hook wooaic_lead_captured jest wywoływany każdorazowo gdy klient poda swój email w formularzu lead capture. Parametry:

• $email — adres email klienta
• $name — imię klienta (może być puste)
• $context — informacja o produkcie, którym był zainteresowany
• $session_id — ID sesji chatbota

Bramki płatności

Sell.AI nie ingeruje w proces płatności — współpracuje z dowolną bramką płatności zainstalowaną w WooCommerce (Przelewy24, PayU, Stripe, PayPal, BLIK, Dotpay i inne).

18. Plany i limity funkcji

Sell.AI jest dostępny w wersji darmowej (z katalogu WordPress.org) oraz w wersji Pro z dożywotnią licencją. Wersja darmowa jest w pełni funkcjonalna i nie ma żadnych limitów wiadomości, czasu ani liczby produktów.

Pakiety Pro (licencja dożywotnia)

Pro kupujesz raz — bez subskrypcji i bez odnawiania. Wszystkie trzy pakiety mają identyczny zestaw funkcji Pro i różnią się wyłącznie liczbą stron (domen), na których możesz aktywować klucz:

Koszty AI rozliczasz bezpośrednio z OpenAI (własny klucz API) — Sell.AI nigdy nie pobiera opłat za użycie API.

Jak sprawdzić swoją licencję?

W wersji Pro przejdź do zakładki Sell.AI → System → Licencja. Wyświetlone są tam:

• Status licencji (aktywna / nieaktywna) i nazwa pakietu
• Liczba wykorzystanych stron (np. 1 / 3)
• Ważność: dożywotnia — licencja nie wygasa i nie wymaga odnawiania
• Klucz licencyjny
• Przyciski: Aktywuj licencję / Dezaktywuj tę stronę

Aktywacja licencji

1. Kup pakiet (Solo / Business / Agency) na stronie trysellai.com — po zakupie otrzymasz e-mailem klucz licencyjny oraz link do pobrania wtyczki Pro
2. Zainstaluj wtyczkę Pro i przejdź do zakładki Sell.AI → System → Licencja
3. Wpisz klucz licencyjny i kliknij Aktywuj licencję
4. Gotowe — wszystkie funkcje Pro zostaną natychmiast odblokowane na tej stronie. Aktywacja rejestruje domenę i zajmuje jeden slot z limitu pakietu.

Chcesz przenieść licencję na inną stronę? Na pierwszej stronie kliknij Dezaktywuj tę stronę, aby zwolnić slot, a następnie aktywuj klucz na nowej domenie.

19. FAQ i rozwiązywanie problemów

Chat nie pojawia się na stronie sklepu

Sprawdź kolejno:

1. Czy chatbot jest włączony? — Sell.AI → Ustawienia → API i Model → „Chatbot aktywny" musi być włączony.

1. Czy wpisałeś klucz API? — Bez klucza API chatbot jest zablokowany. Przejdź do Ustawień i wpisz klucz.

1. Czy strona nie jest na liście wyjątków? — Sell.AI → Ustawienia → Wygląd → „Ukryj na stronach" — upewnij się, że ID strony którą sprawdzasz nie jest na tej liście.

1. Czy opcja widoczności jest włączona? — Sprawdź „Pokaż na urządzeniach mobilnych" i „Pokaż na komputerach" — obydwie powinny być włączone.

1. Konflikt z motywem lub inną wtyczką? — Tymczasowo przełącz motyw na domyślny (np. Storefront) i sprawdź czy chat się pojawia. Jeśli tak — problem leży w motywie (wysoki z-index, transform na body itp.). Poinformuj swojego dewelopera.

1. Cache strony? — Jeśli używasz wtyczki do cache'owania (WP Super Cache, W3 Total Cache, LiteSpeed Cache), wyczyść cache i sprawdź ponownie.

Błąd klucza API / Chat nie odpowiada

Sprawdź:

1. Przejdź do Sell.AI → Ustawienia → API i Model i kliknij Przetestuj klucz API
2. Jeśli test pokazuje błąd: zaloguj się na platform.openai.com → API keys → sprawdź czy klucz jest aktywny i ma saldo
3. Jeśli klucz jest OK ale chat dalej nie odpowiada: sprawdź Sell.AI → System → Diagnostyka → Test połączenia — może Twój serwer ma zablokowane wychodzące połączenia HTTPS do api.openai.com

Chatbot nie znajduje produktów / pokazuje złe wyniki

Sprawdź i wykonaj po kolei:

1. Czy indeks jest zbudowany? Sell.AI → Search & AI → Search Index → sprawdź % pokrycia
2. Jeśli pokrycie < 100% — kliknij Rebuild index
3. Dla lepszych wyników uruchom AI Enrichment (Sell.AI → Search & AI → AI Enrichment)
4. Dodaj synonimy dla branżowego słownictwa (Sell.AI → Search & AI → Synonimy)
5. Sprawdź czy produkt nie jest na czarnej liście (Ustawienia → Zaawansowane → Czarna lista produktów)

Indeks nie buduje się / zatrzymuje się w połowie

Przyczyna: Najczęściej limit czasu PHP (max_execution_time) lub brak dostępu serwera do samego siebie (loopback).

Rozwiązania:

1. Zwiększ max_execution_time i memory_limit w PHP (skontaktuj się z hostem)
2. Upewnij się, że Twój serwer może wykonać żądanie HTTP do własnego adresu (hosting współdzielony czasem to blokuje)
3. Jeśli masz WooCommerce Action Scheduler — Sell.AI automatycznie go wykryje i użyje do bezpieczniejszego indeksowania w małych paczkach

Chat nie działa na urządzeniach mobilnych

1. Sprawdź opcję Pokaż na urządzeniach mobilnych (Ustawienia → Wygląd → musi być włączona)
2. Sprawdź czy Twój motyw nie ukrywa elementów position: fixed na mobile (znany problem z niektórymi motywami)
3. Sprawdź konsolę przeglądarki (F12) na telefonie (przez tryb debugowania Android/iOS) — czy nie ma błędów JavaScript

Jak zresetować rozmowę (wyczyścić historię)?

Klient może wyczyścić swoją rozmowę klikając ikonę kosza w oknie chatbota.

Administrator może wyczyścić wszystkie logi starsze niż X dni zmieniając Retencja logów w Ustawieniach → Zaawansowane.

Jak przenieść ustawienia na inną instalację WordPress?

(Dostępne w planie Pro) Przejdź do Sell.AI → Ustawienia → Licencja → Eksport ustawień. Pobierzesz plik JSON z całą konfiguracją. Na nowej instalacji użyj Importuj ustawienia, aby wgrać plik.

Gdzie zgłaszać błędy i pytać o pomoc?

• Email wsparcia: support@trysellai.com
• Baza wiedzy: trysellai.com/docs

Zgłaszając błąd, dołącz:

• Wersję WordPress i WooCommerce
• Wersję Sell.AI (widoczna w Sell.AI → System → Diagnostyka)
• Opis problemu i kroki do odtworzenia
• Zrzut ekranu lub nagranie ekranu jeśli to możliwe

Dokumentacja aktualna dla Sell.AI w wersji 1.4.2 (Free) / 4.7.0 (Pro). Ostatnia aktualizacja: Lipiec 2026.