WP Manifestindependent plugin directory
manifest / ai / ai-woo-agent

AI WooCommerce Agent

Agent AI obsługi klienta sklepu WooCommerce

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/pawel-szymczyk/ai-woo-agent/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

AI WooCommerce Agent Wtyczka WordPress

Inteligentny agent AI obsługi klienta dla sklepów WooCommerce, oparty na Claude API (Anthropic). Klient pyta o swoje zamówienia w naturalnym języku, a agent odpowiada na podstawie rzeczywistych danych ze sklepu. Gdy agent nie może pomóc, automatycznie powiadamia administratora.


Screenshot

AI WooCommerce Agent — widget chatu 1 AI WooCommerce Agent — widget chatu 2 AI WooCommerce Agent — widget chatu 3 AI WooCommerce Agent — widget chatu 4

Jak to działa

Zalogowany klient pisze: "Kiedy dostanę moje zamówienie?"
    ↓
Agent pobiera zamówienia klienta z WooCommerce
    ↓
Claude analizuje pytanie i dane zamówienia
    ↓
Agent odpowiada konkretnie o zamówieniu klienta
    ↓
Jeśli nie może pomóc → email do admina (eskalacja)

Funkcje

  • 💬 Chat w naturalnym języku, klient pyta po polsku
  • 📦 Dostęp do zamówień, agent zna historię zamówień zalogowanego klienta
  • 🧠 Pamięć rozmowy, agent pamięta kontekst całej sesji (nie pyta "Cześć" przy każdej odpowiedzi)
  • 🚨 Eskalacja do admina, gdy agent nie może pomóc, wysyła email do administratora
  • 🔒 Tylko zalogowani, niezalogowany klient widzi link do strony logowania
  • 🧹 Czyszczenie sesji, historia rozmowy kasowana automatycznie po wylogowaniu
  • 📝 Markdown, odpowiedzi są czytelnie sformatowane (listy, pogrubienia, nagłówki)
  • 🛡️ DOMPurify, sanitizacja HTML przed renderowaniem (ochrona przed XSS)

Wymagania

  • WordPress 6.0+
  • PHP 8.0+
  • WooCommerce 8.0+
  • Klucz API Anthropic (console.anthropic.com)
  • Klient musi być zalogowany

Instalacja

1. Pobierz wtyczkę

git clone https://github.com/Pawel-Szymczyk/ai-woo-agent.git

2. Wgraj do WordPress

Skopiuj folder ai-woo-agent do:

wp-content/plugins/ai-woo-agent/

3. Aktywuj w panelu admina

WordPress Admin → Wtyczki → AI WooCommerce Agent → Aktywuj

4. Wpisz klucz API

WordPress Admin → Ustawienia → AI Assistant → wpisz klucz z console.anthropic.com

5. Włącz rejestrację klientów w WooCommerce

WordPress Admin → WooCommerce → Ustawienia → Konta:

✅ Zezwól klientom na tworzenie konta na stronie „Moje konto"
✅ Zezwól klientom na tworzenie konta podczas realizacji zamówienia

Osadzanie na stronie

Dodaj shortcode na stronie Moje konto lub dowolnej innej:

[ai_woo_agent]

Niezalogowany użytkownik zobaczy link do logowania zamiast chatu.


Przykładowe pytania klienta

"Pokaż moje zamówienia"
"Kiedy dostanę zamówienie #21?"
"Jaki jest status mojej paczki?"
"Chcę złożyć reklamację"
"Jak mogę zwrócić produkt?"
"Co zamówiłem ostatnio?"

Struktura plików

ai-woo-agent/
├── ai-woo-agent.php                 # Główny plik wtyczki
├── includes/
│   ├── class-ai-api.php             # Komunikacja z Claude API
│   └── class-ai-woo-agent.php      # Logika agenta WooCommerce
└── assets/
    ├── js/
    │   ├── chat.js                  # Frontend — interfejs chatu
    └── css/
        └── chat.css                 # Style widgetu

Eskalacja do administratora

Gdy agent nie może odpowiedzieć na pytanie klienta, automatycznie wysyła email do administratora sklepu:

Temat: [AI Agent] Klient potrzebuje pomocy

Klient: jan.kowalski@example.com

Pytanie: Chcę zmienić adres dostawy zamówienia #21

Odpowiedź agenta: Nie mogę pomóc w tej sprawie.
Skontaktuj się z nami: admin@sklep.pl

Triggery eskalacji (konfigurowalne w kodzie):

  • "nie mogę pomóc"
  • "skontaktuj się"
  • "nie mam informacji"

Bezpieczeństwo

  • Endpoint REST wymaga zalogowanego użytkownika (is_user_logged_in())
  • Agent widzi TYLKO zamówienia aktualnie zalogowanego klienta
  • Sanitizacja danych wejściowych (sanitize_text_field)
  • Renderowanie Markdown przez DOMPurify (ochrona przed XSS)
  • Klucz API przechowywany w bazie WordPress — nigdy w kodzie
  • Nonce WordPress na każdym żądaniu REST
  • Historia sesji kasowana przy wylogowaniu

Dostosowanie

Zmiana liczby wyświetlanych zamówień

W class-ai-woo-agent.php w metodzie get_customer_context():

$orders = wc_get_orders( [
    'customer' => $user_id,
    'limit'    => 5, // ← zmień na więcej jeśli potrzeba
    ...
] );

Zmiana triggerów eskalacji

W metodzie maybe_escalate():

$triggers = [
    'nie mogę pomóc',
    'skontaktuj się',
    'nie mam informacji',
    'proszę zadzwonić', // ← dodaj własne triggery
];

Dostosowanie wyglądu

Edytuj assets/css/chat.css zmień kolor na brand klienta:

/* Zmień #1E40AF na kolor marki klienta */
.ai-message--user  { background: #1E40AF; }
#ai-chat-send      { background: #1E40AF; }
#ai-chat-input:focus { border-color: #1E40AF; }

Dodanie własnych instrukcji do agenta

W metodzie get_system_prompt() dodaj instrukcje specyficzne dla sklepu:

return $context . "\n\n" .
    "Jesteś asystentem sklepu {$shop_name}. " .
    'Godziny obsługi klienta: pon-pt 9-17. ' .    // ← dodaj własne
    'Zwroty możliwe w ciągu 30 dni od zakupu. ' . // ← informacje
    ...

Statusy zamówień WooCommerce

Status Znaczenie
pending Oczekuje na płatność
processing Płatność przyjęta, w realizacji
on-hold Wstrzymane, czeka na potwierdzenie
completed Zakończone, wysłane
cancelled Anulowane
refunded Zwrócone
failed Płatność nieudana

Koszty API

Model Koszt Zalecenie
Claude Haiku ~$0.25/1M tokenów Demo, mały ruch
Claude Sonnet ~$3/1M tokenów Produkcja, lepsza jakość

Typowa rozmowa (~5 wiadomości) = ok. 2000 tokenów = $0.0005 przy Haiku.


Licencja

GPL v2 or later, zgodnie ze standardem WordPress.


Autor

Paweł Szymczyk — github.com/Pawel-Szymczyk

Freelancer specjalizujący się w integracji AI z WordPress i WooCommerce. Zainteresowany podobnym rozwiązaniem dla swojego sklepu? Napisz: [kontakt]