Integracja z WooCommerce: AI Search, wyszukiwanie na żywo w sklepie i status zamówienia

Połącz swojego chatbota ChatLab ze sklepem WooCommerce, aby klienci mogli wyszukiwać produkty i sprawdzać swoje zamówienia bezpośrednio na czacie. Produkty są wyszukiwane za pomocą AI Search, które przeszukuje Twój zaindeksowany katalog WooCommerce według znaczenia, lub poprzez wyszukiwanie w sklepie na żywo, które odpytuje API sklepu.

Przykładowa rozmowa

Ten przykład ilustruje doświadczenie klienta. Dostępne działania i zwracane informacje zależą od tej integracji oraz Twojej konfiguracji.

Ważne: najlepsze praktyki dla e-commerce

Po zakończeniu poniższej integracji przeczytaj wyczerpujący poradnik na temat optymalizacji chatbota pod kątem e-commerce: Jak skonfigurować ChatLab dla swojego sklepu e-commerce

Jak chatbot znajduje produkty w WooCommerce: AI Search i wyszukiwanie na żywo w sklepie

Chatbot ChatLab może wyszukiwać produkty w sklepie WooCommerce na dwa sposoby. Używa jednego albo drugiego, nigdy obu naraz.

AI Search (zalecane) - ChatLab utrzymuje własny indeks Twojego katalogu WooCommerce, a chatbot przeszukuje go według znaczenia.

• Klienci pytają naturalnym językiem, na przykład „czerwona sukienka do 300”. Zakres cenowy działa jako ścisły filtr, a dokładne kody produktów (SKU, EAN) również są dopasowywane.
• Cena, stan magazynowy i warianty są odczytywane na żywo z WooCommerce w momencie udzielania odpowiedzi, więc klienci widzą aktualne dane nawet pomiędzy odświeżeniami indeksu.
• Wyniki pojawiają się w czacie jako karty produktów, do 5 na odpowiedź.
• Indeksowanie uruchamia się samoczynnie po połączeniu sklepu. Katalog nie zużywa znaków trenowania.
• Wymagany plan: każdy plan E-commerce zawiera tę funkcję (Free 100 produktów, Start 2 000, Grow 5 000, Scale 20 000). W planie Universal należy dodać dodatek E-commerce integrations ($30 miesięcznie) oraz pakiet produktów AI Search ($29 miesięcznie, 5 000 produktów) przypisany do chatbota.

Wyszukiwanie na żywo w sklepie - chatbot przekazuje frazę klienta do wyszukiwarki WooCommerce przez API sklepu i odpowiada tym, co zwróci sklep.

• Nic nie jest indeksowane i niczego nie trzeba synchronizować. Dane są zawsze na żywo.
• Jest to wyszukiwanie po słowach kluczowych: znajduje to, co znalazłaby własna wyszukiwarka Twojego sklepu dla danej frazy. Nie rozumie opisów potrzeb, synonimów ani literówek tak jak AI Search.
• Wymagany plan: plan Universal z dodatkiem E-commerce integrations ($30 miesięcznie). Pakiet produktów nie jest potrzebny.

Gdy funkcja AI Search jest włączona, zastępuje wyszukiwanie na żywo w sklepie. Sprawdzanie statusu zamówienia działa tak samo w obu wariantach. Trzecia opcja, czyli trenowanie na zeskanowanych podstronach sklepu, jest dostępna w każdym planie i służy do treści informacyjnych, takich jak dostawa i zwroty, a nie do produktów. Pełne porównanie znajdziesz w artykule AI Search: how your chatbot finds products (AI Search: jak Twój chatbot znajduje produkty), a limity produktów w artykule E-commerce plans and limits (Plany i limity E-commerce).

Co zapewnia integracja

Wyszukiwanie w sklepie na żywo (wyszukiwanie produktów po frazie) - Chatbot przesyła frazę klienta do wyszukiwarki WooCommerce. Przeszukuje tytuły i opisy produktów, zwracając 5 najlepiej dopasowanych opublikowanych produktów zawierających:

• ID, nazwę i opis produktu
• Cenę oraz SKU
• Zdjęcie produktu i bezpośredni link do strony produktu

Wyszukiwanie produktów po SKU - Klienci mogą wyszukiwać produkty za pomocą konkretnego kodu SKU, numeru referencyjnego lub kodu produktu. Jest to przydatne, gdy klienci znają już dokładny identyfikator produktu - na przykład z drukowanego katalogu, poprzedniego zamówienia lub polecenia. Zwraca te same pola produktu, co standardowe wyszukiwanie produktów.

Wyszukiwanie produktów w kategorii - Bardziej precyzyjne wyszukiwanie, które łączy słowo kluczowe z określoną kategorią produktów. Chatbot najpierw identyfikuje właściwą kategorię, a następnie wyszukuje w niej pasujące produkty. Zwraca te same pola produktu, co standardowe wyszukiwanie produktów.

Pobieranie kategorii - Chatbot może pobrać listę kategorii produktów dostępnych w Twoim sklepie, pomagając klientom w przeglądaniu katalogu lub zawężaniu wyszukiwania produktów. Każda kategoria zawiera:

• ID, nazwę i uproszczoną nazwę (slug) kategorii
• Opis kategorii

Szczegóły zamówienia - Domyślnie klienci podają ID zamówienia oraz powiązany z nim adres e-mail. Weryfikuje to podane informacje z danymi w sklepie, co nie stanowi dowodu, że odwiedzający jest właścicielem tego adresu e-mail. Opcjonalne ustawienie akcji pozwala na wyszukiwanie po samym ID zamówienia. Chatbot zwraca:

• Numer zamówienia, łączną kwotę i status (np. w trakcie realizacji, zrealizowane, anulowane)
• Adres dostawy wraz z imieniem i nazwiskiem odbiorcy, firmą oraz pełnym adresem (ulica, miasto, województwo/region, kod pocztowy, kraj)
• Zamówione pozycje wraz z nazwami, ilościami, cenami jednostkowymi i łącznymi kwotami pozycji

Wymagania wstępne

Przed rozpoczęciem integracji z WooCommerce upewnij się, że:

• Twój chatbot jest utworzony w ChatLab. Instalacja widgetu w sklepie to osobny krok, niezależny od łączenia danych sklepu.
• Masz dostęp do panelu administracyjnego WordPress swojego sklepu WooCommerce

Zalecane: Połącz za pomocą wtyczki WordPress

W sekcji Połącz > WooCommerce (Connect > WooCommerce) wybierz Pobierz wtyczkę WooCommerce (Get the WooCommerce plugin), aby skorzystać z konfiguracji z przewodnikiem. Zainstaluj wtyczkę ChatLab, otwórz jej menu w WordPressie, pozostaw zaznaczoną opcję Połącz integrację WooCommerce (Connect WooCommerce integration) i kliknij Kontynuuj (Continue). Zaloguj się do ChatLab i wybierz swojego chatbota. Spowoduje to połączenie Twojego sklepu i zainstalowanie widgetu. Zobacz instrukcję instalacji chatbota w WordPressie.

Wybierz Kontynuuj z konfiguracją ręczną (Continue with manual setup), jeśli chcesz użyć własnych kluczy API. Poniższe kroki opisują tę alternatywną metodę.

Krok 1: Wygeneruj klucze API w WooCommerce

1. Zaloguj się do panelu administracyjnego WordPress
2. Przejdź do WooCommerce > Settings (Ustawienia)
3. Kliknij zakładkę Advanced (Zaawansowane)
4. Wybierz REST API
5. Kliknij Add Key (Dodaj klucz)
6. Wprowadź opis (np. "Integracja z ChatLab")
7. Wybierz użytkownika, do którego chcesz przypisać klucz - musi to być użytkownik z rolą Administrator lub Shop Manager (Menedżer sklepu); inne role, takie jak Customer czy Subscriber, nie mają wymaganych uprawnień dostępu do danych WooCommerce
8. Ustaw uprawnienia na Read (Odczyt)
9. Kliknij Generate API Key (Wygeneruj klucz API)
10. Skopiuj Consumer Key oraz Consumer Secret - przechowuj je w bezpiecznym miejscu, ponieważ Consumer Secret nie będzie już ponownie widoczny

Krok 2: Połącz WooCommerce w ChatLab

1. Zaloguj się do ChatLab i wybierz swojego bota
2. Przejdź do zakładki Connect (Połącz)

3. Kliknij Connect (Połącz) na kafelku WooCommerce
4. Wpisz URL of WooCommerce store (pełny adres URL Twojego sklepu, np. https://www.mystore.com)
5. Wpisz Customer Key (Consumer Key z Kroku 1)
6. Wpisz Customer Secret (Consumer Secret z Kroku 1)

7. Kliknij Connect (Połącz)

ChatLab automatycznie przetestuje połączenie, sprawdzając, czy Twoje dane uwierzytelniające API posiadają wymagane uprawnienia. Jeśli operacja się powiedzie, zobaczysz komunikat potwierdzający.

Opcje połączenia

Formularz połączenia WooCommerce zawiera dodatkowe ustawienia:

• Use order search instead of retrieve (Użyj wyszukiwania zamówień zamiast pobierania) - włącz tę opcję, jeśli Twój sklep korzysta z wtyczek do niestandardowej numeracji zamówień. Używa ona wyszukiwania zamiast bezpośredniego pobierania, co zapewnia zgodność ze zmodyfikowaną numeracją zamówień.
• Use product short description (Użyj krótkiego opisu produktu) - po włączeniu wyniki wyszukiwania produktów zwracają krótki opis WooCommerce zamiast pełnego opisu. Przydatne w sklepach z bardzo długimi opisami produktów.
• Include in-stock products only (Uwzględniaj tylko produkty w magazynie) - po włączeniu wyniki wyszukiwania produktów obejmują wyłącznie artykuły, które są obecnie dostępne w magazynie.
• Store language (Język sklepu) - wybierz język danych swoich produktów.
• Custom metadata fields (Niestandardowe pola metadanych) - uwzględniaj tylko te pola produktów, które są przydatne dla klientów; nie ujawniaj prywatnych metadanych.
• Maximum variants (Maksymalna liczba wariantów) - ogranicza liczbę zwracanych wariantów dla danego produktu.

Krok 3: Skonfiguruj akcje WooCommerce

Po nawiązaniu połączenia możesz włączyć i dostosować poszczególne akcje AI. Przejdź do Ustawienia > Akcje (Settings > Actions) i przefiltruj listę według platformy WooCommerce.

Akcje dotyczące słów kluczowych i zamówień obejmują:

• WooCommerce - Product Search - pozwala chatbotowi przeszukiwać Twój katalog produktów według słów kluczowych
• WooCommerce - Product Search by SKU - pozwala chatbotowi wyszukiwać produkty na podstawie ich SKU, numeru referencyjnego lub kodu produktu
• WooCommerce - Product Search in Category - pozwala chatbotowi wyszukiwać produkty w określonej kategorii
• WooCommerce - Get Categories - pozwala chatbotowi wyświetlać listę kategorii produktów w Twoim sklepie
• WooCommerce - get product variants - pobiera dostępne warianty wybranego produktu
• WooCommerce - Get Order - pozwala chatbotowi sprawdzać informacje o zamówieniu na podstawie identyfikatora zamówienia i adresu e-mail

Konfiguracja połączenia domyślnie włącza sprawdzanie zamówień, kategorie, wyszukiwanie według słów kluczowych, wyszukiwanie w kategoriach oraz warianty. Opcję Product Search by SKU musisz przejrzeć i włączyć osobno, jeśli chcesz z niej korzystać. Wyłącz akcje, do których klienci nie powinni mieć dostępu. Otwórz akcję, aby ją edytować, a następnie kliknij Włącz (Enable) lub Zaktualizuj (Update) w oknie dialogowym. Możesz także dostosować etykietę akcji (komunikat wyświetlany użytkownikom podczas wykonywania akcji) oraz instrukcje sterujące tym, jak AI korzysta z poszczególnych akcji.

Opcje sprawdzania zamówień i wyszukiwania produktów

W konfiguracji akcji zamówień opcja Zezwalaj na sprawdzanie zamówienia bez weryfikacji e-mail (Allow order lookup without email verification) jest domyślnie wyłączona. Jej włączenie ujawnia szczegóły zamówienia każdemu, kto poda poprawny identyfikator zamówienia. Zostaw ją wyłączoną, chyba że Twoje wdrożenie posiada odpowiednie mechanizmy kontroli dostępu.

Wtyczka ChatLab WooCommerce obsługuje również rozszerzone przeszukiwane pola produktów oraz rozmyte dopasowywanie SKU (fuzzy matching). Opcje te wymagają wykrycia rozszerzenia wtyczki; bez niego wyszukiwanie według słów kluczowych korzysta z natywnego wyszukiwania WooCommerce, a wyszukiwanie SKU opiera się na dopasowaniu ścisłym. Przejrzyj odpowiednią akcję wyszukiwania produktów przed napisaniem instrukcji, które zależą od tych opcji.

AI Search dla WooCommerce: katalog, ponowne indeksowanie i ustawienia

W planie E-commerce lub w planie Universal, gdy do chatbota przypisany jest pakiet produktów AI Search, funkcja AI Search jest włączona i zastępuje wyszukiwanie na żywo w sklepie. Indeksowanie rozpoczyna się automatycznie po połączeniu sklepu.

• Sprawdź katalog - otwórz Training > E-commerce catalog (Trenowanie > Katalog e-commerce) i przejrzyj zakładki Products (Produkty) oraz Categories (Kategorie). W sekcji Shop > Products (Sklep > Produkty) widoczny jest panel Product catalog (Katalog produktów) oraz karta AI Search packs on this chatbot (Pakiety AI Search w tym chatbocie).
• Zaplanuj ponowne indeksowanie - użyj opcji Schedule auto-retrain (Zaplanuj automatyczne ponowne trenowanie) w Training > E-commerce catalog. Ponowne indeksowanie może odbywać się nawet codziennie i jest dostępne w każdym planie E-commerce oraz z każdym pakietem produktów. Opcja Train now (Trenuj teraz) lub Retrain (Trenuj ponownie) uruchamia je na żądanie. Odświeżanie działa przyrostowo: niezmienione produkty są pomijane, a usunięte produkty są kasowane z indeksu.
• Przejrzyj akcję - w zakładce Settings > Actions (Ustawienia > Akcje) otwórz WooCommerce - AI product search (WooCommerce - wyszukiwanie produktów AI). Dostępne opcje to Include product card (Dołącz kartę produktu), Products in stock only (Tylko produkty w magazynie) oraz Number of products to return (Liczba zwracanych produktów).
• Wyświetlaj karty produktów - włącz Enable Offer Cards (Włącz Offer Cards) w Settings > Model & Advanced (Ustawienia > Model i zaawansowane). Zobacz Offer Cards.

Gdy katalog jest większy niż limit produktów, indeksowanie zatrzymuje się na limicie, a właściciel chatbota otrzymuje wiadomość e-mail. Opcje opisanej powyżej akcji wyszukiwania na żywo w sklepie nie muszą mieć zastosowania do AI Search.

Testowanie Twojej integracji

Po aktywowaniu akcji otwórz zakładkę Overview (Przegląd) i wypróbuj:

• "Pokaż mi buty do biegania" (testuje wyszukiwanie produktów)
• "Szukam produktu o SKU WH-1234" (testuje wyszukiwanie produktu po kodzie SKU)
• "Jakie macie kategorie?" (testuje pobieranie kategorii)
• "Pokaż mi buty w kategorii Sportswear" (testuje wyszukiwanie produktów w kategorii)
• "Jaki jest status mojego zamówienia #1001?" (testuje szczegóły zamówienia; podaj pasujący adres e-mail dla zamówienia, do którego masz uprawnienia dostępu)

Sprawdź, czy odpowiedzi są zgodne z danymi z Twojego sklepu WooCommerce i czy linki do produktów otwierają się poprawnie.

Zainstaluj chatbota w swoim sklepie WooCommerce

Aby dodać widget czatu do swojej witryny WordPress/WooCommerce, zapoznaj się ze szczegółowym przewodnikiem: Instalacja chatbota w sklepie WooCommerce

Zobacz demo

Możesz zobaczyć działającą integrację WooCommerce na żywo: https://yourwear.chatlab.com/shop

Powiązane artykuły

• AI Search: jak Twój chatbot wyszukuje produkty
• Plany e-commerce i limity
• Przewodnik po konfiguracji e-commerce
• Dodawanie chatbota do Twojej strony