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. Na ekranie Add a new site wpisz nazwę sklepu i jego adres URL, a potem kliknij Add & start indexing. Indeksowanie rusza automatycznie.

Dodanie nowej strony — 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 zakładce Links widzisz każdą zebraną podstronę ze statusem Indexed — poczekaj, aż sklep pokaże Ready.

Zakładka Links — 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 Add link i wybierz 🌐 Full site lub 📄 Single page.

Dodanie źródła — cała witryna albo pojedyncza podstrona

Krok 3: Szybki test

Przejdź do zakładki Overview 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 Overview — podgląd czatu na żywo

Krok 4: Skopiuj kod do osadzenia

Otwórz zakładkę Widget agenta i przejdź do sekcji Script. Skopiuj fragment obok napisu Embed code:

Widget → Script — kod do osadzenia z przyciskiem Copy

<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: wyszukiwanie w katalogu na żywo

Kroki powyżej dają botowi wiedzę ze stron sklepu — regulaminu, opisów, FAQ. To pokrywa większość pytań obsługowych, ale strona produktu w indeksie to zdjęcie sprzed chwili, nie stan z tej sekundy.

Dlatego BotChata ma osobną integrację z Shoperem przez REST API: bot szuka wtedy produktów bezpośrednio w Twoim katalogu — po nazwie, z ceną i dostępnością prosto z API sklepu, i pokazuje je klientowi jako karty produktów.

  1. W panelu Shopera zarejestruj aplikację dla swojego sklepu i odbierz Client ID oraz Client secret (dostęp do zasobu products).
  2. W BotChata otwórz Integracje → Shoper i wpisz adres sklepu, Client ID i Client secret.

Integracja jest dostępna od planu Business. Instalacja skryptu (wyżej) działa w każdym planie, także darmowym — większość sklepów zaczyna od skryptu i dokłada integrację później.

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ź zakładkę Links i zindeksuj ponownie (jedno kliknięcie).
Integracja katalogu nic nie zwraca.Sprawdź, czy aplikacja w Shoperze ma prawo odczytu zasobu products i czy adres sklepu jest wpisany z https://.
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 służy integracja przez REST API Shopera (wyżej).

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 29 €, Business 89 €, Premium 249 €/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.