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. Each new cart starts a run of your cart_abandoned flow.
3. A Delay node waits, then a Cart recovery touch node sends an AI-written recovery message — in the chat widget if the visitor is still around (first touch only), otherwise by email with a one-click “Complete your checkout” link.
4. Repeat Delay + Cart recovery touch pairs for follow-ups.
5. When the customer completes the purchase, the cart is marked recovered and the run is cancelled.

​

Configuring recovery

1. Go to Dashboard → your website → Flows → New Flow.
2. Pick the Cart abandoned trigger. Optionally set quiet hours (UTC) during which no messages are sent, and max cart age — how old a cart may be before it’s ignored (default 72 hours).
3. Add a Delay node (e.g. 60 minutes), then a Cart recovery touch node. Optionally add AI 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. Add more Delay + Cart recovery touch pairs for follow-ups.
5. Use the Test panel to preview the flow, then switch it to active.

---

​

In-Chat Shopping: Cart, Checkout & 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 and your theme’s cart drawer opens. The button shows a spinner while adding, then flips to a checkmark and View cart.
• 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.

​

The AI fills the cart

Visitors can also ask in plain words: “Add the black one in size 9”, “Make it two”, “What’s in my cart?”. The AI asks which variant first if the product has several.

• On your store: the AI changes the visitor’s real cart and shows a cart card with View cart and Checkout buttons.
• On other channels and other websites (WhatsApp, Instagram, Messenger, SMS and more): the AI builds a cart and shows the lines, the total and a checkout link.

​

Checkout links and discount codes

When the visitor is ready to pay, the AI offers checkout. If they give a discount code, the AI applies it first. A code that does not apply is reported, and the cart stays as it is. On your store, the code goes onto the visitor’s cart right away, the chat shows the new total, and a Go to checkout button takes the visitor to your checkout. The visitor can also say “Apply code WELCOME10” without checking out yet. On other channels, the AI sends a checkout link.

​

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. When a visitor asks for one specific item, such as “a warm wool scarf”, the AI shows only the products that match the request, not loosely related ones. This also works when the visitor writes in another language than your product names. If the match has a choice to make, such as color or size, the visitor gets one-tap quick-reply buttons for the options. For policy and help questions, such as “What is your return policy?”, the AI searches the titles and the text of your store’s pages and blog posts. A rule that is on a different page, for example a loyalty refund rule, is found too.

​

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. Guests first confirm a 6-digit code sent to their email; see Email Verification. Without an order number, the AI answers about the visitor’s latest order, plus their latest shipped order if the latest one has no tracking yet. It shows at most two cards. To see every order, the visitor can ask “Show my orders”.

---

​

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 → Configure on the Shopify card 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

---

​

Logged-in customer recognition

When a shopper is logged in to your Shopify store, BubblaV recognizes them automatically through its Shopify app proxy. They get order status, returns and cancellations without the 6-digit email code. This works on all plans.

• Guests: shoppers who are not logged in still verify with the email code.
• Logging in mid-chat: a shopper who logs in during a chat starts a new chat. The earlier chat stays in your inbox.
• Your own identity token: if you already identify visitors with your own token, yours is used.
• App proxy path: if you changed the BubblaV app proxy path in Shopify, automatic recognition stops working.
• Permission: recognition uses Shopify’s app proxy permission. If you installed BubblaV before November 2026, Shopify asks you to approve this permission when you next open the BubblaV app in Shopify admin; recognition starts after you approve.

---

​

AI-assisted revenue

Go to Dashboard → your website → Integrations → Configure on the Shopify card and find the AI-assisted revenue card. Pick 7, 30 or 90 days. For each currency it shows the orders, the revenue, and the value of items the AI added to carts. An order counts when:

• it comes from a cart the AI built in a conversation, or
• the shopper placed it within 7 days after a chat with the AI on your store.

“From items the AI added” counts only the order lines added from the chat: by the AI, or with the Add button on a product card in the chat. The report reads your store’s order notifications, so only orders placed after the app update are included.

---

​

Chat on checkout and the Thank-you page

Shoppers can ask questions without leaving checkout. The BubblaV launcher sits in the bottom-right corner and opens the same chat as on your store.

• Thank-you page: all Shopify plans. Shoppers can ask about their new order, shipping and returns.
• Checkout pages: Shopify Plus stores only.

To turn it on:

1. In Shopify admin, go to Settings → Checkout → Customize.
2. In the page selector, choose Thank you (or Checkout on Shopify Plus).
3. Open Apps and add BubblaV checkout chat.
4. Click Save.

---

​

Available Tools After Connection

​

Email Verification

The chatbot asks visitors to verify their email with a 6-digit code before it shows order, account, or booking data. You can turn this off with the Require email verification switch in the Tools section. See Email Verification. Customers who are logged in to your store skip the code. See Logged-in customer recognition.

​

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