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. 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ę.

12. 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.

13. 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.

14. 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.

15. 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.