> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sensbot.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Podłączenie AtomStore

> Połącz sklep AtomStore z Sensbot jednym administratorem Atom REST API tylko do odczytu: chatbot, Asystent e-mail i Store Copilot na tym samym połączeniu

Sensbot łączy się ze sklepem [AtomStore](https://www.atomstore.pl) przez Atom REST API, kontem administratora tylko do odczytu. Po stronie platformy nie trzeba niczego instalować. Na tym jednym połączeniu działają trzy aplikacje:

* **Chatbot na stronie sklepu.** Odpowiada kupującym o produktach, wariantach, cenach, dostępności i statusie zamówienia, w języku strony, o każdej porze.
* **Asystent e-mail.** Do każdego maila od klienta przygotowuje wersję roboczą odpowiedzi ze statusem zamówienia, produktami, sposobem dostawy i numerem przesyłki ze sklepu. Wysyła zawsze człowiek.
* **Store Copilot.** Odpowiada na Twoje pytania o zamówienia, produkty, stany i marżę na podstawie danych sklepu. Tylko odczytuje dane i niczego w sklepie nie zmienia.

Przy rejestracji wybierasz jedną aplikację albo kilka. Każda startuje od **14 dni za darmo**, potem obowiązuje miesięczny abonament. Aktualny cennik: [sensbot.ai/pl/pricing](https://sensbot.ai/pl/pricing/).

> [!NOTE]
>
> Nie ma tu kroku w sklepie z aplikacjami. Tworzysz w panelu AtomStore jednego administratora API tylko do odczytu i wpisujesz jego login i hasło na [stronie rejestracji AtomStore](https://platform.sensbot.ai/simple/register/atomstore). W jednym kroku łączymy sklep i zakładamy Twoje konto w Sensbot. Całość zajmuje około 10 minut.

***

## Zanim zaczniesz

| Wymaganie | Po co |
| - | - |
| Login do panelu administracyjnego AtomStore z dostępem do zakładki **Ustawienia** | Tam tworzysz administratora API |
| Moduł **Atom REST API** dostępny w sklepie | Przez niego Sensbot odczytuje dane. Jeśli nie widzisz go w kroku 1, poproś BOK AtomStore o jego włączenie |
| Dla Asystenta e-mail: skrzynka Gmail, Microsoft 365, dowolna skrzynka IMAP albo helpdesk Thulium | Tam pojawiają się wersje robocze odpowiedzi |

> [!WARNING]
>
> **Konta MultiStore** (kilka witryn w jednym panelu AtomStore) nie podłączają się same przez stronę rejestracji. Napisz na [info@sensbot.ai](mailto:info@sensbot.ai), a podłączymy je ręcznie, razem z Tobą.

***

## Krok 1 · Włącz moduł Atom REST API

W panelu AtomStore otwórz **Ustawienia → Konfiguracja sklepu → API i integracje FK/ERP**. Ustaw **Atom REST API** na **włącz** i kliknij **Zapisz**.

![Strona Konfiguracja sklepu w panelu AtomStore z modułem Atom REST API ustawionym na włącz](https://mintcdn.com/sensbotai/649q2KeLAOumG4mz/images/atomstore/atomstore-rest-api-module.webp?fit=max\&auto=format\&n=649q2KeLAOumG4mz\&q=85\&s=a591a7db0f56665009ec3ed14abc164f)

Jeśli nie widzisz tej opcji, poproś BOK AtomStore o jej włączenie.

***

## Krok 2 · Utwórz pustą grupę uprawnień

Otwórz **Ustawienia → Grupy uprawnień → Dodaj nową grupę**. Nazwij grupę `Sensbot API`, nie zaznaczaj żadnego uprawnienia i kliknij **Zapisz**.

![Strona Grupy uprawnień w panelu AtomStore z nową grupą Sensbot API bez zaznaczonych uprawnień](https://mintcdn.com/sensbotai/649q2KeLAOumG4mz/images/atomstore/atomstore-permission-group.webp?fit=max\&auto=format\&n=649q2KeLAOumG4mz\&q=85\&s=c711c54d70491f9ef71a37a7c3acad7c)

Dzięki temu login Sensbot odczytuje dane przez API, ale nie otworzy panelu sklepu.

***

## Krok 3 · Utwórz osobnego administratora API

Otwórz **Ustawienia → Administratorzy → Dodaj administratora** i uzupełnij:

* **Login**: na przykład `sensbot-readonly`
* **Hasło**: silne hasło z **co najmniej 2 cyframi**. Inaczej formularz nie zapisze się i nie pokaże błędu.
* **Grupa**: `Sensbot API`
* **Dostęp do SOAP API**: `nie`
* **Dostęp do REST API**: `tak`

![Formularz Dodaj nowego administratora w panelu AtomStore z grupą Sensbot API, dostępem do SOAP API ustawionym na nie, dostępem do REST API na tak i pierwszymi zaznaczonymi metodami odczytu](https://mintcdn.com/sensbotai/649q2KeLAOumG4mz/images/atomstore/atomstore-api-administrator.webp?fit=max\&auto=format\&n=649q2KeLAOumG4mz\&q=85\&s=72e7eb7296b83c21fae0b230d349973e)

Pod **Dostęp do REST API** pojawi się lista metod. Zaznacz tylko te 16 metod odczytu:

```text theme={null}
products/index
products/get
categories/index
orders/index
orders/get
order_statuses/index
languages/index
users/index
users/get
complaints/index
complaints/get
shipping_methods/index
payment_methods/index
product_prices/index
product_quantities/index
currencies/index
```

Nie zaznaczaj żadnej metody, która coś tworzy, zmienia lub usuwa. Sensbot nigdy ich nie potrzebuje.

Niżej odznacz wszystkie statusy w polach **Zmiana statusu zamówienia przy statusie** oraz **Możliwa zmiana statusu zamówienia**. Sensbot nigdy nie zmienia statusów zamówień. Potem kliknij **Zapisz**.

![Dwa pola statusów zamówienia w formularzu administratora, wszystkie statusy odznaczone](https://mintcdn.com/sensbotai/649q2KeLAOumG4mz/images/atomstore/atomstore-order-status-fields.webp?fit=max\&auto=format\&n=649q2KeLAOumG4mz\&q=85\&s=86d6f8ff7a27638ccc0741a9db0cb757)

Pole **IP** może zostać puste. Jeśli Twój sklep ogranicza dostęp do API według adresu IP, napisz do nas po adres do dodania.

Osobny administrator oznacza, że dostęp Sensbot wyłączysz w każdej chwili, bez zmiany własnego loginu.

***

## Krok 4 · Zarejestruj sklep

Otwórz [platform.sensbot.ai/simple/register/atomstore](https://platform.sensbot.ai/simple/register/atomstore) i uzupełnij formularz:

1. Podaj adres sklepu, na przykład `twojsklep.pl`, oraz login i hasło administratora API z kroku 3. Kliknij **Sprawdź połączenie**. Pokażemy Twój sklep z liczbą produktów i zamówień, więc od razu widzisz, że to właściwy.
2. Wybierz jedną lub kilka aplikacji: **Asystent e-mail**, **Chatbot**, **Store Copilot**.
3. Podaj e-mail i ustaw własne hasło do Sensbot (co najmniej 8 znaków). To nie jest hasło do sklepu.
4. Kliknij **Załóż konto**.

Połączenie ze sklepem sprawdzamy automatycznie, gdy tylko uzupełnisz jego dane. Potem w tle importujemy produkty, kategorie i ostatnie zamówienia.

> [!NOTE]
>
> Wolisz, żebyśmy zrobili to za Ciebie? Napisz na [support@sensbot.ai](mailto:support@sensbot.ai), a podłączymy sklep razem z Tobą.

Co dalej, zależy od wybranych aplikacji:

* **Chatbot**: na kolejnym ekranie pokażemy kod czatu i opcjonalnie adres webhooka. Zobacz kroki 5 i 7.
* **Asystent e-mail**: skrzynkę podłączasz w panelu Sensbot. Zobacz krok 6.
* **Store Copilot**: w AtomStore nie trzeba niczego więcej ustawiać. Napiszemy do Ciebie w ciągu jednego dnia roboczego i razem uruchomimy pierwszą sesję.

***

## Krok 5 · Chatbot: wklej kod na stronę sklepu

Po rejestracji pokazujemy jedną linię kodu dla całego sklepu. Na każdej stronie uruchamia ona czat w języku tej strony.

1. W panelu AtomStore otwórz **Ustawienia → Konfiguracja sklepu → Wygląd sklepu → Kody marketingowe JS** i rozwiń **-własne-**.
2. Wklej kod w pole **Dodatkowy kod HTML w sekcji \<head> strony**.
3. Ustaw **Umieszczaj kody w panelu klienta** na **tak** i kliknij **Zapisz**.

![Sekcja Kody marketingowe JS w panelu AtomStore z opcją Umieszczaj kody w panelu klienta ustawioną na tak i polem kodu w sekcji head w grupie -własne-](https://mintcdn.com/sensbotai/649q2KeLAOumG4mz/images/atomstore/atomstore-marketing-js-codes.webp?fit=max\&auto=format\&n=649q2KeLAOumG4mz\&q=85\&s=214fd7fc8bb608a7e33578646385fcff)

Czat startuje w **trybie testowym**, więc klienci jeszcze go nie widzą. Gdy wszystko Ci odpowiada, zaloguj się do [panelu Sensbot](https://platform.sensbot.ai) i przełącz chatbota z **Tryb testowy** na **Opublikowane**.

> [!NOTE]
>
> Sprawdź czat w oknie prywatnym przeglądarki. Gdy jesteś zalogowany do panelu AtomStore, zewnętrzne skrypty w sklepie mogą nie działać.

***

## Krok 6 · Asystent e-mail: podłącz skrzynkę

Dopóki skrzynka nie jest podłączona, asystent nie ma czego czytać i nie przygotowuje odpowiedzi.

1. Zaloguj się do [panelu Sensbot](https://platform.sensbot.ai) i otwórz ustawienia **Email Assistant** dla swojego sklepu.
2. Kliknij **Connect Email Account** i wybierz **Gmail**, **Outlook / Microsoft 365** albo **IMAP / SMTP**.

Odpowiadasz klientom w Thulium, a nie w skrzynce? Zobacz [Thulium](https://docs.sensbot.ai/integrations/thulium.md). Skrzynki współdzielone w Microsoft 365 wymagają kilku dodatkowych ustawień: zobacz [Microsoft 365 Setup](https://docs.sensbot.ai/customization/email-assistant/outlook-addin/microsoft-365-setup.md).

Asystent domyślnie nic nie wysyła sam. Każda odpowiedź czeka w folderze **Wersje robocze** skrzynki (albo w Thulium), dopóki nie wyśle jej człowiek.

> [!NOTE]
>
> Panel Sensbot jest po angielsku, dlatego nazwy przycisków w tym kroku podajemy w oryginale.

***

## Krok 7 · Opcjonalnie: szybsze aktualizacje dzięki webhookom

Bez webhooków Sensbot sprawdza nowe zamówienia i zmiany mniej więcej co 10 minut. Z webhookami AtomStore przesyła nam nowe zamówienie, płatność lub zmianę stanu zwykle w ciągu kilku minut. Webhooki są dostępne w planach AtomStore **MAX** i **Enterprise**.

1. Po rejestracji pokazujemy Twój adres webhooka. Skopiuj go.
2. W panelu AtomStore otwórz **Ustawienia → Konfiguracja sklepu → API i integracje FK/ERP** i ustaw **Webhooki** na **włącz**.
3. Wklej adres w te pięć pól i kliknij **Zapisz**:
   * **URL dla powiadomienia o nowym zamówieniu (tylko ID)**
   * **URL dla powiadomienia o edycji zamówienia (tylko ID)**
   * **URL dla powiadomienia o zmianie statusu zamówienia**
   * **URL dla powiadomienia o opłaceniu zamówienia**
   * **URL dla powiadomienia o zmianie dostępności produktów**

![Sekcja Webhooki w panelu AtomStore z adresem Sensbot wklejonym w pięć pól: nowe zamówienie, edycja zamówienia, zmiana statusu, opłacenie zamówienia i zmiana dostępności produktów](https://mintcdn.com/sensbotai/649q2KeLAOumG4mz/images/atomstore/atomstore-webhooks.webp?fit=max\&auto=format\&n=649q2KeLAOumG4mz\&q=85\&s=86f9400a834127255f8821304b1053f5)

***

## Jak Sensbot odczytuje dane sklepu

Sensbot tylko odczytuje dane. Nigdy nie zmienia zamówienia, produktu, statusu ani ustawienia w AtomStore.

| Dane | Do czego służą |
| - | - |
| Produkty, warianty, ceny i stany magazynowe | Pytania o produkt, rozmiar lub dostępność |
| Kategorie | Kierowanie klienta do właściwej części sklepu |
| Zamówienia: numer, status, produkty, sposób dostawy, numer przesyłki | Odpowiedzi „gdzie jest moje zamówienie” w czacie i w mailach, raporty copilota |
| Klienci | Dopasowanie maila do właściwych zamówień |
| Reklamacje, których rodzaj to zwrot | Pytania o zgłoszony już zwrot. API nie udostępnia kwot zwrotów, więc Sensbot ich nie podaje |
| Języki, waluty, metody dostawy i płatności | Odpowiedzi we właściwym języku i walucie |

Nowe zamówienia i zmiany odczytujemy mniej więcej co 10 minut, a z webhookami zwykle w ciągu kilku minut.

**Języki.** Każda wersja językowa sklepu ma swojego chatbota i swojego asystenta, uruchamianych przy rejestracji. Ceny pokazujemy w walucie danego języka, na przykład w EUR na niemieckiej wersji sklepu. Jeśli dodasz język do sklepu po rejestracji, [napisz do nas](mailto:support@sensbot.ai), a dodamy go po naszej stronie.

***

## Store Copilot na AtomStore

Na AtomStore copilot działa od razu, w trybie tylko do odczytu:

* Czat i analizy o zamówieniach, produktach, stanach magazynowych i marży.
* Pulpit oraz raporty tygodniowe i miesięczne.
* Zwroty i reklamacje na podstawie modułu reklamacji AtomStore, bez kwot.

Pierwszą sesję ustawiamy razem z Tobą, na danych Twojego sklepu. Zmiany w sklepie są dostępne na życzenie.

***

## Rozwiązywanie problemów

**Sprawdzenie połączenia się nie udaje**

* Sprawdź, czy moduł **Atom REST API** jest włączony (krok 1).
* Sprawdź, czy administrator ma **Dostęp do REST API** ustawiony na `tak`. Sam **Dostęp do SOAP API** nie wystarczy.
* Sprawdź, czy zaznaczonych jest wszystkich 16 metod odczytu z kroku 3. Sprawdzenie pokazuje brakujące metody opcjonalne; bez nich wszystko działa.
* Sprawdź hasło. Jeśli formularz administratora nie zapisał się, bo hasło miało mniej niż 2 cyfry, administrator jeszcze nie istnieje.

**Czat nie pojawia się na stronie sklepu**

* Otwórz sklep w oknie prywatnym przeglądarki. Zalogowany administrator AtomStore może nie widzieć zewnętrznych skryptów.
* Czat startuje w trybie testowym. Przełącz go na **Opublikowane** w panelu Sensbot.
* Sprawdź, czy kod jest w polu head w grupie **-własne-** i czy kliknięto **Zapisz**. Jeśli widzisz starą wersję strony, wyczyść pamięć podręczną przeglądarki.

**Webhooki nie docierają**

* Webhooki są dostępne tylko w planach AtomStore MAX i Enterprise.
* Sprawdź, czy adres jest w pięciu polach z kroku 7. Przy nowym zamówieniu i edycji zamówienia użyj pól oznaczonych **(tylko ID)**, a nie pól tuż nad nimi.
* AtomStore wysyła webhooki paczkami co kilka minut, więc zmiana może dotrzeć dopiero po kilku minutach. Bez webhooków regularne sprawdzanie i tak odczyta ją w ciągu około 10 minut.

***

## Odłączenie

W AtomStore otwórz **Ustawienia → Administratorzy** i usuń administratora Sensbot albo ustaw mu **Dostęp do REST API** na `nie`. Sensbot natychmiast traci dostęp. Aby usunąć czat, skasuj kod z pola head w grupie **-własne-**. Jeśli chcesz też zamknąć konto w Sensbot, napisz na [support@sensbot.ai](mailto:support@sensbot.ai).

***

## Linki

* [Strona rejestracji AtomStore](https://platform.sensbot.ai/simple/register/atomstore)
* Sensbot dla AtomStore: [sensbot.ai/pl/atomstore](https://sensbot.ai/pl/atomstore/) (po polsku) i [sensbot.ai/atomstore](https://sensbot.ai/atomstore/) (po angielsku)
* Pytania: [support@sensbot.ai](mailto:support@sensbot.ai)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.