Jak skonfigurować Virtual AI Consultant w WordPress i WooCommerce?

1. Instalacja i aktywacja wtyczki

1. Wejdź w panel WordPress.
2. Przejdź do: Wtyczki → Dodaj nową → Wyślij wtyczkę na serwer.
3. Wybierz plik ZIP wtyczki Virtual AI Consultant i kliknij Zainstaluj.
4. Po instalacji kliknij Aktywuj.
5. W menu bocznym WordPress pojawi się pozycja Virtual AI Consultant.
6. Przejdź do: Virtual AI Consultant → License i aktywuj licencję.

Co widzisz w zakładce License?

• Status — informacja, czy licencja jest aktywna, wygasła, niezweryfikowana albo działa w okresie przejściowym.
• Plan — nazwa planu, np. Basic albo Pro. Od planu zależy dostęp do raportów i AI Insights.
• Domain — domena, na której licencja została aktywowana.
• Valid until / expiry date — data ważności licencji.
• Refresh license — ręczne sprawdzenie aktualnego statusu licencji na serwerze.
• Deactivate license — odłączenie licencji od strony.

2. Basic i Pro — różnice między planami

Virtual AI Consultant może być sprzedawany w dwóch planach. Różnica między planami nie polega na blokowaniu podstawowego działania asystenta. Plan Basic zawiera funkcje potrzebne do obsługi klienta i sprzedaży, a plan Pro dodaje analizę skuteczności, raporty oraz AI Insights.

3. Szybka konfiguracja — minimum do uruchomienia chatu

Do pierwszego uruchomienia wystarczy wykonać kilka kroków. Pełną konfigurację możesz uzupełnić później.

1. Przejdź do Virtual AI Consultant → Settings.
2. Wybierz dostawcę AI: OpenAI, Claude albo Gemini.
3. Wklej odpowiedni klucz API dla wybranego dostawcy.
4. Ustaw wiadomość powitalną i tytuł widżetu.
5. Włącz automatyczny przycisk chatu albo użyj shortcode [ai_chat_widget].
6. Przejdź do Knowledge Base i wpisz podstawowe informacje o firmie.
7. Zapisz ustawienia i otwórz stronę w trybie incognito, aby przetestować widget jako klient.

4. Settings — główne ustawienia asystenta AI

Zakładka Settings zawiera ustawienia dostawcy AI, modelu, formularza klienta, źródeł wiedzy, wyglądu widżetu, limitów, GA4 i statusu zamówienia.

AI Provider & Model

• AI Provider — wybierz OpenAI, Claude albo Gemini.
• AI Model — wybierz model z listy dostępnej w panelu. Wtyczka pilnuje, aby model pasował do wybranego dostawcy.
• OpenAI API Key / Claude API Key / Gemini API Key — wklej klucz API dla dostawcy, którego używasz.

Lead Form — fields & validation

W tej sekcji określasz, czy klient ma wypełnić formularz przed rozpoczęciem rozmowy.

• Require lead form before chat — wymaga potwierdzenia formularza przed pierwszą wiadomością.
• Name, Email, Company, Phone — dla każdego pola możesz ustawić, czy ma być widoczne i czy ma być wymagane.

Knowledge Configuration & RAG Settings

• Base System Prompt — główna instrukcja dla asystenta AI, np. styl odpowiedzi, zasady sprzedażowe, sposób kierowania do kontaktu.
• General Knowledge — ogólna wiedza tekstowa, która może być używana w odpowiedziach.
• Data Sources for AI Assistant — wybór źródeł danych: baza wiedzy, XML, WooCommerce albo tryby łączone.
• Embedding Provider — OpenAI, Gemini albo brak embeddingów. Przy Claude można użyć odpowiedzi AI bez embeddingów lub bazę wiedzy w innym trybie.
• RAG Similarity Threshold — próg trafności fragmentów wiedzy. Dobry zakres startowy: 0.50–0.75.
• RAG Number of Chunks — liczba fragmentów wiedzy przekazywanych do odpowiedzi. Dobry start: 3–5.
• WooCommerce Text Search Limit — maksymalna liczba produktów pobieranych z WooCommerce w jednej odpowiedzi.

Appearance & Behavior

• Welcome Message in Widget — wiadomość powitalna widoczna w czacie.
• Widget title — tytuł widżetu, np. „AI Consultant”.
• Widget title icon URL — opcjonalny adres obrazka z biblioteki mediów.
• Show main widget button automatically — automatycznie pokazuje pływający przycisk chatu na stronie.
• Show shortcode [ai_chat_widget] — pozwala ręcznie wstawić widget w dowolnym miejscu strony.
• Button Color, Button Text Color, Button Hover Color — ustawienia kolorów przycisku.
• Voice response (TTS) — odpowiedź głosowa.
• Microphone (STT) — możliwość dyktowania wiadomości.
• Query limit per session — limit pytań klienta w jednej sesji.
• Do not show the widget button on these pages — lista adresów URL, na których przycisk ma być ukryty.

Chat Nudge — dymek zachęcający do rozmowy

Chat Nudge to krótki komunikat wyświetlany obok widgetu po określonym czasie. Ma zachęcić klienta do rozpoczęcia rozmowy, zanim opuści stronę.

• Enable nudge bubble — włącza dymek zachęcający do rozmowy.
• Nudge text — domyślny tekst dymka widoczny dla klienta.
• Per-page nudge text — osobne teksty dla konkretnych adresów URL lub ścieżek, np. /koszyk/ albo /produkt/.
• Display delay — po ilu sekundach od wejścia na stronę dymek ma się pojawić.

Advanced

• Email to receive conversations — adres e-mail, na który mogą trafiać rozmowy lub powiadomienia.
• Google Analytics 4 ID — identyfikator GA4, np. G-XXXXXXXXXX.
• Public REST token — token używany przez widżet dla użytkowników niezalogowanych.
• Order status checker — włącza scenariusz sprawdzania statusu zamówienia przez klienta.
• Order status button label — tekst przycisku, np. „Sprawdź status zamówienia”.
• Allow public order status check — pozwala sprawdzać status zamówienia klientom niezalogowanym, po podaniu numeru zamówienia i e-maila.
• Order status public API token — osobny token zabezpieczający publiczne zapytania o status zamówienia.

5. Knowledge Base — baza wiedzy asystenta

W tej zakładce wpisujesz dane, na podstawie których asystent AI ma odpowiadać klientom. Dane są zapisywane jako osobne pliki JSON w katalogu uploads.

Tryby źródeł danych dla AI

XML Product Feed for Embeddings

Jeżeli masz plik XML z produktami, wpisz jego ścieżkę w polu XML Product File Path. Po zapisaniu możesz wygenerować embeddingi ręcznie przyciskiem Generate Embeddings (XML + Web) Now albo ustawić harmonogram.

Website Sources — Web RAG

Możesz dodać listę adresów URL, z których asystent ma korzystać jako dodatkowego źródła wiedzy.

• Enable Website Sources — włącza źródła WWW.
• List of URLs — wpisz każdy adres w osobnej linii.
• Fetch Mode — wybierz Cache, Hybrid albo Live.
• Cache TTL — określa, jak długo treść strony ma być uznawana za aktualną.

6. Scenarios — scenariusze rozmów i szybkie akcje

Scenariusze pozwalają prowadzić klienta po gotowej ścieżce: do produktu, formularza, koszyka, statusu zamówienia lub lokalnej odpowiedzi bez użycia AI.

Przejdź do: Virtual AI Consultant → Scenarios.

• id — unikalny identyfikator scenariusza.
• label — nazwa widoczna jako kafelek lub szybka akcja.
• trigger — fraza uruchamiająca scenariusz.
• show_on_pages — typy stron, na których scenariusz ma być widoczny: all, home, product, product_category, shop, cart, checkout, my_account, page, post, other.
• rules — reguły typu redirect_link, collect_params albo local_response.
• flow_instructions — instrukcja dla użytkownika w ramach scenariusza.

Przykład prostego scenariusza JSON

Przykład pokazuje ogólną strukturę. W realnym wdrożeniu scenariusz możesz powiązać z formularzem, przekierowaniem, lokalną odpowiedzią albo AI fallback.

7. Assistant Schedule — harmonogram pracy asystenta

Zakładka Assistant Schedule pozwala określić, kiedy widget ma być dostępny na stronie.

Jeżeli pole harmonogramu zostawisz puste, asystent może działać cały czas. Jeżeli chcesz ograniczyć godziny pracy, wpisz harmonogram w formacie JSON.

Przykład powyżej włącza asystenta od poniedziałku do piątku w godzinach 08:00–16:00.

8. WooCommerce — produkty, karty produktów i status zamówienia

Jeżeli WooCommerce jest aktywny, Virtual AI Consultant może wyszukiwać produkty, prezentować karty produktów, pomagać w wyborze i umożliwiać przejście do zakupu.

1. Przejdź do Settings → Knowledge & RAG.
2. W polu Data Sources for AI Assistant wybierz źródło zawierające WooCommerce, np. WooCommerce only albo tryb łączony z bazą wiedzy.
3. Ustaw WooCommerce Text Search Limit, np. 3 produkty.
4. Włącz Order status checker, jeśli klient ma sprawdzać status zamówienia z poziomu chatu.

• Proste produkty mogą mieć przycisk dodania do koszyka.
• Produkty wariantowe mogą prowadzić do wyboru wariantu.
• Karty produktów mogą generować statystyki wyświetleń, kliknięć i kliknięć dodania do koszyka.

Karty produktów i dodawanie do koszyka

• Asystent może pokazać nazwę produktu, cenę, dostępność, zdjęcie, opis i link.
• Produkt prosty może być dodany do koszyka z poziomu czatu, jeżeli jest dostępny i możliwy do kupienia.
• Produkt wariantowy powinien prowadzić klienta do strony produktu, aby wybrał wariant.
• Wtyczka może rozpoznawać produkt po ID, SKU albo adresie URL.
• Po kliknięciu dodania do koszyka WooCommerce może odświeżyć fragmenty koszyka.

Status zamówienia

Po włączeniu Order status checker klient może sprawdzić status zamówienia. Dla bezpieczeństwa powinien podać numer zamówienia i adres e-mail użyty przy zakupie.

9. Abandoned Cart — odzyskiwanie porzuconych koszyków

Moduł porzuconych koszyków działa w WooCommerce i pozwala wykrywać koszyki, zapisywać dane klienta oraz wysyłać przypomnienia e-mail.

Przejdź do: Virtual AI Consultant → Abandoned Cart.

• Enable Abandoned Cart — włącza wykrywanie koszyków i przypomnienia.
• Inactivity → mark as abandoned — po ilu minutach koszyk ma być uznany za porzucony.
• Reminder #1 — kiedy wysłać pierwsze przypomnienie.
• Reminder #2 — kiedy wysłać drugie przypomnienie.
• Recover link TTL — ważność linku powrotu do koszyka.
• Redirect recovered user to — koszyk, checkout albo własny URL.
• Email Templates — temat, nadawca i treść wiadomości.

Placeholdery w wiadomościach e-mail

W treści przypomnień możesz używać zmiennych, które wtyczka podmieni na dane koszyka lub kuponu. Najważniejsze przykłady:

• {{cart_value}} — wartość koszyka.
• {{cart_items}} — lista produktów z koszyka.
• {{recover_url}} — link przywracania koszyka.
• {{recover_link}} — gotowy link HTML do odzyskania koszyka.
• {{coupon_code}}, {{coupon_discount}}, {{coupon_block}} — dane kuponu, jeżeli włączony jest moduł Cart Coupons.

Testy modułu

W panelu Abandoned Cart możesz wysłać testową wiadomość e-mail oraz ręcznie uruchomić skanowanie koszyków. Używaj tego po zmianie szablonów e-mail lub ustawień czasu przypomnień.

10. Cart Coupons — dynamiczne kupony dla koszyków

Dynamiczne kupony mogą być automatycznie dodawane do wiadomości o porzuconym koszyku. To pomaga zwiększyć szansę powrotu klienta do zakupu.

Przejdź do: Virtual AI Consultant → Cart Coupons.

• Enable dynamic coupons — włącza kupony w wiadomościach odzyskujących koszyk.
• Coupon prefix — prefiks kodu kuponu, np. VAAI.
• Discount type — rabat procentowy albo kwotowy.
• Coupon validity — czas ważności kuponu.
• Discount rules by cart value — różne rabaty dla różnych wartości koszyka.
• Coupon effectiveness report — raport wygenerowanych, użytych i klikniętych kuponów.

11. Checkout Rescue — pomoc w koszyku i płatności

Checkout Rescue wyświetla pomoc klientowi, który zatrzymał się w koszyku lub na stronie płatności. Może zachęcić do kontynuacji zakupu, uruchomić scenariusz albo pomóc wrócić po kliknięciu linku z e-maila.

Przejdź do: Virtual AI Consultant → Checkout Rescue.

• Enable — włącza moduł.
• Show on cart / checkout — określa, gdzie komunikat ma się pojawiać.
• Show after inactivity — po ilu sekundach bezczynności wyświetlić pomoc.
• Exit intent — reakcja na próbę opuszczenia strony.
• Minimum cart value — minimalna wartość koszyka do uruchomienia modułu.
• Scenario mode / Scenario ID — powiązanie z wybranym scenariuszem rozmowy.
• Statistics — liczba wyświetleń, kliknięć i zamówień wspartych przez Checkout Rescue.

Treści komunikatu

• Popup title — nagłówek komunikatu.
• Popup message — opis problemu lub zachęta do skorzystania z pomocy.
• Primary button label — główny przycisk, np. „Pomóż mi dokończyć zamówienie”.
• Secondary button label — przycisk pomocniczy, np. kontynuacja bez pomocy.
• Close label — tekst przycisku zamknięcia.

Prompt albo scenariusz

Checkout Rescue może wysłać do AI gotowy prompt lub uruchomić konkretny scenariusz. W trybie scenariusza wpisz Scenario ID zgodny z identyfikatorem scenariusza z zakładki Scenarios.

12. Return Visitor Assistant — powracający klient

Return Visitor Assistant pokazuje klientowi krótki komunikat, gdy wraca na stronę z zapisanym kontekstem produktu, porównania, koszyka lub checkoutu.

Przejdź do: Virtual AI Consultant → Return Visitor.

• Enable Return Visitor Assistant — włącza moduł.
• Show after seconds — opóźnienie pokazania komunikatu.
• Minimum return time — minimalny czas od poprzedniej wizyty.
• Context lifetime — liczba dni przechowywania kontekstu.
• Cooldown — przerwa między kolejnymi wyświetleniami komunikatu.
• When to show — produkty, porównanie, koszyk, checkout.
• Messages — treści komunikatów i teksty przycisków.

Typy kontekstu

• Products — klient oglądał produkty w czacie.
• Comparison — klient porównywał co najmniej dwa produkty.
• Cart — klient miał produkty w koszyku.
• Checkout — klient był na finalizacji zamówienia.

Przyciski

• Continue button — otwiera czat i kontynuuje poprzedni temat.
• Summary button — może uruchomić wysyłkę mini oferty e-mail.
• Close button — zamyka komunikat bez otwierania czatu.

13. Chat Nudge — dymek zachęcający do rozmowy

Chat Nudge to krótki komunikat wyświetlany obok widgetu. Służy do delikatnego zachęcenia użytkownika do rozmowy, np. na stronie produktu, w kategorii albo na stronie cennika.

Ustawienia znajdują się w: Virtual AI Consultant → Settings → Chat Nudge.

• Enable nudge bubble — włącza lub wyłącza dymek.
• Nudge text — domyślny tekst zachęty.
• Per-page nudge text — indywidualne teksty dla konkretnych adresów URL lub ścieżek.
• Display delay — czas po wejściu na stronę, po którym dymek zostanie pokazany.
• Cooldown — mechanizm ogranicza zbyt częste pokazywanie dymka temu samemu użytkownikowi.

14. Mini oferta e-mail

Mini oferta e-mail pozwala wysłać klientowi krótkie podsumowanie rozmowy lub rekomendowanych produktów. Nie musi to być pełna historia czatu — celem jest krótka, sprzedażowa wiadomość, do której klient może wrócić po rozmowie.

• Klient może użyć szybkiej akcji „Wyślij podsumowanie mailem”.
• Wiadomość może zawierać temat rozmowy, krótkie podsumowanie i listę produktów pokazanych w czacie.
• Mini oferta może być uruchamiana także z Return Visitor Assistant.
• Wtyczka zabezpiecza wysyłkę limitami IP i adresu odbiorcy.

Przetestuj funkcję jako klient: otwórz widget, zapytaj o produkt, a następnie wybierz akcję wysłania podsumowania e-mailem.

Co może zawierać mini oferta?

• krótki temat rozmowy,
• podsumowanie potrzeb klienta,
• produkty pokazane w czacie: nazwa, cena, dostępność, opis, link, SKU,
• link do aktualnej strony, koszyka albo checkoutu,
• krótki tekst zachęcający do powrotu do zakupu.

Wysyłka mini oferty jest zabezpieczona limitami: ograniczenie po IP oraz ograniczenie liczby wiadomości na jeden adres e-mail.

15. AI Insights i Reports — analiza skuteczności

Moduły raportowe pomagają sprawdzić, co robią klienci i jak asystent wspiera sprzedaż. W przyjętym modelu sprzedaży są to funkcje planu Pro.

AI Insights

Przejdź do: Virtual AI Consultant → AI Insights.

• Most frequent customer questions — najczęstsze pytania klientów.
• Unanswered questions — pytania, na które AI nie odpowiedziało poprawnie lub odpowiedź była niepełna.
• Knowledge base suggestions — propozycje uzupełnienia bazy wiedzy.
• Synonym and typo dictionary — słownik synonimów i literówek, przydatny przy wyszukiwaniu produktów.

Reports

Przejdź do: Virtual AI Consultant → Reports.

• raport porzuconych koszyków,
• liczba wysłanych wiadomości e-mail,
• odzyskane zamówienia i przychód,
• skuteczność odzyskiwania koszyków,
• wyświetlenia kart produktów, kliknięcia i kliknięcia dodania do koszyka.

Filtry i diagnostyka

• From / To — zakres dat raportu.
• Minimum cart value — filtr koszyków od określonej wartości.
• Show full emails — pokazuje pełne adresy e-mail administratorowi, zamiast wersji zamaskowanej.
• Diagnostics — informacje o CRON, ostatnim uruchomieniu, tabelach i narzędziach testowych.

16. Google Analytics 4 i zdarzenia

Wtyczka może wysyłać zdarzenia do Google Analytics 4, jeżeli w ustawieniach wpiszesz Measurement ID w formacie G-XXXXXXXXXX.

Ustawienie znajduje się w: Virtual AI Consultant → Settings → Advanced → Google Analytics 4 ID.

• kliknięcie w widget,
• rozpoczęcie rozmowy,
• interakcje ze scenariuszami,
• wyświetlenia kart produktów,
• kliknięcia produktu i kliknięcia dodania do koszyka,
• zdarzenia związane z Checkout Rescue i odzyskiwaniem koszyka, zależnie od konfiguracji.

17. Aktualizacje, licencja i zgodność wersji

Wtyczka zawiera mechanizm aktualizacji oraz cyklicznego sprawdzania licencji. Dzięki temu administrator może otrzymywać nowe wersje wtyczki bez ręcznego wgrywania paczki ZIP, jeżeli serwer aktualizacji jest poprawnie skonfigurowany.

• Plugin Update Checker — mechanizm sprawdzania dostępności aktualizacji.
• License validation cron — cykliczne sprawdzanie statusu licencji.
• Grace period — okres przejściowy, gdy chwilowo nie uda się zweryfikować licencji.
• Plan in license payload — plan licencji powinien odpowiadać funkcjom Basic albo Pro.

Po aktualizacji wtyczki zawsze sprawdź: aktywność licencji, działanie chatu, działanie WooCommerce, wysyłkę e-maili, Checkout Rescue, Return Visitor oraz raporty Pro.

18. Testy po konfiguracji

Po zapisaniu ustawień wykonaj testy jako niezalogowany użytkownik, najlepiej w trybie incognito.

1. Sprawdź, czy pojawia się przycisk widżetu.
2. Wypełnij formularz klienta i rozpocznij rozmowę.
3. Zadaj pytanie z bazy wiedzy, np. o czas realizacji lub kontakt.
4. Zadaj pytanie produktowe, np. „Pokaż produkty pasujące do czarnych toreb papierowych”.
5. Jeżeli używasz WooCommerce, sprawdź karty produktów i przyciski prowadzące do zakupu.
6. Przetestuj status zamówienia, jeśli ten moduł jest włączony.
7. Dodaj produkt do koszyka i sprawdź Checkout Rescue.
8. Porzuć koszyk testowy i sprawdź, czy działa przypomnienie e-mail.
9. Wróć na stronę po kilku minutach i sprawdź Return Visitor Assistant.
10. Sprawdź, czy w Reports i AI Insights zapisują się dane testowe.

19. Najczęstsze problemy i szybkie rozwiązania

Nie widzę zakładek Settings, Knowledge Base, Scenarios

Najczęściej oznacza to brak aktywnej licencji. Wejdź w Virtual AI Consultant → License i sprawdź status licencji.

Widget nie pokazuje się na stronie

• Sprawdź, czy włączone jest Show main widget button automatically.
• Sprawdź, czy adres strony nie został wpisany w Do not show the widget button on these pages.
• Jeżeli używasz shortcode, upewnij się, że włączone jest Show shortcode [ai_chat_widget].
• Wyczyść cache strony i cache przeglądarki.

AI odpowiada zbyt ogólnie

• Uzupełnij dokładniej pola w Knowledge Base.
• Ustaw właściwe źródło danych w Settings → Knowledge & RAG.
• Obniż lub podnieś RAG Similarity Threshold i wykonaj testy.
• Dodaj brakujące odpowiedzi na podstawie AI Insights.

Produkty WooCommerce nie pojawiają się w odpowiedzi

• Sprawdź, czy WooCommerce jest aktywny.
• Wybierz źródło danych zawierające WooCommerce.
• Upewnij się, że produkty są opublikowane, mają nazwy, opisy i ceny.
• Jeżeli używasz XML, wygeneruj embeddingi po zmianie pliku.

Nie dochodzą wiadomości e-mail z koszyków lub mini ofert

• Sprawdź konfigurację poczty WordPress lub SMTP.
• Sprawdź folder spam.
• W Abandoned Cart sprawdź nadawcę, tematy i treści wiadomości.
• Przy mini ofercie wykonaj test z prawdziwym adresem e-mail.

20. Bezpieczeństwo i dobre praktyki

• Nie publikuj kluczy API w treści strony ani w kodzie front-endu.
• Używaj tylko własnych kluczy API i ograniczaj je po stronie dostawcy, jeśli taka opcja jest dostępna.
• Nie wpisuj do bazy wiedzy danych, których asystent nie powinien ujawniać klientom.
• Regularnie sprawdzaj AI Insights i uzupełniaj bazę wiedzy o brakujące odpowiedzi.
• Przy funkcjach e-mail i koszykach zadbaj o zgodność z regulaminem, polityką prywatności i zasadami zgód marketingowych.
• Po większych zmianach w produktach, cennikach lub XML ponownie wygeneruj embeddingi.