Instrukcja instalacji i obsługi
Virtual AI Consultant

1. Wymagania

Do poprawnego działania wtyczki Virtual AI Consultant potrzebujesz:

• działającej strony WordPress,
• dostępu administratora do panelu WordPress,
• aktywnej licencji Virtual AI Consultant, jeżeli używasz wersji licencjonowanej,
• własnego klucza API do wybranego dostawcy AI: OpenAI, Claude lub Gemini,
• WooCommerce, jeżeli chcesz korzystać z funkcji sklepu, produktów, zamówień i porzuconych koszyków.

2. Instalacja wtyczki

Instalacja z pliku ZIP

1. Zaloguj się do panelu WordPress.
2. Przejdź do: Wtyczki → Dodaj nową.
3. Kliknij: Wyślij wtyczkę na serwer.
4. Wybierz plik ZIP wtyczki Virtual AI Consultant.
5. Kliknij: Zainstaluj teraz.
6. Po instalacji kliknij: Włącz wtyczkę.

3. Aktywacja licencji

Jeżeli korzystasz z wersji wymagającej licencji, po instalacji przejdź do zakładki licencji.

1. Otwórz panel WordPress.
2. Przejdź do ustawień Virtual AI Consultant.
3. Otwórz zakładkę License lub Licencja.
4. Wpisz klucz licencyjny, adres e-mail lub dane wymagane przez formularz.
5. Kliknij Activate, Save albo Refresh license, zależnie od widocznego przycisku.

Po poprawnej aktywacji w panelu powinien pojawić się status licencji, plan oraz data ważności.

4. Konfiguracja kluczy API AI

Virtual AI Consultant może korzystać z różnych dostawców AI. W panelu ustawień wybierz dostawcę i wpisz odpowiedni klucz API.

5. Pierwsza konfiguracja wtyczki

Po instalacji zalecamy wykonać podstawową konfigurację w tej kolejności:

1. Aktywuj licencję, jeśli jest wymagana.
2. Wpisz klucz API wybranego dostawcy AI.
3. Wybierz model AI.
4. Ustaw nazwę widgetu i wiadomość powitalną.
5. Dodaj podstawową bazę wiedzy firmy.
6. Ustaw widoczność przycisku chatu.
7. Przetestuj rozmowę na stronie.

6. Baza wiedzy AI

Baza wiedzy to miejsce, w którym wpisujesz informacje, z których ma korzystać chatbot AI.

Co warto dodać do bazy wiedzy?

• opis firmy,
• opis produktów lub usług,
• cenniki,
• FAQ, czyli najczęściej zadawane pytania,
• warunki realizacji zamówień,
• informacje o dostawie, płatnościach, reklamacjach i zwrotach,
• linki do ważnych podstron,
• dane z plików JSON, XML lub innych źródeł obsługiwanych przez wtyczkę.

Jak przygotować dobrą bazę wiedzy?

Wpisuj informacje jasno i konkretnie. Unikaj ogólnych zdań typu „mamy najlepszą ofertę”. Lepiej podać konkretne warunki, terminy, ceny, linki i odpowiedzi na typowe pytania klientów.

7. Widget chatu i shortcode

Chatbot może być wyświetlany jako pływający przycisk na stronie lub umieszczony ręcznie w wybranym miejscu za pomocą shortcode.

Pływający widget

W ustawieniach wtyczki możesz włączyć lub wyłączyć główny przycisk chatu. Po włączeniu przycisk pojawi się na stronie zgodnie z konfiguracją.

Shortcode

Aby ręcznie dodać widget w treści strony, użyj shortcode:

[ai_chat_widget]

Shortcode możesz wkleić na stronie produktu, landing page, stronie kontaktowej lub w dowolnym miejscu obsługującym shortcode WordPress.

Personalizacja wyglądu

W panelu ustawień możesz zmienić między innymi:

• nazwę widgetu,
• wiadomość powitalną,
• kolor przycisku,
• kolor tekstu,
• ikonę lub elementy nagłówka,
• widoczność widgetu na wybranych podstronach.

8. Integracja z WooCommerce

Jeżeli na stronie działa WooCommerce, Virtual AI Consultant może korzystać z danych sklepu.

Możliwe funkcje WooCommerce

• wyszukiwanie produktów,
• prezentowanie nazw, cen, opisów i linków do produktów,
• pomoc klientowi w wyborze produktu,
• sprawdzanie statusu zamówienia,
• obsługa porzuconych koszyków,
• raporty dotyczące porzuconych i odzyskanych koszyków.

9. Sprawdzanie statusu zamówienia

Wtyczka może umożliwić klientowi sprawdzenie statusu zamówienia WooCommerce.

Jak działa sprawdzanie zamówienia?

1. Klient wybiera opcję sprawdzenia zamówienia w chacie.
2. Podaje numer zamówienia i adres e-mail.
3. System sprawdza zamówienie w WooCommerce.
4. Klient otrzymuje informacje o statusie, produktach, płatności, dostawie i innych dostępnych danych.

10. Porzucone koszyki WooCommerce

Virtual AI Consultant może obsługiwać moduł porzuconych koszyków dla WooCommerce.

Co może robić moduł?

• zapisywać koszyk klienta,
• wykrywać porzucony koszyk,
• wysyłać pierwsze i drugie przypomnienie e-mail,
• generować link odzyskiwania koszyka,
• śledzić kliknięcia i otwarcia wiadomości,
• pokazywać raporty porzuconych i odzyskanych koszyków.

Co warto skonfigurować?

• czas pierwszego przypomnienia,
• czas drugiego przypomnienia,
• temat wiadomości e-mail,
• treść wiadomości e-mail,
• adres nadawcy lub ustawienia wysyłki WordPress.

11. Dynamiczne kupony

Moduł dynamicznych kuponów pozwala tworzyć indywidualne zachęty zakupowe dla klientów WooCommerce. Kupon może zostać wykorzystany w komunikacji z klientem, na przykład przy porzuconym koszyku, powrocie użytkownika na stronę albo w mini ofercie e-mail.

Do czego służą dynamiczne kupony?

• zachęcają klienta do dokończenia zakupu,
• mogą zwiększać skuteczność odzyskiwania porzuconych koszyków,
• pozwalają tworzyć bardziej spersonalizowaną komunikację sprzedażową,
• mogą być używane w automatycznych wiadomościach e-mail,
• mogą wspierać kampanie promocyjne i sprzedażowe WooCommerce.

Co warto skonfigurować?

• czy kupony mają być aktywne,
• wartość rabatu lub sposób naliczania rabatu,
• minimalną wartość koszyka, jeżeli promocja ma obowiązywać od określonej kwoty,
• czas ważności kuponu,
• treść komunikatu, w którym kupon jest prezentowany klientowi.

12. Checkout Rescue

Checkout Rescue pomaga ograniczać utratę klientów na etapie koszyka i finalizacji zamówienia. Moduł może wspierać klienta wtedy, gdy pojawia się problem z decyzją zakupową, płatnością, dostawą, kuponem, formularzem zamówienia lub wyborem produktu.

Jak może pomagać Checkout Rescue?

• przypomina klientowi o produktach znajdujących się w koszyku,
• odpowiada na pytania dotyczące dostawy, płatności i zwrotów,
• może kierować klienta z powrotem do koszyka lub kasy,
• może prezentować kupon lub zachętę zakupową, jeżeli taka funkcja została skonfigurowana,
• może pomóc klientowi wybrać produkt, jeżeli nie jest zdecydowany.

Kiedy warto używać tego modułu?

Moduł jest szczególnie przydatny w sklepach, w których klienci często dodają produkty do koszyka, ale nie przechodzą do płatności. Checkout Rescue może zmniejszać liczbę przerwanych zakupów i zwiększać liczbę dokończonych zamówień.

13. Return Visitor Assistant

Return Visitor Assistant to moduł obsługi powracających użytkowników. Jego zadaniem jest rozpoznanie, że klient wrócił na stronę, i pokazanie mu bardziej trafnego komunikatu niż standardowa wiadomość powitalna.

Co może robić Return Visitor Assistant?

• witać powracającego użytkownika innym komunikatem niż nowego klienta,
• nawiązywać do wcześniejszej wizyty lub wcześniejszego koszyka, jeżeli taka informacja jest dostępna,
• zachęcać do kontynuowania zakupów,
• kierować klienta do produktów, koszyka, kontaktu albo wybranej podstrony,
• wspierać działania sprzedażowe bez agresywnego pop-upu.

Przykładowe zastosowania

• powrót klienta do sklepu po wcześniejszej wizycie,
• powrót klienta z niedokończonym koszykiem,
• powrót klienta na stronę produktu,
• powrót klienta po kliknięciu w link z wiadomości e-mail.

14. Mini oferta e-mail

Mini oferta e-mail pozwala przygotować krótkie, handlowe podsumowanie rozmowy lub zapytania klienta. Zamiast wysyłać całą historię rozmowy, klient otrzymuje uporządkowaną wiadomość z najważniejszymi informacjami.

Co może zawierać mini oferta?

• krótkie podsumowanie potrzeb klienta,
• wybrane produkty lub usługi,
• linki do produktów albo podstron,
• informacje o cenie, terminie realizacji lub dostępności, jeżeli są dostępne,
• dane kontaktowe firmy,
• wezwanie do kontaktu lub dokończenia zakupu.

Jak używać mini oferty?

Mini oferta powinna być krótka i czytelna. Jej celem nie jest archiwizacja rozmowy, tylko ułatwienie klientowi decyzji zakupowej i przekazanie mu najważniejszych informacji w formie e-maila.

15. Raporty koszyka i raporty sprzedażowe — plan Pro

Raporty koszyka i raporty sprzedażowe są funkcją przeznaczoną dla planu Pro. Pomagają analizować zachowanie klientów w sklepie WooCommerce i oceniać skuteczność modułów odzyskiwania koszyków oraz komunikacji sprzedażowej.

Jakie dane mogą pokazywać raporty?

• liczbę zapisanych koszyków,
• liczbę porzuconych koszyków,
• liczbę odzyskanych koszyków,
• wartość koszyków,
• skuteczność przypomnień e-mail,
• kliknięcia w linki odzyskiwania koszyka,
• podstawowe dane sprzedażowe WooCommerce, jeżeli są dostępne w konfiguracji sklepu.

Do czego służą raporty?

Raporty pomagają sprawdzić, gdzie sklep traci sprzedaż, które przypomnienia działają najlepiej i czy moduły odzyskiwania koszyka realnie wpływają na zamówienia.

16. AI Insights — plan Pro

AI Insights to funkcja planu Pro, która pomaga analizować rozmowy, pytania klientów i zachowania zakupowe. Moduł może wskazywać, czego brakuje w bazie wiedzy, jakie pytania powtarzają się najczęściej i które obszary sklepu wymagają poprawy.

Co może analizować AI Insights?

• najczęstsze pytania klientów,
• pytania, na które chatbot nie udzielił wystarczającej odpowiedzi,
• powtarzające się obiekcje zakupowe,
• braki w bazie wiedzy,
• tematy związane z produktami, dostawą, płatnościami i zwrotami,
• sygnały sprzedażowe, które mogą pomóc w ulepszaniu sklepu.

Jak wykorzystać AI Insights?

Wyniki analizy można wykorzystać do uzupełniania bazy wiedzy, poprawy opisów produktów, rozbudowy FAQ, ulepszania treści e-maili i lepszego dopasowania komunikacji do klientów.

17. Scenariusze rozmów

Scenariusze rozmów pozwalają przygotować gotowe ścieżki obsługi klienta.

Przykładowe scenariusze

• zapytanie ofertowe,
• wybór produktu,
• sprawdzenie statusu zamówienia,
• pytania o dostawę,
• kontakt z działem sprzedaży,
• przekierowanie do konkretnej podstrony,
• zbieranie danych do kontaktu.

Dzięki scenariuszom użytkownik nie musi od razu wpisywać pytania ręcznie. Może kliknąć gotowy przycisk i przejść przez przygotowaną ścieżkę.

18. Formularz leadów

Wtyczka może zbierać dane kontaktowe użytkownika przed rozpoczęciem rozmowy lub w trakcie rozmowy.

Możliwe pola formularza

• imię,
• adres e-mail,
• firma,
• telefon.

W ustawieniach możesz zdecydować, które pola mają być widoczne i które mają być wymagane.

19. Analityka i Google Analytics 4

Wtyczka może współpracować z Google Analytics 4, jeżeli w ustawieniach wpiszesz odpowiedni identyfikator pomiaru.

Co można analizować?

• kliknięcia w widget,
• rozpoczęcie rozmowy,
• aktywność użytkowników,
• działanie scenariuszy,
• konwersje i zdarzenia, jeżeli zostały poprawnie skonfigurowane.

Dokładny zakres analityki zależy od konfiguracji strony i ustawień Google Analytics.

20. Najczęstsze problemy i rozwiązania

Chatbot nie odpowiada

• sprawdź, czy wpisany jest poprawny klucz API,
• sprawdź, czy wybrany model jest dostępny na Twoim koncie,
• sprawdź, czy konto API ma aktywny billing lub dostępne środki,
• sprawdź, czy licencja wtyczki jest aktywna, jeśli jest wymagana.

Widget nie wyświetla się na stronie

• sprawdź, czy główny przycisk widgetu jest włączony,
• sprawdź, czy strona nie znajduje się na liście wykluczonych adresów URL,
• sprawdź harmonogram widoczności konsultanta,
• wyczyść cache strony i przeglądarki.

WooCommerce nie działa w rozmowie

• sprawdź, czy WooCommerce jest aktywny,
• sprawdź, czy produkty są opublikowane,
• sprawdź, czy wybrany tryb źródła danych obejmuje WooCommerce,
• sprawdź, czy zapytanie użytkownika dotyczy produktu lub zamówienia.

Status zamówienia nie jest odnajdywany

• sprawdź poprawność numeru zamówienia,
• sprawdź, czy adres e-mail zgadza się z zamówieniem,
• sprawdź, czy zamówienie istnieje w WooCommerce,
• upewnij się, że funkcja statusu zamówienia jest włączona.

Odpowiedzi AI są zbyt ogólne

• rozbuduj bazę wiedzy,
• dodaj konkretne FAQ, ceny, warunki i opisy produktów,
• sprawdź wybrany tryb źródła danych,
• upewnij się, że chatbot korzysta z bazy wiedzy, a nie tylko z ogólnej wiedzy modelu AI.

21. FAQ

Czy Virtual AI Consultant działa bez WooCommerce?

Tak. Wtyczka może działać jako chatbot AI dla strony WordPress bez sklepu WooCommerce. Funkcje produktowe, status zamówień i porzucone koszyki wymagają WooCommerce.

Czy muszę mieć OpenAI?

Nie zawsze. Wtyczka może obsługiwać także Claude i Gemini, zależnie od konfiguracji. Musisz jednak posiadać własny klucz API do wybranego dostawcy.

Czy mogę dodać własne dane firmy?

Tak. To jedna z głównych funkcji wtyczki. Możesz dodać bazę wiedzy, FAQ, cenniki, opisy produktów i inne informacje.

Czy chatbot może zbierać kontakty do klientów?

Tak. Wtyczka może wyświetlać formularz kontaktowy i przesyłać historię rozmowy na wskazany adres e-mail.

Czy wtyczka automatycznie tworzy zamówienia?

Wtyczka może wspierać rozmowę, wyszukiwać produkty i pomagać klientowi w zakupie. Automatyczne tworzenie zamówień zależy od konfiguracji sklepu i wdrożonych scenariuszy.

Czy mogę zmienić wygląd widgetu?

Tak. W ustawieniach można zmienić między innymi nazwę, wiadomość powitalną, kolory i widoczność widgetu.