Connect your BigCommerce store to your ChatLab chatbot. Once connected, the chatbot searches your products, indexes the whole catalog for AI Search, lets customers add products to the cart from the chat and checks the status of their orders directly in your store.
Example conversation
Check an order
Requires a connected store and its enabled order action. Available fields depend on the integration. Matching an email address is not proof of identity.
Visitor: Where is my order?
Play the example or read it below. No real customer data is used.The customer asks about an existing order.
Playback pauses when this example leaves the screen. This is a simulation, not a live chat. Widget controls inside the playback are not interactive.Read the complete example
- The customer asks about an existing order.
Visitor: Where is my order?
- The default lookup needs both identifiers.
Assistant: Please give me your order number and the email address used at checkout.
- Use fictional data in this example.
Visitor: 41982, anna@example.com
- The action queries the connected store.
Checking order 41982...
- Report only information returned by the store.
Assistant: Order 41982 is marked as shipped. The carrier is DPD. Please check the tracking page for delivery updates.
The example illustrates the customer experience. The available actions and returned information depend on this integration and your configuration.
Important: e-commerce best practices
After you finish the integration below, read the detailed guide on optimising your chatbot for e-commerce: How to set up ChatLab for your e-commerce store
What the integration provides
AI product search - Customers describe what they need in their own words and the chatbot finds matching products in your catalog. The answer contains:
- Product name and description
- Current price in your store currency, and for products on sale also the regular price
- Product image
- Direct link to the product page in your store
- Availability, SKU, brand, categories and product options (sizes, colours) when the product has them
Product search by phrase - A simple keyword search in your BigCommerce catalog. AI product search replaces it automatically once the catalog is indexed.
Order status - The customer gives the order number and the e-mail address used at checkout, and the chatbot answers with the order status, the ordered items, the totals and the tracking details when the order has been shipped. Orders are always matched against the customer's e-mail, so a guessed order number never reveals someone else's order.
Add to cart - Product cards in the chat can show an Add to cart button. On your BigCommerce storefront the button puts the product straight into the customer's cart and the cart counter in the page header updates. For products with options such as size or colour, the customer first picks the variant in the chat. For products with options the chat cannot fill in (for example a required text field for an engraving), the button opens the product page.
Chat widget on your storefront - ChatLab adds the chat widget to your storefront for you through the BigCommerce Script Manager, so there is no code to paste.
See the cart experience
For a cart example and storefront testing instructions, see Adding products to the cart. The sequence below is illustrative; it does not execute a real BigCommerce cart operation.
Choose a variant before adding to cart
Illustrative sequence: actual cart buttons and variant pickers depend on the platform and storefront. This playback does not execute a cart operation.
Emerald wrap dress, $79. Viscose, midi length.
Play the example or read it below. No real customer data is used.Search results provide a product card with a cart control on supported stores.
Playback pauses when this example leaves the screen. This is a simulation, not a live chat. Widget controls inside the playback are not interactive.Read the complete example
- Search results provide a product card with a cart control on supported stores.
Emerald wrap dress, $79. Viscose, midi length.
- The customer chooses a product and size using the supported cart controls.
Visitor: Emerald wrap dress, size 38.
- Only confirm success after the storefront accepts the cart operation.
Assistant: Example result: the selected variant has been added to your store cart.
- Payment and checkout remain in the store.
Assistant: Review your cart in the store to confirm quantity, price and delivery, then proceed to checkout.
What the integration does not provide
- Checkout in the chat. The customer completes the purchase in your BigCommerce store.
- Live stock alerts. Prices and availability are read from BigCommerce when the chatbot answers, but the chatbot does not notify customers about later changes.
- Add to cart on headless storefronts. The cart button works on storefronts built on BigCommerce themes. On a headless storefront it opens the product page instead, and the chat widget has to be added to that site by hand.
Requirements
- A BigCommerce store where you are the store owner or a user allowed to install apps or create API accounts.
- The BigCommerce integration included in your ChatLab plan.
- For AI product search: AI Search capacity assigned to the chatbot large enough for your visible products. Check the available capacity in Shop > Products.
- No other store integration connected to the same chatbot.
Choose one of the two ways below. Both lead to the same result.
Option A: Install the ChatLab app
- In your BigCommerce control panel go to Apps, find ChatLab and click Install.
- Review the permissions and click Confirm. ChatLab asks for read-only access to products, orders, customers and store information, and for access to storefront content to add its chat widget.
- The ChatLab page opens inside your control panel. Click Continue setup. The ChatLab onboarding opens in a new browser tab.
- Sign in to your ChatLab account, or create one if you do not have it yet.
- Choose an existing chatbot or create a new one for this store.
That is all. ChatLab connects the store to the chosen chatbot, switches on the product search and order status actions, starts indexing your catalog and adds the chat widget to your storefront. You can open ChatLab again at any time from the Apps menu of your control panel.
Uninstalling the app in BigCommerce switches the integration off in ChatLab and removes the chat widget from your storefront. Your chatbot and its conversations stay in your ChatLab account.
Option B: Connect with a store-level API account
Use this option when you prefer to create the access yourself, or when you want to connect a chatbot without installing the app.
Step 1: Create the API account in BigCommerce
- In your BigCommerce control panel go to Settings, then Store-level API accounts.
- Click Create API account and give it a name, for example ChatLab.
- Set the permissions:
- Products - read-only
- Orders - read-only
- Customers - read-only
- Information & settings - read-only
- Content - modify
- Click Save. BigCommerce shows the credentials once and downloads them as a text file.
- Copy the API path and the Access token.
The API path looks like api.bigcommerce.com/stores/abc123/v3/. The part between stores/ and /v3/ is your store hash.
Keep the access token private. You can revoke it at any time by deleting the API account in BigCommerce.
Step 2: Connect the store in ChatLab
- Open your chatbot in ChatLab and go to Shop.
- Click the BigCommerce tile.
- Paste the API path (or just the store hash) into Store hash or API path and the token into Access token.
- Click Check connection. ChatLab reads the store profile and shows the store name, the storefront address and the currency.
- Click Connect.
ChatLab tests the connection and switches on the product search and order status actions. When AI Search capacity is assigned to the chatbot, the catalog indexing starts right away and the confirmation window tells you so. The same window tells you whether the chat widget was added to your storefront. The access token is stored encrypted and is never shown again; leave the token field empty when you only want to update the connection.
Configure the actions
Go to Settings > AI Actions. Three actions are available for BigCommerce:
- BigCommerce - AI product search - semantic search over the indexed catalog. In its settings you can include the full product card in the answer, limit results to products in stock and enable the Add to cart button.
- BigCommerce - product search - keyword search in the BigCommerce catalog, used when AI Search is not available for the chatbot. It can also be limited to products in stock and show the Add to cart button.
- BigCommerce - order details - order status lookup. Rate limiting and masking of personal data are available in the action settings.
Every action has an editable prompt and an action label shown in the chat while the chatbot is working.
Check the catalog
Open Training > E-commerce catalog to follow the indexing progress, browse the indexed products and retrain the catalog after larger changes in the store. Products that are not visible in your store are not indexed.
Products without a description are indexed by name, brand, categories and attributes only. If your products have no descriptions in BigCommerce, adding even a short one noticeably improves the search results.
When you also train the chatbot on your website pages, ChatLab recognises a BigCommerce store and skips product, category and brand pages. Product data comes from the catalog, so it does not have to be read from the pages a second time.
The chat widget on your storefront
When the store is connected through the app, or through an API account with modify access to Content, ChatLab adds the widget for you. You can see it in Storefront > Script Manager as ChatLab chatbot. It is placed in the footer of all storefront pages, in the Functional consent category, and it is removed when you disconnect the store.
If the API account was created without Content access, either create a new API account with that access and connect again, or add the widget yourself:
- In ChatLab, open your chatbot, go to Test & Deploy, choose BigCommerce and copy the code.
- In your BigCommerce control panel, go to Storefront > Script Manager.
- Click Create a Script and give it a name, for example ChatLab.
- Set Placement to Footer, Location to Storefront pages and Script category to Functional.
- Choose Script type Script and paste the code into Script contents.
- Click Save and refresh your storefront. The chatbot appears in the bottom corner of every page.
Troubleshooting
- "Failed to connect to the BigCommerce store. Check the store hash and the access token." - The token was copied incompletely, the API account was deleted, or the store hash belongs to a different store. Copy both values again from the file BigCommerce downloaded when the API account was created.
- The chat widget was not added automatically - The API account has no modify access to Content. Create a new API account with that access and connect again, or add the widget in the Script Manager as described above.
- The chatbot does not appear on the storefront - Check that the script is listed in Storefront > Script Manager. If your store uses a cookie consent banner, the widget loads after the visitor accepts the Functional category.
- The chatbot finds no products - Check the indexing status in Training > E-commerce catalog and make sure the products are visible in your store.
- The order is not found - The chatbot needs the e-mail address used at checkout together with the order number shown in the confirmation e-mail.
- Add to cart opens the product page - The product has a required option that cannot be chosen in the chat, such as a text field, or the chatbot is running outside your BigCommerce storefront.