Konradodocs

Connect Base.com

Connect your Base.com store, so your live chat finds a shopper's order and your products join the Knowledge Base.

Base.com
E-commerce
Order tracking and product answers from your Base.com store

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

PartUsed byWhat it does
Order lookupYour live chatFinds the one order the shopper asks about, with its status, items, payment, delivery, parcels, invoices and returns
Order notesYour live chat, only the agents you chooseAdds a note for your team to the shopper's own order, after the shopper approves it in the chat
Product catalogEvery agent, through the Knowledge BaseYour 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 detailWhat Konrado reads
OrderStatus, order source, order and confirmation dates, currency, the items with quantities and prices, the customer's own note
PaymentPayment method, cash on delivery, amount paid and the payment history
DeliveryDelivery method and price, the address or pickup point
ParcelsCourier, tracking number and tracking link
InvoicesInvoice number, issue date and gross amount
ReturnsReturn 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.

  1. Konrado finds the order with the order lookup: the order number and the e-mail or phone on it.
  2. 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.
  3. 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:40

The 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:

CheckWhen it fails
The order was found with the lookup in this conversationKonrado looks the order up first
The order has no parcel yetNo card. Konrado says the order already has a parcel and points the shopper to your shop
At most 2 notes per conversationNo card. Konrado hands over to your team
Your Base.com account has an order extra field named KonradoNo 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:

ImportedDetails
Products and descriptionsName, category path, manufacturer, SKU, EAN, weight, dimensions, descriptions and features, in the catalog's default language
Variants and sizesEvery variant with its own SKU, EAN, price and availability
Prices and availabilityThe 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 possibleWhy
Edit, cancel or refund an order, or change its statusKonrado 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 phoneBoth 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 fileKonrado gives the invoice number, date and amount. The shopper gets the document from your shop
Read courier tracking codesKonrado gives the tracking number and link instead of guessing where the parcel is
Show exact stock, purchase costs, suppliers or warehouse placesThe catalog serves a public chat, so only fields for shoppers are imported
Show internal order comments, commissions, refund bank accounts or invoice billing addressesKonrado drops these fields as it reads an order, and it never reads the seller comment
Import a catalog with more than 10,000 productsThe sync refuses to write half a catalog, and the stored copy stays as it was
Security model

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:

PurposeMethods
Connection test and status namesgetOrderStatusList
Order lookupgetOrders, getOrdersByPhone, getOrderPackages, getOrderPaymentsHistory, getInvoices, getOrderReturns
Order notesgetOrders, getOrderPackages, getOrderExtraFields, setOrderFields
Product cataloggetInventories, getInventoryProductsList, getInventoryProductsData, getInventoryCategories, getInventoryManufacturers, getInventoryPriceGroups
Catalog settingsgetExternalStoragesList

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
setOrderFields

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

Example ticket questions
  • "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).

The Base.com Add API token dialog with a name and the Read permission

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 confirming the new API token, masked, with its copy icon

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.

The Base.com API tab listing the new token with its permissions

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.

The Base.com form: the hint about the token's permissions, the Installation guide link, Integration Name and 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.

The Base.com Tools tab: Find orders, which reads, and Add a note to an order, which changes data, both for customers who give the order number and the e-mail or phone

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

  1. Open Workspace SettingsKnowledge Base, click Add source and choose Products.
  2. 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:

SettingWhat it does
Catalogs to importThe 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 addressOptional, WooCommerce shops only. Each product links to its page in your shop. Changing it imports the whole catalog again, once
ShopShown 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:

PartSet it to
EventOrder extra field edited (Edytowano pole dodatkowe zamówienia), field Konrado
Condition, optionalOrder status (Status zamówienia), to act only in some statuses
ActionsAnything 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 seeWhat to do
Base.com turns Not working and says to check that the API token still existsThe 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 tokenCheck that you copied the whole token and that it still exists under My account › API in Base.com
API rate limit exceededBase.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 outTry again later. If it goes on, check the Base.com service status
A method is refusedOn 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 noteThe 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 shopCreate the order extra field named Konrado
Your automatic action does not run after a noteThe 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 tokenA 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 shopsThe 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.comA 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 orderAsk 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 answerCheck the order in Base.com. Konrado says a detail is unavailable when Base.com cannot return it
The catalog was not importedA catalog with more than 10,000 products is not imported, and the stored copy stays as it was
Prices or stock are out of dateThe catalog syncs every night. A change in Base.com shows after the next sync

Remove the integration

  1. Remove the Product catalog source from the Knowledge Base, if you added it.
  2. Open Workspace SettingsIntegrations, open the Base.com row menu (...) and click Delete.
  3. In Base.com, delete the token under My account › API.

Last updated on

On this page