BotChata

Jak dodać chatbota AI do sklepu Shoper — krok po kroku

↑ Część działu chatbot na stronę

W skrócie: Tworzysz w BotChata agenta AI, pozwalasz mu zindeksować Twój sklep i wklejasz jeden znacznik script w panelu Shopera. Od tej chwili chatbot odpowiada na pytania klientów przez całą dobę — o dostawie, zwrotach, dostępności — na podstawie treści Twojego sklepu, w ponad 40 językach. Bez programisty. Zgodny z RODO, hosting w UE.

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

Dlaczego sklepy to robią: większość zapytań to wciąż te same pytania — gdzie jest moje zamówienie, jak wygląda zwrot, czy wysyłacie InPostem. Chatbot, który zna Twój sklep, odpowiada od razu, odciąża obsługę i zatrzymuje klientów przed odejściem z koszyka.

Czego potrzebujesz (wymagania)

Shoper jest zamkniętym SaaS-em — nie masz dostępu do plików serwera. Nie szkodzi: panel ma własne pole na skrypty, i to wystarczy, żeby uruchomić widżet na całym sklepie.

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

Krok 1: Utwórz agenta i dodaj sklep

Zarejestruj się na botchata.net i otwórz panel. Kliknij Dodaj stronę, w oknie Dodaj agenta wpisz nazwę sklepu i jego adres URL, a potem kliknij Utwórz i rozpocznij indeksowanie. Indeksowanie rusza automatycznie.

Dodaj agenta — nazwa i adres sklepu

Do darmowego startu nie potrzebujesz karty — wystarczy e-mail.

Krok 2: Poczekaj na koniec indeksowania

BotChata przeczyta strony produktów, regulamin, FAQ i kategorie, i zbuduje z nich bazę wiedzy. Dla typowego sklepu zajmuje to 1–3 minuty. W sekcji Szkolenie → Linki widzisz każdą zebraną podstronę ze statusem Zaindeksowano — poczekaj, aż sklep pokaże Gotowy.

Szkolenie → Linki — wszystkie podstrony zindeksowane

Dlaczego to ważne: bot odpowiada wyłącznie z zindeksowanych treści sklepu — Twój prawdziwy regulamin zwrotów, Twoje realne zasady wysyłki. Jeśli czegoś nie ma na stronie, mówi to wprost, zamiast wymyślać zasadę. To chroni Cię przed obietnicami, których nie składasz.

Żeby dodać kolejne źródło (drugą domenę albo pojedynczą podstronę), kliknij Dodaj link i wybierz 🌐 Cała witryna lub 📄 Jedna strona.

Dodaj link — cała witryna albo jedna strona

Krok 3: Szybki test

Przejdź do zakładki Przegląd i zadaj botowi typowe pytania klientów w podglądzie na żywo („Czy wysyłacie InPostem?", „Jak wygląda zwrot?"). Jeśli odpowiedzi się zgadzają — czas na wdrożenie.

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

Krok 4: Skopiuj kod do osadzenia

Otwórz Publikacja → Widget i przejdź do zakładki Skrypt. Skopiuj fragment obok napisu Kod osadzenia:

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>

Atrybut defer ładuje widżet asynchronicznie, więc nie spowalnia Twojego sklepu (Core Web Vitals mają znaczenie dla konwersji). Widżet działa w izolowanym Shadow DOM — nie koliduje z szablonem Shopera.

Część 2 — Dodaj kod do Shopera (ok. 2 minuty)

Masz dwie drogi. Metoda A jest zalecana — nie dotyka szablonu i przetrwa jego aktualizacje.

✅ Metoda A (zalecana): Integracje własne

  1. W panelu Shopera przejdź do Dodatki i integracje → Integracje własne.
  2. Znajdź pole na skrypty w stopce (kod wykonywany przed zamknięciem </body>).
  3. Wklej skopiowany fragment BotChata na końcu tego pola — razem ze znacznikami <script>…</script>, bo pole przyjmuje kod HTML.
  4. Zapisz. Widżet pojawi się na wszystkich stronach sklepu.

⚠️ Jeśli w polu jest już inny kod (analityka, piksele) — nie kasuj go. Dopisz skrypt BotChata poniżej.

Metoda B: własny skrypt JS w szablonie

Alternatywnie użyj pola przy szablonie graficznym: Wygląd i treści → Wygląd sklepu → Obecny szablon graficzny → Własny skrypt JS.

To pole przyjmuje czysty JavaScript, bez znaczników HTML — więc zamiast wklejać <script>, wstaw loader, który sam go doda:

var s = document.createElement("script");
s.src = "https://botchata.net/api/widget.js";
s.setAttribute("data-api-key", "TWOJ_KLUCZ");
s.setAttribute("data-api-url", "https://botchata.net/api");
document.body.appendChild(s);

Pamiętaj, żeby podmienić TWOJ_KLUCZ na klucz z zakładki Widget → Script. Skrypt jest przypisany do konkretnego szablonu — po zmianie szablonu graficznego trzeba go wkleić ponownie. Dlatego Metoda A jest zwykle bezpieczniejsza.

Opcjonalnie: katalog na żywo i status zamówienia

Kroki powyżej dają botowi wiedzę ze stron sklepu. Strona produktu w indeksie to jednak zdjęcie sprzed chwili, a pytania „gdzie jest moje zamówienie?” nie ma na żadnej stronie.

Dlatego BotChata ma integrację z Shoperem przez WebAPI, która robi dwie rzeczy: szuka produktów w Twoim katalogu (w czacie jako karty ze zdjęciem, nazwą, ceną i linkiem; dostępność bot podaje w odpowiedzi) i podaje klientowi status jego zamówienia.

  1. W panelu Shopera przygotuj konto administratora z dostępem do WebAPI. Jeśli zakładasz osobne konto tylko dla bota, upewnij się, że ma dostęp do WebAPI — to samo konto obsługuje katalog i zamówienia.
  2. W BotChata otwórz Integracje → Shoper i wpisz adres sklepu oraz login i hasło tego konta.

Jak bot podaje status zamówienia

Integracja (katalog i status zamówienia) jest dostępna od planu Base. Instalacja skryptu (wyżej) działa w każdym planie, także darmowym. Więcej o mechanice: chatbot do statusu zamówienia.

Krok 3 — Sprawdź, czy działa

  1. Otwórz sklep w nowym oknie incognito.
  2. W prawym dolnym rogu pojawia się dymek BotChata.
  3. Kliknij i zadaj prawdziwe pytanie klienta („Czy wysyłacie za granicę?").
  4. Bot powinien w kilka sekund odpowiedzieć treścią z Twojego sklepu.

Widzisz widżet? Jesteś online. 🎉

RODO — na co zwrócić uwagę

window.customerPrivacy.onFunctionalConsentGranted(function () {
  var s = document.createElement("script");
  s.src = "https://botchata.net/api/widget.js";
  s.setAttribute("data-api-key", "TWOJ_KLUCZ");
  s.setAttribute("data-api-url", "https://botchata.net/api");
  document.body.appendChild(s);
});

Częste problemy

ProblemRozwiązanie
Widżet się nie pojawia.Sprawdź, czy skrypt jest zapisany w Integracjach własnych i czy nie trafił do pola nagłówka zamiast stopki. Wyczyść cache przeglądarki i sprawdź w oknie incognito.
Widżet zniknął po zmianie szablonu.Użyłeś Metody B — „Własny skrypt JS" jest przypisany do konkretnego szablonu. Przenieś kod do Integracji własnych (Metoda A).
Widżet nie ładuje się do czasu kliknięcia zgody.To poprawne zachowanie, jeśli owinąłeś go w onFunctionalConsentGranted — pojawi się po akceptacji zgód funkcjonalnych.
Bot odpowiada „nie wiem".Ta podstrona może nie być zindeksowana. W BotChata sprawdź Szkolenie → Linki i zindeksuj ponownie (jedno kliknięcie).
Integracja katalogu nic nie zwraca.Sprawdź adres sklepu (z https://) oraz login i hasło administratora z dostępem do WebAPI. Przycisk Testuj połączenie sprawdza tylko, czy Shoper przyjmuje logowanie.
Bot mówi, że system zamówień jest chwilowo niedostępny.Konto WebAPI nie ma dostępu do zamówień albo sklep chwilowo nie odpowiada. Sprawdź uprawnienia konta, którego login wpisałeś w BotChata.
Widżet gryzie się z szablonem.Shadow DOM powinien temu zapobiec. Jeśli mimo to wystąpi — dostosuj pozycję/z-index w Kreatorze widżetu (od planu Business).
Odpowiada w złym języku.BotChata wykrywa język klienta automatycznie (40+ języków) — przydatne przy sprzedaży transgranicznej. Przetestuj w świeżym oknie.

Najczęstsze pytania (FAQ)

Czy potrzebuję aplikacji z Shoper Appstore? Nie. Wystarczy wkleić jeden znacznik script w Dodatki i integracje → Integracje własne. Nie ruszasz plików szablonu i nie potrzebujesz programisty.

Czy bot zna moje produkty i regulamin? Tak — indeksuje strony sklepu (produkty, kategorie, regulamin zwrotów i wysyłki, FAQ) i z nich odpowiada. Do wyszukiwania w katalogu na żywo i do statusu zamówień służy osobna integracja przez WebAPI Shopera (plan Base).

Czy bot poda klientowi status zamówienia? Tak, od planu Base — przez tę samą integrację WebAPI. Klient podaje numer zamówienia i telefon lub e-mail z zamówienia. Telefon porównywany jest po ostatnich 9 cyfrach, więc nie ma znaczenia, czy klient wpisze +48. Status, płatność (także za pobraniem), sposób dostawy i produkty bot dostaje dopiero, gdy kontakt się zgadza; imienia ani adresu nie dostaje nigdy.

Czy to zgodne z RODO? Tak. Hosting w UE (Hetzner, Niemcy), umowa powierzenia w komplecie, brak treningu AI na Twoich danych. W Shoperze pamiętaj o przypisaniu skryptu do właściwej kategorii zgód — szczegóły wyżej.

Czy bot zmyśla odpowiedzi? Nie. Odpowiada tylko z zindeksowanych treści sklepu. Jeśli zasady nie ma na stronie, mówi to wprost — nie obieca zwrotu ani wysyłki, których nie oferujesz.

Ile to kosztuje? Darmowy start kosztuje 0 € (100 wiadomości/miesiąc, bez karty). Płatne plany: Base 39 €, Business 119 €, Premium 299 €/miesiąc — stała cena za plan, bez tokenów i kredytów (cennik). (Abonament Shopera rozliczasz osobno u Shopera.)

Czy widżet spowolni sklep? Nie. Ładuje się asynchronicznie (defer) w izolowanym Shadow DOM i nie blokuje renderowania.

Zacznij teraz

Daj sklepowi Shoper asystenta AI 24/7, który zna Twoje produkty i regulamin — w 5 minut.

→ Zacznij za darmo — bez karty

Gotowe w 5 minut. 100 wiadomości/miesiąc gratis. Zgodne z RODO, hosting w UE.