Skip to main content
Sensbot connects to an AtomStore 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.
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, which connects your shop and creates your Sensbot account in one go. The whole setup takes about 10 minutes.

Before you start

MultiStore accounts (several storefronts in one AtomStore panel) cannot connect themselves through the signup page. Write to 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 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 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 Under Dostęp do REST API a list of methods appears. Tick only these 16 read methods:
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 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 (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.
Rather have us do it? Write to 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 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 and switch the chatbot from Test mode to Live.
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 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. Shared mailboxes on Microsoft 365 need a little extra care: see Microsoft 365 Setup. 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, Custom instructions and Email filters.

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

How Sensbot reads your shop

Sensbot only reads. It never changes an order, a product, a status or a setting in AtomStore. 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 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 if you also want your Sensbot account closed.