BotChata

Jak dodać chatbota AI do Magento 2 — krok po kroku

↑ Część poradnika chatbot na stronę

W skrócie: tworzysz agenta w BotChata, pozwalasz mu zindeksować sklep i wklejasz jeden tag skryptu w Content → Design → Configuration → Footer → Miscellaneous HTML. Od tej chwili bot odpowiada na pytania o wysyłkę, zwroty i produkty na podstawie treści Twojego sklepu, w ponad 40 językach, całą dobę. Około 5 minut, bez rozszerzenia, bez programisty. W planie Base podłączasz też token integracji Magento: wtedy bot pokazuje karty produktów z katalogu i sprawdza status zamówienia, po weryfikacji e-maila lub telefonu klienta.

→ Zacznij za darmo — bez karty · Gotowe w 5 minut · Darmowy plan na zawsze

Dlaczego to ważne w sklepie na Magento: katalogi są duże, a odpowiedzi, których szuka klient, rozrzucone po stronach CMS, atrybutach produktów i stopce. Bot, który przeczytał wszystko, odpowiada w kilka sekund. Raz w tygodniu dostajesz e-mail z pytaniami, na które nie znalazł odpowiedzi: to luki, które warto uzupełnić na stronie.

Czego potrzebujesz

Nazwy menu podajemy po angielsku, tak jak w standardowym panelu. Z polskim pakietem językowym menu są przetłumaczone; ich położenie w menu jest to samo.

Część 1 — Konfiguracja BotChata (ok. 3 minuty)

Krok 1: Utwórz agenta

Zarejestruj się na botchata.net i otwórz panel. Kliknij „Dodaj stronę", w oknie „Dodaj agenta" wpisz Nazwę strony i URL strony sklepu, a potem kliknij „Utwórz i rozpocznij indeksowanie".

Dodaj agenta — nazwa i adres URL strony

Krok 2: Poczekaj na indeksowanie

BotChata czyta strony produktów i kategorii, wysyłkę i zwroty, regulamin, FAQ i kontakt. W Szkolenie → Linki widzisz każdą znalezioną stronę; gdy są oznaczone jako zindeksowane, agent jest gotowy. Przy dużym katalogu sprawdź, czy są tam też strony CMS (wysyłka, zwroty), a nie tylko produkty.

Szkolenie → Linki — wszystkie podstrony zindeksowane

Krok 3: Szybki test

Otwórz Przegląd agenta i zadaj w czacie testowym prawdziwe pytania klientów: „Czy wysyłacie InPostem?", „Ile mam dni na zwrot?". Odpowiedź „nie wiem" oznacza, że tej informacji brakuje na stronie. Lepiej dowiedzieć się o tym przed klientem.

Zakładka Przegląd — podgląd czatu na żywo

Krok 4: Skopiuj kod

Wejdź w Publikacja → Widget, otwórz zakładkę „Skrypt" i kliknij „Kopiuj":

Publikacja → Widget → Skrypt — kod osadzenia z przyciskiem Kopiuj

<script
  src="https://botchata.net/api/widget.js"
  data-api-key="TWOJ_KLUCZ"
  data-api-url="https://botchata.net/api"
  defer
></script>

Część 2 — Wklej skrypt w Magento (ok. 2 minuty)

Magento ma na to pole w panelu. Bez plików motywu, bez modułu.

✅ Sposób A (zalecany): Footer → Miscellaneous HTML

  1. W bocznym menu panelu wejdź w Content → Design → Configuration.
  2. Znajdź w tabeli swój Store View i kliknij Edit w kolumnie Action.
  3. W sekcji Other Settings rozwiń Footer.
  4. Wklej skrypt BotChata w pole Miscellaneous HTML. Magento umieszcza go tuż przed zamykającym </body>.
  5. Kliknij Save Configuration.
  6. Jeśli Magento zgłasza nieaktualne typy cache, odśwież je w System → Tools → Cache Management. Jeśli przed sklepem stoi Varnish lub CDN, wyczyść także je.

Kilka Store View (np. po jednym na język)? Powtórz to dla każdego, w którym ma być czat. Jeden agent obsłuży wszystkie, bo sam rozpoznaje język klienta.

Sposób B: HTML Head → Scripts and Style Sheets

Ten sam ekran, tylko sekcja HTML Head zamiast Footer. Skrypt trafia wtedy przed </head>; dzięki defer i tak czeka na stronę. Wybierz ten sposób, jeśli pole w stopce zajmuje już motyw albo inne rozszerzenie.

Checkout. Od Magento 2.4.7 strony płatności egzekwują Content Security Policy, a według Adobe skrypty z tych pól konfiguracji muszą być tam dopuszczone. W pozostałej części sklepu polityka tylko raportuje. W praktyce: czat pojawia się na stronach produktów, kategorii i CMS; w checkoucie może go nie być, dopóki programista nie dopisze botchata.net do script-src i connect-src w dozwolonych źródłach CSP (csp_whitelist.xml). Dla większości sklepów checkout bez czatu jest w porządku.

Opcjonalnie: karty produktów i status zamówienia (Base)

Skrypt daje botowi Twoje strony. Integracja daje mu katalog i zamówienia, na żywo. Działa na własnym tokenie integracji Magento; w sklepie nic się nie instaluje.

W Magento

  1. System → Extensions → Integrations → Add New Integration. Wpisz nazwę (np. „BotChata") i potwierdź hasłem administratora.
  2. Po lewej otwórz API, ustaw Resource Access na Custom i zaznacz:
    • Catalog → Inventory → Products (wyszukiwanie produktów);
    • Sales → Operations → Orders → Actions → View (status zamówienia);
    • Sales → Operations → Shipments (numery przesyłek).
  3. Save, potem Activate → Allow i skopiuj Access Token.
  4. Od Magento 2.4.4: Stores → Configuration → Services → OAuth → Consumer Settings → „Allow OAuth Access Tokens to be used as standalone Bearer tokens" → Yes, zapisz.

Adobe oznacza ten przełącznik jako niezalecany, bo token integracji nie wygasa. Daj integracji tylko trzy zasoby z listy i cofnij ją w System → Integrations, jeśli przestaniesz używać BotChata.

Bez kroku 4 Magento odrzuca każde zapytanie tym samym 401 "The consumer isn't authorized to access %resources", co przy braku uprawnień. Obu sytuacji nie da się odróżnić po odpowiedzi. Sprawdź ten przełącznik najpierw.

W BotChata

  1. Funkcje → Integracje → Magento → Połącz.
  2. Wpisz Store URL i Integration access token, kliknij Zapisz.
  3. Kliknij Testuj połączenie. Test sprawdza tylko wyszukiwanie produktów.
  4. Zamówienia sprawdź w czacie testowym w Przeglądzie: zapytaj o prawdziwe zamówienie, podając jego e-mail.
  5. W Funkcje → Możliwości → Sklep internetowy ustaw „Waluta ceny na karcie" na walutę sklepu, np. PLN (widoczne, gdy karty produktów są włączone). API Magento podaje cenę bez waluty.

Co bot dostaje z Magento

Klient pytaCo się dzieje
„Macie lnianą koszulę?"Wyszukiwanie po nazwie produktu, do 6 wyników jako karty: zdjęcie, nazwa, cena, link
„Gdzie jest zamówienie 42?"Zapytanie wymaga numeru zamówienia oraz e-maila lub telefonu z zamówienia; bez obu nie zwraca nic. „42" znajduje 000000042; numer z prefiksem sklepu trzeba wpisać w całości
Kontakt się zgadzaStatus, data, kwota i waluta, sposób dostawy, numer przesyłki z przewoźnikiem, pozycje. Produkt konfigurowalny pojawia się jako kupiony wariant („Lniana koszula Niebieska")
Kontakt się nie zgadzaNic. Weryfikacja działa w kodzie, zanim model zobaczy jakiekolwiek dane zamówienia

Pięć szczegółów Magento, które warto znać przed podłączeniem:

Dlaczego status zamówienia jest „chwilowo niedostępny"

Integracja założona wcześniej do czegoś innego ma zwykle tylko uprawnienia Catalog. Wyszukiwanie produktów wtedy działa, a pytania o zamówienia dostają „chwilowo niedostępne". Dodaj Orders (i Shipments dla numerów przesyłek) w zasobach integracji i kliknij Reauthorize: Magento wyda nowy token, który wklejasz w BotChata. Albo załóż osobną integrację tylko dla BotChata, jak wyżej. Bez Shipments zamówienie i tak się wyświetli, bot nie zna tylko numeru przesyłki. Dostaje wtedy null zamiast pustej listy, więc nic nie mówi mu „nie wysłano".

Paczkę InPost, DPD czy DHL bot może też sprawdzić po samym numerze przesyłki, bez Magento: to osobne integracje przewoźników, dostępne od planu Base (39 €/mies.).

Sprawdź, czy działa

  1. Otwórz sklep w oknie prywatnym.
  2. W prawym dolnym rogu pojawia się dymek BotChata.
  3. Zadaj prawdziwe pytanie („Czy wysyłacie do Czech?").
  4. Odpowiedź przychodzi w kilka sekund, z treści Twojego sklepu.

Typowe problemy

ProblemRozwiązanie
Widget się nie pojawia.Odśwież cache w System → Tools → Cache Management, wyczyść Varnish/CDN. Sprawdź, czy edytowałeś Store View, który właśnie oglądasz.
Widać go wszędzie poza checkoutem.To CSP stron płatności od 2.4.7 (patrz wyżej). Dopuść botchata.net albo zostaw checkout bez czatu.
„Testuj połączenie" kończy się błędem 401.Przełącznik Bearer w Stores → Configuration → Services → OAuth jest wyłączony albo integracji brakuje Catalog → Products.
Karty pokazują samą liczbę.Ustaw „Waluta ceny na karcie" w Funkcje → Możliwości → Sklep internetowy.
Link z karty prowadzi do 404.Sufiks URL produktów to nie .html albo w adresie jest kod sklepu. Porównaj z prawdziwym adresem produktu.
Bot nie zna nowego produktu.Doszedł po indeksowaniu. Zindeksuj ponownie w Szkolenie → Linki albo podłącz integrację, wtedy wyszukiwanie czyta katalog na żywo.
Odpowiada w złym języku.Bot rozpoznaje język klienta (40+). Przetestuj w świeżym oknie.

Najczęstsze pytania

Czy jest rozszerzenie BotChata w Magento Marketplace? Nie i nie jest potrzebne. Widget to jeden tag skryptu w konfiguracji wyglądu. Wyszukiwanie produktów i status zamówienia działają przez własny token integracji Magento.

Czy działa z Adobe Commerce i Adobe Commerce Cloud? Tak w Magento Open Source oraz Adobe Commerce na własnym serwerze lub na infrastrukturze chmurowej (cloud infrastructure). Adobe Commerce as a Cloud Service (sklep na Edge Delivery) używa innej warstwy sklepu, więc ten poradnik tam nie pasuje.

Czy bot poda klientowi status zamówienia? Tak, w planie Base, z tokenem integracji z uprawnieniem do zamówień. Zapytanie wymaga numeru zamówienia oraz e-maila lub telefonu z zamówienia; jeśli się nie zgadzają, bot nie pokazuje nic.

Ile to kosztuje? Plan darmowy: 0 € na zawsze, 100 wiadomości/mies., bez karty. Płatne plany mają stałą cenę: Base 39 €, Business 119 €, Premium 299 € miesięcznie, bez tokenów i kredytów (cennik). Integracja z Magento jest od planu Base. (Hosting Magento opłacasz osobno.)

Czy widget spowolni sklep? Nie. defer, izolowany Shadow DOM, brak blokowania renderowania.

Zacznij teraz

Daj swojemu sklepowi na Magento asystenta, który przeczytał każdą stronę i odpowiada klientom o każdej porze.

→ Zacznij za darmo — bez karty

Gotowe w 5 minut. 100 wiadomości/mies. za darmo. Karty produktów i status zamówienia od planu Base (39 €/mies.). Szerzej o botach w e-commerce: chatbot AI dla sklepu.