Centrum Pomocy
Integracje chatbota

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

Ostatnia aktualizacja:

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

Przykładowa rozmowa

Zobacz to w rozmowie

Sprawdź zamówienie

Wymaga połączonego sklepu i włączonej akcji zamówień. Dostępne pola zależą od integracji. Dopasowanie adresu e-mail nie stanowi potwierdzenia tożsamości.

Przykład ChatLabPrzykładowa rozmowa

Odwiedzający: Gdzie jest moje zamówienie?

Odtwórz przykład lub przeczytaj go poniżej. Nie wykorzystano żadnych prawdziwych danych klientów.
1 / 5

Klient pyta o istniejące zamówienie.

Odtwarzanie zatrzymuje się, gdy ten przykład znika z ekranu. To jest symulacja, a nie czat na żywo. Elementy sterujące widgetu wewnątrz odtwarzania nie są interaktywne.
Przeczytaj cały przykład
  1. Klient pyta o istniejące zamówienie.

    Odwiedzający: Gdzie jest moje zamówienie?

  2. Domyślne wyszukiwanie wymaga obu identyfikatorów.

    Asystent: Podaj proszę numer zamówienia oraz adres e-mail użyty podczas zakupu.

  3. W tym przykładzie użyj fikcyjnych danych.

    Odwiedzający: 41982, anna@example.com

  4. Akcja wysyła zapytanie do połączonego sklepu.

    Sprawdzam zamówienie 41982...

  5. Przekazuj wyłącznie informacje zwrócone przez sklep.

    Asystent: Zamówienie 41982 jest oznaczone jako wysłane. Przewoźnikiem jest DPD. Sprawdź stronę śledzenia przesyłki, aby poznać status doręczenia.

Przykład ilustruje doświadczenie klienta. Dostępne akcje i zwracane informacje zależą od tej integracji oraz Twojej konfiguracji.

Ważne: sprawdzone metody dla e-commerce

Po ukończeniu poniższej integracji przeczytaj wyczerpujący przewodnik po optymalizacji chatbota dla e-commerce: Jak skonfigurować ChatLab dla swojego sklepu e-commerce

Jak chatbot wyszukuje produkty w Shoper: AI Search i wyszukiwanie w sklepie na żywo

Chatbot ChatLab może wyszukiwać produkty w sklepie Shoper na dwa sposoby. Chatbot korzysta z jednego albo z drugiego, nigdy z obu naraz.

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

  • Klienci pytają w naturalnym języku, na przykład "czerwona sukienka poniżej 300". Zakres cenowy jest stosowany jako ścisły filtr, dopasowywane są także dokładne kody produktów (SKU, EAN).
  • Cena, stan magazynowy i warianty są odczytywane na żywo z Shoper w momencie udzielania odpowiedzi, więc klienci widzą aktualne dane nawet pomiędzy odświeżeniami indeksu.
  • Wyniki pojawiają się jako karty produktów na czacie, maksymalnie do 5 w jednej odpowiedzi.
  • Indeksowanie rozpoczyna 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 integracji e-commerce (30 $ miesięcznie) oraz pakiet produktów AI Search (29 $ miesięcznie, 5 000 produktów) przypisany do chatbota.

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

  • Nic nie jest indeksowane i nic nie musi być synchronizowane. Dane są zawsze pobierane na żywo.
  • Jest to wyszukiwanie po słowach kluczowych: znajduje dokładnie to, co znalazłaby własna wyszukiwarka Twojego sklepu dla danej frazy. Nie rozumie opisów potrzeb, synonimów ani literówek tak dobrze jak AI Search.
  • Wymagany plan: plan Universal z dodatkiem integracji e-commerce (30 $ miesięcznie). Pakiet produktów nie jest wymagany.

Gdy funkcja AI Search jest włączona, zastępuje ona wyszukiwanie w sklepie na żywo. Status zamówienia działa w ten sam sposób przy obu ścieżkach. 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 wyszukuje produkty), a limity produktów opisano w E-commerce plans and limits (Plany i limity e-commerce).

Co zapewnia integracja

Wyszukiwanie w sklepie na żywo (wyszukiwanie produktów według frazy) - Chatbot przesyła frazę wpisaną przez klienta do wyszukiwarki Shoper. Przeszukuje nazwy produktów przy użyciu dopasowania rozmytego (fuzzy matching), zwracając do 10 pasujących produktów wraz z:

  • Nazwą i opisem produktu
  • Ceną oraz SKU
  • Bezpośrednim linkiem do strony produktu w Twoim sklepie
  • Zdjęciem produktu
  • Stanem magazynowym
  • Opcjonalnie: załącznikami do produktu (pliki PDF, dokumenty)

Możesz także włączyć filtr dostępności w magazynie (in-stock filter), aby wyświetlać wyłącznie produkty, które są aktualnie dostępne.

Szczegóły zamówienia - Klienci mogą sprawdzić status swojego zamówienia, podając numer zamówienia oraz adres e-mail powiązany z zamówieniem. Obie wartości są weryfikowane na podstawie danych z Twojego sklepu Shoper. Chatbot zwraca:

  • Numer zamówienia, datę i bieżący status
  • Łączną kwotę zamówienia oraz walutę
  • Zamówione produkty wraz z nazwami, ilościami i cenami
  • Adres dostawy (ulica, miasto, kod pocztowy, kraj, telefon)
  • Adres rozliczeniowy
  • Uwagi do zamówienia

Dwa sposoby na połączenie Twojego sklepu

Istnieją dwa sposoby na połączenie platformy Shoper z ChatLab:

  • Metoda 1: Aplikacja ChatLab ze sklepu Shoper App Store (zalecana) - instalacja jednym kliknięciem. Aplikacja tworzy połączenie, aktywuje wyszukiwanie produktów oraz szczegóły zamówień, a także dodaje widget czatu na stronę Twojego sklepu. Bez kopiowania kluczy API.
  • Metoda 2: Konfiguracja ręczna - tworzysz administratora WebAPI w platformie Shoper i wprowadzasz jego dane uwierzytelniające w ChatLab. Użyj tej metody tylko wtedy, gdy nie możesz zainstalować aplikacji lub gdy chcesz połączyć sklep z chatbotem, którym zarządzasz w określony sposób.

Wybierz jedną metodę. Nie twórz drugiego połączenia za pomocą Metody 2, jeśli aplikacja połączyła już sklep.

Metoda 1: Zainstaluj aplikację ChatLab z Shoper App Store

Bezpłatna aplikacja ChatLab w Shoper App Store to najszybszy sposób, aby zacząć. Nie potrzebujesz wcześniejszego konta ChatLab ani chatbota - oba zostaną utworzone podczas instalacji.

  1. W panelu administracyjnym Shoper przejdź do Dodatki i integracje > Aplikacje (Add-ons and integrations > Applications), znajdź ChatLab - AI Chatbot for Customer Support and Sales i zainstaluj aplikację
  2. Otwórz aplikację ChatLab w panelu administracyjnym Shoper - panel ChatLab otworzy się w nowym oknie
  3. Ustaw hasło (nowe konto) lub zaloguj się na swoje istniejące konto ChatLab
  4. Jeśli konfiguracja rozpoczęła się w kreatorze chatbota, potwierdź połączenie sklepu z tym chatbotem; w przeciwnym razie chatbot dla sklepu zostanie utworzony na Twoim koncie
  5. Wybierz plan lub zostań przy planie bezpłatnym - możesz przejść na wyższy pakiet później w sekcji Konto > Subskrypcja (Account > Subscription)

To wszystko. Sklep jest połączony, akcje wyszukiwania produktów i sprawdzania statusu zamówienia są włączone, a chatbot pojawi się na stronie Twojego sklepu od razu po nawiązaniu połączenia. Przejdź do sekcji Skonfiguruj akcje Shoper poniżej, aby przejrzeć akcje, lub otwórz Test & Deploy > Shoper w ChatLab, aby ponownie zobaczyć te same kroki instalacji.

Metoda 2: Ręczna konfiguracja

Użyj tej metody, gdy nie możesz zainstalować aplikacji. Zanim zaczniesz, upewnij się, że:

  • Twoja subskrypcja ChatLab obejmuje integrację z Shoper
  • Masz dostęp do panelu administracyjnego Shoper
  • Twój chatbot jest już utworzony w ChatLab

Ręczna konfiguracja łączy wyłącznie dane sklepu. Widget czatu należy dodać na stronie sklepu osobno - zobacz sekcję Zainstaluj chatbota w swoim sklepie Shoper na końcu tego artykułu.

Krok 1: Utwórz grupę administratorów

  1. W panelu administracyjnym Shoper przejdź do Ustawienia > Administratorzy sklepu (Settings > Store administrators)

Panel administracyjny Shoper z widokiem strony Grupy administratorów|width=19

  1. Kliknij WIĘCEJ (MORE) > Dodaj grupę administratorów (Add administrators group)

Przycisk dodawania grupy na stronie Grupy administratorów|width=60

  1. Wprowadź nazwę grupy (np. "ChatLab Integration"), wybierz Rodzaj dostępu: 'dostęp do webapi' i zapisz zmiany

Formularz dodawania grupy administratorów|width=60

Krok 2: Skonfiguruj uprawnienia grupy

  1. Otwórz nowo utworzoną grupę i przejdź do ustawień uprawnień
  2. Nadaj uprawnienie Odczyt (Read) do następujących zasobów:
    • Sprzedaż (Sales) - odczyt
    • Asortyment (Catalog) - odczyt
    • Konfiguracja (Configuration) - odczyt

Konfiguracja uprawnień grupy z wymaganymi uprawnieniami do odczytu|width=60

Krok 3: Dodaj administratora API

  1. Przejdź do sekcji Administratorzy (Administrators) i kliknij Dodaj administratora (Add administrator)

Strona Administratorzy z przyciskiem Dodaj administratora|width=60

  1. Uzupełnij login oraz hasło i przypisz administratora do grupy utworzonej w Kroku 1

Formularz dodawania administratora z polami loginu, hasła i wyborem grupy|width=40

  1. Zapisz administratora. Zanotuj login i hasło - będą Ci potrzebne w kolejnym kroku.

Krok 4: Połącz Shoper w ChatLab

  1. Zaloguj się do ChatLab i wybierz swojego bota
  2. Przejdź do zakładki Connect

Zakładka Connect z kafelkiem integracji Shoper

  1. Kliknij Connect na kafelku Shoper
  2. Wprowadź swój Shop URL (Twoja domena w Shoper, np. myshop.shoper.pl)
  3. Wprowadź swój WebAPI Login (z Kroku 3)
  4. Wprowadź swoje WebAPI Password (z Kroku 3)

Formularz integracji Shoper z polami adresu URL sklepu, loginu i hasła

  1. Kliknij Initialize Configuration - spowoduje to pobranie języków dostępnych w Twoim sklepie
  2. Wybierz odpowiedni Shop Language z listy rozwijanej (określa on, która wersja językowa danych o produktach będzie pobierana)
  3. Kliknij Connect

ChatLab automatycznie sprawdza połączenie, wykonując testowe wyszukiwanie produktów. Jeśli przebiegnie ono pomyślnie, zobaczysz komunikat z potwierdzeniem, a akcje wyszukiwania produktów i sprawdzania szczegółów zamówień zostaną domyślnie włączone.

Skonfiguruj akcje Shoper

Po połączeniu dowolną z metod możesz włączyć i dostosować poszczególne akcje AI. Przejdź do Ustawienia > Akcje (Settings > Actions) i przefiltruj listę według platformy Shoper.

Akcje Shoper w Ustawieniach pokazujące wyszukiwanie produktów i szczegóły zamówienia

Standardowe akcje obejmują:

  • Shoper - product search - umożliwia chatbotowi przeszukiwanie Twojego katalogu produktów
  • Shoper - order details - umożliwia chatbotowi sprawdzanie informacji o zamówieniu

Konfiguracja połączenia włącza standardowe akcje. Sprawdź ich status i wyłącz te, z których klienci nie powinni korzystać. Otwórz akcję, aby ją edytować, a następnie użyj przycisku Włącz (Enable) lub Aktualizuj (Update) w oknie dialogowym. Możesz także dostosować etykietę akcji (komunikat wyświetlany użytkownikom podczas wykonywania akcji) oraz instrukcje określające, w jaki sposób AI korzysta z każdej akcji.

W przypadku wyszukiwania produktów kliknij przycisk Edytuj (Edit) i przejdź do zakładki Ustawienia wyszukiwania produktów (Product Search Settings). Dostępne są dwie dodatkowe opcje:

  • Dołącz załączniki do produktów (Include product attachments) - po włączeniu chatbot uwzględnia załączniki do produktów (pliki PDF, dokumenty) w wynikach wyszukiwania
  • Tylko produkty dostępne w magazynie (Products in stock only) - po włączeniu chatbot zwraca tylko produkty, które są aktualnie na stanie

Ustawienia wyszukiwania produktów pokazujące opcje załączników i filtrowania stanu magazynowego

AI Search dla Shopera: katalog, ponowne indeksowanie i ustawienia

W planie E-commerce lub w planie Universal, gdy pakiet produktów AI Search jest przypisany do chatbota, 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 Trenowanie > E-commerce catalog (Katalog e-commerce) i przejrzyj zakładki Products (Produkty) oraz Categories (Kategorie). W sekcji Shop > Products (Sklep > Produkty) zobaczysz panel Product catalog (Katalog produktów) oraz kartę AI Search packs on this chatbot (Pakiety AI Search na tym chatbocie).
  • Zaplanuj ponowne indeksowanie - użyj opcji Schedule auto-retrain (Zaplanuj automatyczne ponowne trenowanie) w Trenowanie > 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. Opcje Train now (Trenuj teraz) lub Retrain (Trenuj ponownie) uruchamiają je na żądanie. Odświeżanie działa przyrostowo: niezmienione produkty są pomijane, a usunięte produkty są wycofywane z indeksu.
  • Przejrzyj akcję - w zakładce Ustawienia > Actions (Akcje) otwórz Shoper - AI product search. 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 Ustawienia > Model & Advanced. Zobacz Offer Cards.

Gdy katalog jest większy niż limit produktów, indeksowanie zatrzymuje się po osiągnięciu limitu, a właściciel chatbota otrzymuje wiadomość e-mail. Opcje opisanej powyżej akcji wyszukiwania na żywo w sklepie niekoniecznie mają zastosowanie do AI Search.

Testowanie integracji

Po aktywowaniu akcji otwórz Test & Deploy (Testuj i wdrażaj) i wypróbuj:

  • „Pokaż mi buty do biegania” (testuje wyszukiwanie produktów)
  • „Jaki jest status mojego zamówienia 12345?” (testuje szczegóły zamówienia; podaj powiązany adres e-mail dla zamówienia, do którego masz uprawnienia dostępu)

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

Zainstaluj chatbota w swoim sklepie Shoper

Jeśli korzystasz z Metody 1 (aplikacja), widget czatu znajduje się już w Twoim sklepie i nie musisz nic więcej dodawać. Jeśli wybrano Metodę 2 (konfiguracja ręczna), otwórz Test & Deploy > Shoper w ChatLab, przełącz na Manual Installation (Instalacja ręczna), skopiuj kod i wklej go w panelu administracyjnym Shoper w sekcji Dodatki i integracje > Integracje własne (Add-ons and integrations > Custom integrations) w polu Nagłówek strony (Page header). Zobacz Dodawanie chatbota do Twojej strony, aby dowiedzieć się więcej.

Powiązane artykuły