BigCommerce store connection
Connect BigCommerce products, customers and orders to INSIDE and support eligible additions to the shopper's basket.
What it is
BigCommerce supplies products, customer matches and orders to INSIDE. Operators can use this information in conversations. Eligible product cards can also add a selected variant to the visitor's own shopping basket.
Who uses it and why
Administrators with Settings or Developer connect the store and grant its API permissions. Operators find products and private records. Visitors choose supported product variants and access verified order information.
Where to find it
Open Settings › Commerce › Commerce Providers and choose BigCommerce as Provider type. Connection administration needs Settings with the relevant AI access, or Developer.
How it works
INSIDE validates the store connection and checks which product, customer and order reads are available. Catalogue search uses the store's available filters. Dynamic Storefront filters use an explicit Storefront token or a private token generated from the Management API credentials.
Exact customer and guest-order email matches are checked against returned records. Related private order information is read only after the applicable ownership check. An order header can remain visible even when line items cannot be loaded.
Before offering a native basket action, product detail loads variants and checks modifiers. Required or unchecked modifiers prevent that action. The shopper can use the product page instead.
Configure it
Create the provider, enter Store hash and Management API access token, and optionally supply Client ID and Storefront URL. Use a Management API account with read-only access to Information & Settings, Products, Customers and Orders. Dynamic filters also need Modify access to Storefront API Tokens for automatic token generation.
Normally, leave Storefront API token override blank. Supply it only when an explicit override is needed. Remove the saved Storefront API token removes a previous override.
Select Use for operations, set Availability, save and use test. Configure product panel replacement and visitor access separately. Store sign-in requires an app-level Current Customer integration; the store-level Management API token cannot identify a shopper.
Fields
| Field | Where | Required | What it is for |
|---|---|---|---|
| Store hash | Settings › Commerce › Commerce Providers | Yes | Identifies the BigCommerce store. Use letters and numbers only. |
| Client ID | Settings › Commerce › Commerce Providers | No | Optionally identifies the Management API account. Its client secret is not used here. |
| Storefront URL | Settings › Commerce › Commerce Providers | No | Supplies the public HTTPS shopping address for product links. Store information can fill it automatically. |
| Management API access token | Settings › Commerce › Commerce Providers | No | Authenticates store reads. Required for a new store; leave blank to keep the token for the same store. |
| Storefront API token override | Settings › Commerce › Commerce Providers | No | Optionally supplies a Storefront token instead of automatic private token generation. |
| Remove the saved Storefront API token | Settings › Commerce › Commerce Providers | No | Removes the explicit Storefront token override so automatic token generation can be used. |
Permissions
| Permission | Lets you |
|---|---|
| Settings | Configure BigCommerce, subject to AI access and View Only. |
| AI | Allows commerce administration for a restricted Settings role. |
| Developer | Configure the BigCommerce commerce provider. |
Limits and good to know
- Product and private search pages contain up to 50 results. The operator Products panel requests 20 products at a time.
- Missing Storefront token permissions can reduce the filters available. Basic catalogue filters can remain usable.
- Basic category and brand filter choices can be cached for six hours.
- Products with required modifiers cannot use the native basket action.
- Pre-order and explicit availability information take priority over stock-count estimates.
- Commerce reads do not change orders or issue refunds. Adding to a basket is a separate action in the shopper's browser.
Depends on and works with
+1 more · this feature uses
- Add to cart from product cardsEnhances
Eligible products can be added to the shopper's own storefront basket.
View all connections as a list
This feature uses
- Roles and permissionsConfigured by
Roles control connection administration.
- Commerce provider setup and selectionRequires
BigCommerce is configured as a provider with selected operations and availability.
- Product search and filtersEnhances
Supplies product search and available catalogue filters.
- Product options and variant selectionEnhances
Supplies variants and checks required product modifiers before basket actions.
- Store customer matches and ordersEnhances
Supplies customer and order information in CRM.
- AI customer and order searchEnhances
Supports private customer and order searches.
- Customer and order accessConfigured by
Visitor order matching and Current Customer sign-in require separate access configuration.
- Store order details and historyEnhances
Supplies authorised order details and history.
- Add to cart from product cardsEnhances
Eligible products can be added to the shopper's own storefront basket.
Used by
- Commerce provider setup and selectionEnhances
Supplies the BigCommerce provider option.
- Product search and filtersEnhances
BigCommerce supplies catalogue search and available store filters.
- Product options and variant selectionEnhances
BigCommerce supplies variants and checks modifiers before native basket actions.
- Store customer matches and ordersEnhances
BigCommerce can supply store customer records and orders.
- AI customer and order searchEnhances
BigCommerce supplies customer name search and order search by exact order number or email.
- Customer and order accessEnhances
BigCommerce supports guest matching and customer sign-in through an app integration.
- Store order details and historyEnhances
Supplies BigCommerce order information.
- Add to cart from product cardsEnhances
BigCommerce supports finding or creating the shopper's basket and adding a line.
FAQ and troubleshooting
Why do products work but dynamic filters do not?
Check the Management API account's Storefront API Tokens permission, or the explicit Storefront API token override. Some basic filters may remain available without dynamic Storefront filtering.
Why is a token required again after changing Store hash?
A different store needs its own Management API credentials. INSIDE does not reuse the previous store's token.
Why does a product have no basket action?
It may have required modifiers, incomplete options or no available variant. Open its product page to complete the store's purchase choices.
Why can I see an order total but no products?
The order header can load even if the store's related line-item read fails. Refresh the customer information and check the connection's order permissions.