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
- Magento Open Source lub Adobe Commerce 2.4 z dostępem administratora do Content → Design.
- Konto BotChata. Do samego widgetu wystarczy plan darmowy (rejestracja e-mailem, bez karty). Indeksuje do 200 tys. znaków; duży katalog wymaga planu Base.
- Do kart produktów i statusu zamówienia: plan Base i dostęp do System → Integrations.
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".

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.

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.

Krok 4: Skopiuj kod
Wejdź w Publikacja → Widget, otwórz zakładkę „Skrypt" i kliknij „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
- W bocznym menu panelu wejdź w Content → Design → Configuration.
- Znajdź w tabeli swój Store View i kliknij Edit w kolumnie Action.
- W sekcji Other Settings rozwiń Footer.
- Wklej skrypt BotChata w pole Miscellaneous HTML. Magento umieszcza go tuż przed zamykającym
</body>. - Kliknij Save Configuration.
- 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.netdoscript-srciconnect-srcw 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
- System → Extensions → Integrations → Add New Integration. Wpisz nazwę (np. „BotChata") i potwierdź hasłem administratora.
- 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).
- Save, potem Activate → Allow i skopiuj Access Token.
- 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
- Funkcje → Integracje → Magento → Połącz.
- Wpisz Store URL i Integration access token, kliknij Zapisz.
- Kliknij Testuj połączenie. Test sprawdza tylko wyszukiwanie produktów.
- Zamówienia sprawdź w czacie testowym w Przeglądzie: zapytaj o prawdziwe zamówienie, podając jego e-mail.
- 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 pyta | Co 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ę zgadza | Status, 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 zgadza | Nic. Weryfikacja działa w kodzie, zanim model zobaczy jakiekolwiek dane zamówienia |
Pięć szczegółów Magento, które warto znać przed podłączeniem:
- Status to kod Magento, nie Twoja nazwa:
pending,processing,complete,canceled,holded,closed. REST API Magento nie ma endpointu z etykietami statusów. - Wyszukiwanie szuka frazy w nazwie. „lniana koszula" znajdzie „Lniana koszula Niebieska", „koszula lniana" już nie.
- Karta pokazuje cenę regularną. Ceny specjalne i reguły cenowe katalogu do niej nie trafiają.
- Link na karcie ma postać
twoj-sklep.pl/<url-key>.html, czyli domyślną w Magento. Jeśli zmieniłeś sufiks URL produktów albo masz kody sklepów w adresach, kliknij jeden link z karty dla pewności. - Ten sam numer zamówienia w dwóch Store View? Bot odpowiada tylko o tym, którego kontakt się zgadza, a gdy pasują oba, odmawia.
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
- Otwórz sklep w oknie prywatnym.
- W prawym dolnym rogu pojawia się dymek BotChata.
- Zadaj prawdziwe pytanie („Czy wysyłacie do Czech?").
- Odpowiedź przychodzi w kilka sekund, z treści Twojego sklepu.
Typowe problemy
| Problem | Rozwią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.