> ## 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.

# AtomStore Setup

> Connect your AtomStore shop to Sensbot with one read-only Atom REST API administrator: chatbot, Email Assistant and Store Copilot, all from the same connection

Sensbot connects to an [AtomStore](https://www.atomstore.pl) shop through the Atom REST API, with one administrator account that can only read. Nothing is installed on the platform side. With that one connection you can run any of three apps:

* **Chatbot on your shop page.** Answers shoppers about products, variants, prices, stock and order status, in the language of the page, at any hour.
* **Email Assistant.** Writes a draft reply to every customer e-mail, with the order status, items, delivery method and tracking number from your shop. A person always reads and sends it.
* **Store Copilot.** Answers your own questions about orders, products, stock and margin from your shop data. It only reads and changes nothing in your shop.

You choose one app or several when you register. Each starts with **14 days free**, then a monthly plan. Current plans are at [sensbot.ai/pricing](https://sensbot.ai/pricing/).

> [!NOTE]
>
> There is no app store step. You create one read-only API administrator in your AtomStore panel and enter its login and password on the [AtomStore signup page](https://platform.sensbot.ai/simple/register/atomstore), which connects your shop and creates your Sensbot account in one go. The whole setup takes about 10 minutes.

***

## Before you start

| Requirement | Why |
| - | - |
| A login to your AtomStore admin panel with access to **Ustawienia** | You create the API administrator there |
| The **Atom REST API** module available in your shop | Sensbot reads your data through it. If you do not see it in step 1, ask AtomStore support (BOK) to turn it on |
| For the Email Assistant: a support mailbox on Gmail, Microsoft 365 or any IMAP host, or Thulium | This is where the drafts appear |

> [!WARNING]
>
> **MultiStore accounts** (several storefronts in one AtomStore panel) cannot connect themselves through the signup page. Write to [info@sensbot.ai](mailto:info@sensbot.ai) and we connect them by hand, together with you.

***

## Step 1 · Turn on the Atom REST API module

In your AtomStore panel open **Ustawienia → Konfiguracja sklepu → API i integracje FK/ERP**. Set **Atom REST API** to **włącz** and click **Zapisz**.

![The AtomStore Konfiguracja sklepu page with the Atom REST API row set to włącz](https://mintcdn.com/sensbotai/649q2KeLAOumG4mz/images/atomstore/atomstore-rest-api-module.webp?fit=max\&auto=format\&n=649q2KeLAOumG4mz\&q=85\&s=a591a7db0f56665009ec3ed14abc164f)

If you do not see this option, ask AtomStore support (BOK) to turn it on for your shop.

***

## Step 2 · Create an empty permission group

Open **Ustawienia → Grupy uprawnień → Dodaj nową grupę**. Name the group `Sensbot API`, leave every box unticked and click **Zapisz**.

![The AtomStore Grupy uprawnień page with a new group named Sensbot API and no permissions ticked](https://mintcdn.com/sensbotai/649q2KeLAOumG4mz/images/atomstore/atomstore-permission-group.webp?fit=max\&auto=format\&n=649q2KeLAOumG4mz\&q=85\&s=c711c54d70491f9ef71a37a7c3acad7c)

The Sensbot login can then read data through the API but cannot open your admin panel.

***

## Step 3 · Create a separate API administrator

Open **Ustawienia → Administratorzy → Dodaj administratora** and fill in:

* **Login**: for example `sensbot-readonly`
* **Hasło** (password): a strong password with **at least two digits**. With fewer digits the form does not save and shows no error.
* **Grupa**: `Sensbot API`
* **Dostęp do SOAP API**: `nie`
* **Dostęp do REST API**: `tak`

![The AtomStore Dodaj nowego administratora form with the Sensbot API group, SOAP access set to nie, REST access set to tak and the first read methods ticked](https://mintcdn.com/sensbotai/649q2KeLAOumG4mz/images/atomstore/atomstore-api-administrator.webp?fit=max\&auto=format\&n=649q2KeLAOumG4mz\&q=85\&s=72e7eb7296b83c21fae0b230d349973e)

Under **Dostęp do REST API** a list of methods appears. Tick only these 16 read methods:

```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
```

Do not tick any method that creates, updates or deletes anything. Sensbot never needs them.

Further down, untick every order status in **Zmiana statusu zamówienia przy statusie** and in **Możliwa zmiana statusu zamówienia**. Sensbot never changes order statuses. Then click **Zapisz**.

![The two order status fields on the administrator form with every status unticked](https://mintcdn.com/sensbotai/649q2KeLAOumG4mz/images/atomstore/atomstore-order-status-fields.webp?fit=max\&auto=format\&n=649q2KeLAOumG4mz\&q=85\&s=86d6f8ff7a27638ccc0741a9db0cb757)

The **IP** field can stay empty. If your shop limits API access by IP address, write to us for the address to add.

A separate administrator means you can turn off Sensbot's access at any time without touching your own login.

***

## Step 4 · Register on the signup page

Open [platform.sensbot.ai/simple/register/atomstore](https://platform.sensbot.ai/simple/register/atomstore) (Polish, with an English switch at the top) and fill in:

1. Your shop address, for example `yourshop.pl`, and the login and password of the API administrator from step 3. Click **Check connection**. We show your shop with its number of products and orders, so you know it is the right one.
2. Choose one or more apps: **Email Assistant**, **Chatbot**, **Store Copilot**.
3. Enter your e-mail and choose your own Sensbot password (at least 8 characters). This is not your shop password.
4. Click **Create my account**.

The connection is checked automatically once the shop details are filled in. We then import your products, categories and recent orders in the background.

> [!NOTE]
>
> Rather have us do it? Write to [support@sensbot.ai](mailto:support@sensbot.ai) and we connect the shop with you.

What comes next depends on the apps you chose:

* **Chatbot**: the next screen shows your chat code and, optionally, a webhook address. See steps 5 and 7.
* **Email Assistant**: you connect your mailbox from the Sensbot dashboard. See step 6.
* **Store Copilot**: nothing more to set up in AtomStore. We write to you within one working day and set up your first session together.

***

## Step 5 · Chatbot: add the code to your shop page

After registration we show one line of code for your whole shop. On every page it starts the chat in that page's language.

1. In your AtomStore panel open **Ustawienia → Konfiguracja sklepu → Wygląd sklepu → Kody marketingowe JS** and expand **-własne-**.
2. Paste the code into **Dodatkowy kod HTML w sekcji \<head> strony**.
3. Set **Umieszczaj kody w panelu klienta** to **tak** and click **Zapisz**.

![The AtomStore Kody marketingowe JS section with Umieszczaj kody w panelu klienta set to tak and the -własne- head code field](https://mintcdn.com/sensbotai/649q2KeLAOumG4mz/images/atomstore/atomstore-marketing-js-codes.webp?fit=max\&auto=format\&n=649q2KeLAOumG4mz\&q=85\&s=214fd7fc8bb608a7e33578646385fcff)

The chat starts in **test mode**, so your visitors do not see it yet. When you are happy with it, log in to the [Sensbot dashboard](https://platform.sensbot.ai) and switch the chatbot from **Test mode** to **Live**.

> [!NOTE]
>
> Check the chat in a private browser window. While you are logged in to the AtomStore panel, outside scripts on your shop may not work.

***

## Step 6 · Email Assistant: connect your mailbox

Until a mailbox is attached, the assistant has nothing to read and writes no drafts.

1. Log in to the [Sensbot dashboard](https://platform.sensbot.ai) and open the **Email Assistant** settings for your shop.
2. Click **Connect Email Account** and choose **Gmail**, **Outlook / Microsoft 365** or **IMAP / SMTP**.

Answering customers in Thulium rather than in a mailbox? See [Thulium](https://docs.sensbot.ai/integrations/thulium.md). Shared mailboxes on Microsoft 365 need a little extra care: see [Microsoft 365 Setup](https://docs.sensbot.ai/customization/email-assistant/outlook-addin/microsoft-365-setup.md).

The assistant never sends on its own. Every reply waits in your **Drafts** folder (or in Thulium) until a person sends it. Shape it further with [Writing style](https://docs.sensbot.ai/customization/email-assistant/writing-style.md), [Custom instructions](https://docs.sensbot.ai/customization/email-assistant/custom-instructions.md) and [Email filters](https://docs.sensbot.ai/customization/email-assistant/email-filters.md).

***

## Step 7 · Optional: faster updates with webhooks

Without webhooks Sensbot checks for new orders and changes about every 10 minutes. With webhooks AtomStore sends us a new order, a payment or a stock change, usually within a few minutes. Webhooks are part of the AtomStore **MAX** and **Enterprise** plans.

1. After registration we show your webhook address. Copy it.
2. In your AtomStore panel open **Ustawienia → Konfiguracja sklepu → API i integracje FK/ERP** and set **Webhooki** to **włącz**.
3. Paste the address into these five fields, then click **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**

![The AtomStore Webhooki section with the Sensbot address pasted into the five fields for new order, order edit, status change, order paid and availability change](https://mintcdn.com/sensbotai/649q2KeLAOumG4mz/images/atomstore/atomstore-webhooks.webp?fit=max\&auto=format\&n=649q2KeLAOumG4mz\&q=85\&s=86f9400a834127255f8821304b1053f5)

***

## How Sensbot reads your shop

Sensbot only reads. It never changes an order, a product, a status or a setting in AtomStore.

| Data | Used for |
| - | - |
| Products, variants, prices and stock | Questions about a product, a size or availability |
| Categories | Pointing customers to the right part of your shop |
| Orders: number, status, items, delivery method, tracking number | "Where is my order" answers in chat and e-mail drafts, copilot reports |
| Customers | Matching an e-mail to the right orders |
| Complaints whose kind is a return | Questions about a return already filed. Refund amounts are not available through the API, so Sensbot never states them |
| Languages, currencies, shipping and payment methods | Answers in the right language and currency |

New orders and changes are read about every 10 minutes, or within a few minutes with webhooks.

**Languages.** Each language of your shop gets its own chatbot and its own assistant, set up at registration. Prices are shown in that language's own currency, for example EUR on a German storefront. If you add a language to your shop after registering, [contact us](mailto:support@sensbot.ai) and we add it.

***

## Store Copilot on AtomStore

The Store Copilot works on AtomStore from day one in read-only mode:

* Chat and analysis about orders, products, stock and margin.
* The dashboard and weekly and monthly reports.
* Returns and complaints from the AtomStore complaints module, without amounts.

We set up your first session together with you, on your own shop data. Changes to the shop are available on request.

***

## Troubleshooting

**The connection check fails**

* Check that the **Atom REST API** module is on (step 1).
* Check that **Dostęp do REST API** is `tak` on the administrator. **Dostęp do SOAP API** alone is not enough.
* Check that all 16 read methods from step 3 are ticked. The check lists any optional method that is missing; everything works without those.
* Check the password. If the administrator form did not save because the password had fewer than two digits, the administrator does not exist yet.

**The chatbot does not show on the shop page**

* Open the shop in a private browser window. A logged-in AtomStore admin may not see outside scripts.
* The chat starts in test mode. Switch it to **Live** in the Sensbot dashboard.
* Check that the code is in the **-własne-** head field and that you clicked **Zapisz**. Clear your browser cache if an old page is shown.

**Webhooks do not arrive**

* Webhooks are part of the AtomStore MAX and Enterprise plans only.
* Check that the address is in the five fields from step 7. For a new order and an order edit, use the fields marked **(tylko ID)**, not the fields just above them.
* AtomStore sends webhooks in batches every few minutes, so a change can take a few minutes to arrive. Without webhooks the regular check still picks it up within about 10 minutes.

***

## Disconnecting

In AtomStore open **Ustawienia → Administratorzy** and delete the Sensbot administrator, or set **Dostęp do REST API** to `nie` on it. Sensbot loses access immediately. To remove the chat, delete the code from the **-własne-** head field. Write to [support@sensbot.ai](mailto:support@sensbot.ai) if you also want your Sensbot account closed.

***

## Links

* [AtomStore signup page](https://platform.sensbot.ai/simple/register/atomstore)
* Sensbot for AtomStore: [sensbot.ai/atomstore](https://sensbot.ai/atomstore/) (English) and [sensbot.ai/pl/atomstore](https://sensbot.ai/pl/atomstore/) (Polish)
* Questions: [support@sensbot.ai](mailto:support@sensbot.ai)


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