Why Connect BigCommerce?
Order Tracking
Customers check order status using order numbers
Product Search
Interactive product discovery with filters and pricing
Visitor Insights
Support agents see order history and customer value in real-time
24/7 Automation
Reduce support workload with accurate, instant info
Visitor Insights for Support Agents
The BigCommerce integration enriches the Visitor Insight panel in your BubblaV dashboard, providing support agents with critical customer context during live chats:- Order History: A detailed list of current and past orders with fulfillment and payment status
- Order Tracking: Real-time tracking information including carrier, tracking numbers, and delivery status
- Product Details: View exactly which products were ordered, including images and itemized prices
- Admin Access: Direct links to view orders in your BigCommerce admin for quick management
- Refunds & Returns: View refunded amounts and the status of any active return requests
Prerequisites
- Active BigCommerce store
- Store URL (e.g.,
https://yourstore.comoryourstore.mybigcommerce.com) - BigCommerce API credentials (Access Token and Store Hash)
- Administrator access to your BigCommerce dashboard
Setup Steps
1
Navigate to Integrations
Go to Dashboard → Integrations and find the BigCommerce card
2
Click Connect
Click Connect BigCommerce to open the connection form
3
Get Your Store Hash
Your Store Hash is part of your BigCommerce store URL:
- If your store URL is
https://store-abc123.mybigcommerce.com, your store hash isstore-abc123 - You can also find it in your BigCommerce admin under Advanced Settings → API Accounts
4
Generate API Credentials
Create API credentials in your BigCommerce admin:
- Go to Advanced Settings → API Accounts
- Click Create API Account
- Enter a name (e.g., “BubblaV Integration”)
- Set the OAuth Scopes to include:
- Products: Read Only
- Orders: Read Only
- Customers: Read Only
- Click Save
- Copy the Access Token (shown only once)
5
Enter Credentials
Enter your Store URL, Store Hash, and Access Token in the connection form
6
Verify Connection
Click Connect. The BigCommerce card should now show Connected
Available Tools After Connection
| Tool | What It Does | Example Query |
|---|---|---|
bigcommerce_track_order | Track orders by number/ID | ”Track order #1001” |
bigcommerce_search_products | Search product catalog | ”Show running shoes under $50” |
bigcommerce_get_product | Get product details | ”Tell me about this product” |
bigcommerce_customer_orders | Customer order history | ”My orders for john@example.com” |
Test Your Integration
Try these queries on your website:- “Track order #1001” (use a real order number)
- “Show me your products”
- “What running shoes do you have?”
- “Check my order status”
Troubleshooting
Invalid API credentials
Invalid API credentials
- Verify that the Access Token is correct and not expired
- Ensure the API account has the correct OAuth scopes
- Check that you copied the entire Access Token
Connection fails
Connection fails
- Verify your Store URL and Store Hash are correct
- Check that your store is accessible
- Ensure your API account is active
Store Hash not found
Store Hash not found
- Your Store Hash is the subdomain part of your BigCommerce URL
- For
https://store-abc123.mybigcommerce.com, the hash isstore-abc123 - If using a custom domain, find the hash in Advanced Settings → API Accounts
Tools not working
Tools not working
- Wait a few minutes for activation
- Verify your store has orders and products
- Check that the API account still has valid permissions
Security: We use OAuth 2.0 authentication with HTTPS. Your credentials are encrypted and stored securely. We only request read permissions to access your store data.
