Shopify

Transform your chatbot into a powerful e-commerce assistant. Customers can track orders, search products, and get instant answers about your store — while BubblaV quietly recovers abandoned carts on your behalf.

​

Why Connect Shopify?

​

Visitor Insights for Support Agents

The Shopify 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 Shopify Admin for quick management.
• Refunds & Returns: View refunded amounts and the status of any active return requests.

By having this information at their fingertips, support agents can resolve order-related questions faster and provide a more personalized experience.

​

Prerequisites

• Active Shopify store
• Store owner or staff permissions

​

Setup Steps

---

​

AI Abandoned Cart Recovery

When shoppers add items, enter their email, but don’t complete checkout, BubblaV can bring them back — automatically.

​

How it works

1. BubblaV syncs your store’s abandoned checkouts every 15 minutes.
2. After a delay you choose (default: 1 hour), the AI writes a short, friendly recovery message and sends it in the chat widget if the visitor is still around — otherwise by email with a one-click “Complete your checkout” link.
3. Optional follow-up emails (0–3, default 1) go out on your schedule, each with a one-click unsubscribe.
4. When the customer completes the purchase, the cart is marked recovered — with the revenue attributed on your dashboard.

​

Configuring recovery

1. Go to Dashboard → your website → Cart Recovery (sidebar, Chatbot section).
2. Toggle Enable cart recovery and set your timing: first-touch delay, number of follow-ups, follow-up spacing, and how old a cart may be before it’s ignored.
3. Optionally add AI tone & instructions (e.g. “Friendly and casual, mention free shipping over $50”) and a discount code the AI may offer — the code itself is created in Shopify.
4. Optionally set quiet hours (UTC) during which no messages are sent.
5. Use Preview AI message to see a sample before enabling.

The page also shows every abandoned cart with its recovery timeline, plus 30-day stats: carts abandoned, touches sent, carts recovered, revenue recovered, and recovery rate.

---

​

In-Chat Shopping: Add to Cart & Order Cards

When your Shopify store is connected, the AI Agent can close the sale inside the chat widget — visitors no longer need to leave the conversation to buy.

​

Add to cart

Product cards shown in chat include an Add button and a View button that opens the full product detail:

• On your Shopify store: the item is added to the visitor’s real storefront cart instantly (no page reload) — the button shows a spinner while adding, then flips to a checkmark and View cart so they can jump to their cart page whenever they’re ready.
• On any other website where your widget is embedded: clicking opens your store’s cart with the item pre-loaded in a new tab.

On the product detail screen inside the widget, visitors can also pick a variant (size, color — out-of-stock options are struck through) and a quantity before adding. On mobile, the browser’s back button returns from the product detail to the chat.

​

Sales-agent product search

The AI Agent searches your catalog like a knowledgeable salesperson. For broad, needs-based questions — “I need gear to stay warm on the mountain” — it runs several targeted searches at once (base layers, jackets, gloves…) and answers with one labeled product-card group per need, then recommends the best combination. Each group’s cards have Add and View buttons, so visitors can act on the recommendation immediately.

​

Order status cards

When a visitor asks “where is my order?” (with their order number and email, or just their email), the answer renders as a rich order card: payment and fulfillment status badges, the items with thumbnails, a Track shipment button, and a Buy again button that re-adds the entire order to the cart in one tap.

---

​

AI Product Recommendations

Beyond answering “what do you have?”, your chatbot can proactively recommend products as one curated, ranked product-card group — powered by the shopify_recommend_products tool.

​

What goes into a recommendation

The AI blends every available signal into a single group (default up to 6 products, max 12):

• Sales data from your store: products that pair naturally with what the visitor is viewing (related), accessories and add-ons (complementary), and close alternatives (similar).
• Bestsellers and new arrivals: your proven performers and fresh drops.
• The visitor’s live context: the page they’re on, products they’ve recently viewed, and what’s already in their open cart.
• What the visitor asks for: need-matching in their own words (“waterproof jacket under 1000 SEK”) plus stated budgets via price ranges.

The AI can also seed recommendations from the product the visitor is currently looking at, and it automatically excludes products already shown or rejected in the conversation so it never repeats itself.

​

Merchant controls

Go to Dashboard → your website → Integrations → Shopify and find the Product Recommendations section:

• Enable or disable recommendations per website.
• Group size: cap how many products appear in a recommendation group (1–12, default 6).
• Ranking signals: toggle whether bestsellers and new arrivals influence suggestions.
• Pinned products: add product handles that should always be featured in recommendations.
• Excluded products: add product handles that should never be recommended.

​

Performance stats

The same section shows rolling 7-day stats for recommendation clicks: impressions, clicks, click-through rate (CTR), and your top clicked products — so you can see which recommendations actually convert.

---

​

Return Policy Configuration

After connecting Shopify, you can configure the return policy settings for the Initiate Return tool. These settings control when customers can request returns.

​

Return Window

The Return Window specifies the maximum number of days after order placement that customers can request a return.

• Default: 30 days
• Range: 1-365 days
• Location: In the Shopify integration settings, find the Return Policy Configuration section

Example: If set to 30 days, customers can only request returns for orders placed within the last 30 days.

​

Minimum Order Age

The Minimum Order Age specifies how many hours must pass after an order is placed before a return can be requested. This prevents immediate returns right after purchase.

• Default: 0 hours (immediate returns allowed)
• Range: 0-168 hours (0-7 days)
• Location: In the Shopify integration settings, find the Return Policy Configuration section

Examples:

• 0 hours: Returns can be requested immediately after order placement
• 24 hours: Customers must wait 24 hours after placing an order before requesting a return
• 48 hours: Customers must wait 2 days before requesting a return

​

How to Configure

1. Go to Dashboard → Integrations → Shopify
2. Scroll to the Return Policy Configuration section
3. Set Return Window (days) - Maximum days after order placement to allow returns
4. Set Minimum Order Age (hours) - Minimum hours after order before returns allowed (0 = immediate)
5. Click Save Return Configuration

---

​

Available Tools After Connection

​

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?”
• “I need a gift under $50 — any suggestions?”

​

Troubleshooting