Connect Base.com
Connect your Base.com store, so your live chat finds a shopper's order and your products join the Knowledge Base.
With Base.com connected, your live chat finds a shopper's order and answers about its status, parcels, payments, invoices and returns. Your product catalog can join the Knowledge Base, so every agent answers about products, prices and availability. Konrado calls the Base.com API with one token. Nothing is installed in your store.
Base.com was called BaseLinker. The API still runs on api.baselinker.com, and the Base.com
panel may show Polish labels. This page gives both the English and the Polish names.
What Konrado does with Base.com
| Part | Used by | What it does |
|---|---|---|
| Order lookup | Your live chat | Finds the one order the shopper asks about, with its status, items, payment, delivery, parcels, invoices and returns |
| Order notes | Your live chat, only the agents you choose | Adds a note for your team to the shopper's own order, after the shopper approves it in the chat |
| Product catalog | Every agent, through the Knowledge Base | Your products, variants, prices and availability, synced every night |
Ticket replies never call Base.com, but they use the product catalog, because it is part of the Knowledge Base. Your organization has one Base.com connection.
Order lookup
The chat's tool is base_find_orders. The shopper gives an order number and the e-mail
address or phone number they ordered with. Konrado shows the order only when both match the same
order.
| Order detail | What Konrado reads |
|---|---|
| Order | Status, order source, order and confirmation dates, currency, the items with quantities and prices, the customer's own note |
| Payment | Payment method, cash on delivery, amount paid and the payment history |
| Delivery | Delivery method and price, the address or pickup point |
| Parcels | Courier, tracking number and tracking link |
| Invoices | Invoice number, issue date and gross amount |
| Returns | Return status, date, reason and refunded amount |
The order number can be the Base.com order ID, your shop's own number, or a marketplace number such as Allegro or Amazon. Orders not confirmed yet count too, so a shopper can check a payment right after checkout.
Each detail loads on its own. If Base.com cannot return the invoices, Konrado still answers about the parcel and says it could not check the invoice.
Order notes
When a shopper wants to change something they chose at checkout, such as a size or a print text,
Konrado can add a note for your team to their order. The tool is
base_add_to_order_konrado_note. It is Off until you choose the agents that may use it, in
the Tools tab of the Base.com connection.
The note goes to an order extra field named Konrado, which you create once in Base.com.
Without it, Konrado adds no notes. Go to Orders › Settings › Extra fields
(Zamówienia › Ustawienia › Pola dodatkowe) and click Add extra field (Dodaj
pole dodatkowe). Name it Konrado, choose Text field (Pole tekstowe) and the Orders
(Zamówienia) range. Use this field for nothing else.
- Konrado finds the order with the order lookup: the order number and the e-mail or phone on it.
- It writes one sentence about the request, in the language of the chat, and shows it to the shopper on a card with Approve and Decline.
- After Approve, Konrado adds the note. After Decline, nothing is written.
Each note goes to the start of the Konrado field, newest first, separated by |. The date
after it is in your organization's Timezone, set under
Workspace SettingsSettings, or in UTC, marked UTC, when none is set:
The customer asked to change the size from L to M. - 2026-10-02 11:12 | The customer asked for a gift box. - 2026-10-01 19:40The field keeps the newest notes that fit in 200 characters. Konrado never writes to the seller comment (Uwagi) or to anything else on the order.
Konrado checks the order before it shows the card, and again right before it writes:
| Check | When it fails |
|---|---|
| The order was found with the lookup in this conversation | Konrado looks the order up first |
| The order has no parcel yet | No card. Konrado says the order already has a parcel and points the shopper to your shop |
| At most 2 notes per conversation | No card. Konrado hands over to your team |
| Your Base.com account has an order extra field named Konrado | No card. Konrado points the shopper to your shop |
Your team applies the change. Konrado never edits products, prices, the address or the order status. In the Tools tab you can also turn off the approval card for an agent. The note is then written at once, and every check above still runs.
Product catalog
Once Base.com is connected, you can add its catalog to the Knowledge Base. Konrado reads your Base.com catalogs (inventories) and keeps one document per product:
| Imported | Details |
|---|---|
| Products and descriptions | Name, category path, manufacturer, SKU, EAN, weight, dimensions, descriptions and features, in the catalog's default language |
| Variants and sizes | Every variant with its own SKU, EAN, price and availability |
| Prices and availability | The gross price from the default price group, with the VAT rate. Stock shows only as in stock or out of stock |
Every catalog is imported unless you choose some in the source's settings, for example to leave out a test or wholesale catalog. For a WooCommerce shop you can add the shop address, and every product then links to its page in your shop.
The catalog syncs every night. Prices and availability are a snapshot of the last sync, and Konrado presents them that way. Products with zero stock are still imported and marked out of stock, so Konrado can say "yes, but not right now" instead of "we do not sell that".
What Konrado cannot do
| Not possible | Why |
|---|---|
| Edit, cancel or refund an order, or change its status | Konrado only adds approved notes. Your team, or your own Base.com automatic actions, apply the change |
| Find an order from its number alone, or list the orders of an e-mail or phone | Both the number and the contact must match one order, so nobody can use the chat to find other orders |
| Send, attach or link an invoice file | Konrado gives the invoice number, date and amount. The shopper gets the document from your shop |
| Read courier tracking codes | Konrado gives the tracking number and link instead of guessing where the parcel is |
| Show exact stock, purchase costs, suppliers or warehouse places | The catalog serves a public chat, so only fields for shoppers are imported |
| Show internal order comments, commissions, refund bank accounts or invoice billing addresses | Konrado drops these fields as it reads an order, and it never reads the seller comment |
| Import a catalog with more than 10,000 products | The sync refuses to write half a catalog, and the stored copy stays as it was |
Create a Base.com API token for Konrado alone, and never share your Base.com password. A
Read (Odczyt) token covers the order lookup and the product catalog. Order notes also
need getOrderExtraFields and setOrderFields: choose Selected methods (Wybrane
metody) with the methods below. After you save the token, Konrado shows only its ending.
The order lookup serves anonymous visitors, so it protects each order like this:
- An order shows only when it carries the quoted number and its own e-mail address or phone number matches what the visitor typed. A phone number needs at least 9 digits. A country prefix is fine.
- A failed lookup gets the same answer for "no such order" and "not your order", so the chat never confirms that an order number exists.
- After 3 failed lookups in one conversation, the lookup stops and Konrado points the visitor to your team.
- An order result does not carry over into later turns of the conversation.
- Konrado reads only a fixed list of order and product fields and drops the rest.
Konrado calls these Base.com API methods. setOrderFields is the only one that writes, and only to
add a note the shopper approved:
| Purpose | Methods |
|---|---|
| Connection test and status names | getOrderStatusList |
| Order lookup | getOrders, getOrdersByPhone, getOrderPackages, getOrderPaymentsHistory, getInvoices, getOrderReturns |
| Order notes | getOrders, getOrderPackages, getOrderExtraFields, setOrderFields |
| Product catalog | getInventories, getInventoryProductsList, getInventoryProductsData, getInventoryCategories, getInventoryManufacturers, getInventoryPriceGroups |
| Catalog settings | getExternalStoragesList |
Give access to these methods only
Without order notes, Read (Odczyt) is the simplest safe choice, and it covers every read method in your account. Full (Pełny) also works, but it lets the token change anything in your account. With order notes, or to give less than full read access, choose Selected methods (Wybrane metody) when you create the token and tick exactly these 16 methods:
getOrders
getOrdersByPhone
getOrderPackages
getOrderPaymentsHistory
getInvoices
getOrderReturns
getOrderStatusList
getInventories
getInventoryProductsList
getInventoryProductsData
getInventoryCategories
getInventoryManufacturers
getInventoryPriceGroups
getExternalStoragesList
getOrderExtraFields
setOrderFieldsLeave out the catalog methods if you only want order lookups, and leave out
getOrderExtraFields and setOrderFields if you do not use order notes. Tick Base.com methods
only: base_find_orders and base_add_to_order_konrado_note are the names of Konrado's chat
tools, and Base.com refuses them with Invalid API method (Nieprawidłowa metoda API).
A Selected methods token has to keep up with Konrado. If a later version of Konrado reads something new, a missing method shows as an error on the connection or on the Knowledge Base source. A Read (Odczyt) token needs no such upkeep.
- "Where is my package? My order number is 12345678 and I ordered with anna@example.com."
- "Did you receive my payment for order 1024? My phone number is +48 601 234 567."
- "Has the invoice for my Allegro order been issued yet?"
- "What is the status of my return, and has the refund been sent?"
- "Do you have the Nova city sneakers in size 42, and how much do they cost?"
- "Is the Breeze rain jacket in stock?"
Before you start
- An owner or admin account in Konrado.
- A Base.com account with access to My account › API.
- For order lookups, the live chat on your website: install the chat.
Create a Base.com API token
Add the token
In the Base.com panel, open the account menu in the top right corner and choose My account
(Moje konto). Open the API tab and click Add API token (Dodaj Token API). Enter a
Name (Nazwa) such as Konrado.
Under API permissions (Uprawnienia API), choose Read (Odczyt) for order lookups and the catalog. To use order notes too, choose Selected methods (Wybrane metody) and tick the 16 methods. Click Save (Zapisz).

Copy the token
Base.com confirms that the token was created. Click the copy icon next to the masked token and keep the value in a password manager.

Base.com shows the token only once. If you lose it, delete it in Base.com and create a new one. Never paste the token into a ticket, a screenshot or a document.
Check the token list
The token appears in the API tokens (Tokeny API) table with its permissions. The API call logs (Logi wywołań API) below it show each method Konrado calls.

Connect Base.com
Fill in the form
Open Workspace SettingsIntegrations, click Add integration, choose
E-commerce, then Base.com. Enter an Integration Name, such as Main store, and paste
the token into API Token.

Test and connect
Click Test Connection. A good test shows Connected successfully!. Click Connect.
Choose who may add notes
The Tools tab lists the two tools. Once Base.com is connected, Find orders
(base_find_orders) is open to every agent, and Add a note to an order
(base_add_to_order_konrado_note) shows Off until you click it and choose agents. Its Ask
the customer to approve switch starts on. Turning it off asks you to confirm with Turn off
approval.

Check it works
Base.com shows Connected in the table. In your live chat, ask about a real order with its number and the e-mail on it: Konrado answers with the order's status.
To test the connection later, open the row menu (...), click Manage, then Test Connection. The token field shows only the token's ending. Click Replace only to change the token.
Add the product catalog
- Open Workspace SettingsKnowledge Base, click Add source and choose Products.
- Under Your platforms, click Base.com, then Add catalog.
If Base.com sits under Connect a platform with a Connect button, it is not connected yet. After the first sync, the source shows in the list as Product catalog, with the number of products. Open it to browse them on the Contents tab. The Settings tab holds:
| Setting | What it does |
|---|---|
| Catalogs to import | The Base.com catalogs Konrado imports. All of them to start with. Once you change the list, a catalog created later in Base.com is imported only after you add it here |
| Shop address | Optional, WooCommerce shops only. Each product links to its page in your shop. Changing it imports the whole catalog again, once |
| Shop | Shown when several shops are connected to your Base.com account, so products link to the right one |
Act on order notes in Base.com
Konrado does not run your order workflow. To act on a note at once, for example to add a 0 PLN product line, e-mail the shopper or change the status, build an automatic action in your own Base.com panel. Nothing is set in Konrado.
Base.com starts automatic actions when an order extra field changes through the API, so every note in the Konrado field can start one within seconds. Go to Orders › Automatic actions (Zamówienia › Automatyczne akcje) and add one:
| Part | Set it to |
|---|---|
| Event | Order extra field edited (Edytowano pole dodatkowe zamówienia), field Konrado |
| Condition, optional | Order status (Status zamówienia), to act only in some statuses |
| Actions | Anything Base.com offers, such as Add product to order (Dodaj produkt do zamówienia), Send e-mail (Wyślij e-mail) or Change status (Zmień status) |
Only Konrado writes the Konrado field, so the event alone means a new note.
If something is wrong
| What you see | What to do |
|---|---|
| Base.com turns Not working and says to check that the API token still exists | The token was deleted, or its Base.com account is suspended or expired. Create a new token, open the row menu (...), click Manage or Reconnect, then Replace the token |
| Base.com refused the API token | Check that you copied the whole token and that it still exists under My account › API in Base.com |
| API rate limit exceeded | Base.com allows 100 requests per minute per account, shared by every tool that uses your tokens. Konrado spaces its requests, but other busy integrations can still reach the limit. Pause them, or wait a moment and test again |
| The Base.com API cannot be reached, or the request timed out | Try again later. If it goes on, check the Base.com service status |
| A method is refused | On a Selected methods (Wybrane metody) token, tick every method: 16 with order notes, 14 without |
| Konrado says the order system could not be reached when a shopper asks for a note | The token cannot read or write the order fields. A Read (Odczyt) token cannot add notes: tick getOrderExtraFields and setOrderFields under Selected methods (Wybrane metody) |
| Konrado says it cannot add notes for your shop | Create the order extra field named Konrado |
| Your automatic action does not run after a note | The extra field must be named Konrado, be a Text field with the Orders range, and the action's event must be Order extra field edited for that field |
| Base.com shows Invalid API method (Nieprawidłowa metoda API) when you save the token | A name in Methods (Metody) is not a Base.com method. Remove base_find_orders, a Konrado tool name, and tick the methods |
| The catalog settings cannot load your catalogs and shops | The token is refused or Base.com cannot be reached. Test the connection in Integrations, then open the settings again |
| The chosen catalogs no longer exist in Base.com | A deleted or re-created catalog is not imported, and the stored copy stays as it was. Choose the catalogs again in the source's settings |
| The chat cannot find an order | Ask for the exact order number and the e-mail or phone on that order. After 3 failed lookups, Konrado points the shopper to your team |
| An invoice or parcel is missing in the answer | Check the order in Base.com. Konrado says a detail is unavailable when Base.com cannot return it |
| The catalog was not imported | A catalog with more than 10,000 products is not imported, and the stored copy stays as it was |
| Prices or stock are out of date | The catalog syncs every night. A change in Base.com shows after the next sync |
Remove the integration
- Remove the Product catalog source from the Knowledge Base, if you added it.
- Open Workspace SettingsIntegrations, open the Base.com row menu (...) and click Delete.
- In Base.com, delete the token under My account › API.
Last updated on