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)
- Sklep na Shoper (dowolny abonament) z dostępem do panelu administracyjnego.
- Konto BotChata — wystarczy darmowy start (rejestracja przez e-mail, bez karty płatniczej).
- 5 minut. Bez kodu, bez programisty.
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.

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.

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.

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.

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

<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
- W panelu Shopera przejdź do Dodatki i integracje → Integracje własne.
- Znajdź pole na skrypty w stopce (kod wykonywany przed zamknięciem
</body>). - Wklej skopiowany fragment BotChata na końcu tego pola — razem ze znacznikami
<script>…</script>, bo pole przyjmuje kod HTML. - 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_KLUCZna 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.
- W panelu Shopera zarejestruj aplikację dla swojego sklepu i odbierz Client ID oraz Client secret (dostęp do zasobu
products). - 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
- Otwórz sklep w nowym oknie incognito.
- W prawym dolnym rogu pojawia się dymek BotChata.
- Kliknij i zadaj prawdziwe pytanie klienta („Czy wysyłacie za granicę?").
- Bot powinien w kilka sekund odpowiedzieć treścią z Twojego sklepu.
Widzisz widżet? Jesteś online. 🎉
RODO — na co zwrócić uwagę
- Hosting w UE: BotChata działa na serwerach Hetzner w Niemczech; dane nie opuszczają UE bez zgody, i nie ma treningu AI na Twoich danych.
- Powierzenie przetwarzania: podpisz z BotChata umowę powierzenia (wzór dostępny na koncie) i wymień narzędzie w polityce prywatności.
- Kategoria zgód w Shoperze: Shoper ma własny widżet zgód z kategoriami Niezbędne / Analityczne / Marketingowe / Funkcjonalne. Skrypt nieprzypisany do żadnej kategorii trafia domyślnie do „Niezbędnych" — a chat to funkcja dodatkowa, nie techniczna konieczność. Przypisz go do kategorii funkcjonalnej, opakowując wywołanie:
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);
});
- EU AI Act: klient widzi przed pierwszym czatem, że rozmawia z AI — obowiązek przejrzystości z art. 50 (od sierpnia 2026) jest spełniony domyślnie.
Częste problemy
| Problem | Rozwią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.