Why Connect WooCommerce?
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 WooCommerce 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 WooCommerce admin for quick management
- Refunds & Returns: View refunded amounts and the status of any active return requests
Prerequisites
- Active WooCommerce store (WordPress with WooCommerce plugin)
- Store URL (e.g.,
https://yourstore.com) - WooCommerce REST API credentials (Consumer Key and Secret)
- Administrator access to your WordPress dashboard
Setup Steps
1
Navigate to Integrations
Go to Dashboard → Integrations and find the WooCommerce card
2
Click Connect
Click Connect WooCommerce to open the connection form
3
Enter Store URL
Enter your WooCommerce store URL (e.g.,
https://yourstore.com)4
Generate API Credentials
You’ll need to create API credentials in your WooCommerce admin:
- Go to WooCommerce → Settings → Advanced → REST API
- Click Add Key
- Enter a description (e.g., “BubblaV Integration”)
- Select Read permissions
- Click Generate API Key
- Copy the Consumer Key and Consumer Secret
5
Enter API Credentials
Paste the Consumer Key and Consumer Secret into the connection form
6
Verify Connection
Click Connect. The WooCommerce card should now show Connected
Available Tools After Connection
| Tool | What It Does | Example Query |
|---|---|---|
woocommerce_track_order | Track orders by number/ID | ”Track order #1001” |
woocommerce_search_products | Search product catalog | ”Show running shoes under $50” |
woocommerce_get_product | Get product details | ”Tell me about this product” |
woocommerce_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 Consumer Key and Secret are correct
- Ensure the API key has Read permissions
- Check that the API key is not expired
- Make sure you copied the entire key (it may be long)
Connection fails
Connection fails
- Verify your store URL is correct and accessible
- Check that your WooCommerce REST API is enabled
- Ensure your WordPress permalink structure is set to “Post name”
- Try disabling security plugins temporarily to test
Tools not working
Tools not working
- Wait a few minutes for activation
- Verify your store has orders and products
- Check that the API key still has valid permissions
OAuth signature errors
OAuth signature errors
- This integration uses OAuth 1.0a for authentication
- Ensure your server’s time is synchronized
- Check that Consumer Key and Secret haven’t been regenerated
Security: We use OAuth 1.0a authentication with HTTPS. Your credentials are encrypted and stored securely. We only request read permissions to access your store data.
