Documentation

Shopping Carts

The Shopping Carts page lets you view and manage customer shopping carts. Access it from Admin > Shopping Carts in your admin panel.


See It in Action

Watch the AI shopping assistant handle a full shopping experience:


Overview

When customers interact with your AI assistant, they can add products to a shopping cart through natural conversation. The cart persists across sessions, so customers can start shopping in one conversation and complete checkout in another.

Key capabilities:

  • Add, remove, and update items through chat or voice
  • Cart persists across conversations and sessions
  • Integrates with Shopify or external checkout systems
  • Full voice support for hands-free shopping

Settings

Configure shopping cart behavior in your tenant settings under E-commerce.

Enable Shopping Cart

Toggle to enable or disable the cart feature:

  • Enabled: AI can help customers manage their cart and checkout
  • Disabled: Cart functionality is not available

Checkout Method

MethodDescription
ShopifyCreates a Shopify draft order with invoice URL for payment
WebhookPosts order data to your external system
DisabledCart available but checkout not enabled

Cart Expiration

SettingDefaultDescription
Abandoned Cart Days7Days of inactivity before marking cart as abandoned
Cart Expiration Days30Days before expired carts are cleaned up

How Carts Work

From Text Chat

  1. Customer asks about a product or says "add to cart"
  2. AI searches your catalog and finds matching products
  3. AI confirms the item and quantity with the customer
  4. Item is added to cart with an inline cart display
  5. Customer can continue shopping or proceed to checkout
  6. At checkout, contact info is collected and order is submitted

Example conversation:

Customer: "I'd like to order some vitamin D"
AI: "I found Vitamin D3 5000 IU for $24.99. How many would you like?"
Customer: "Two bottles please"
AI: "Added 2 bottles of Vitamin D3 to your cart. Your subtotal is $49.98. Anything else?"
Customer: "That's all, I'd like to checkout"
AI: [Shows contact form, then submits order]
AI: "Order submitted! Check your email for the checkout link to complete payment."

From Voice Chat

Voice interactions are fully conversational:

  1. Customer describes what they want
  2. AI finds products and confirms details verbally
  3. Customer confirms with voice ("yes", "add it", etc.)
  4. AI updates cart and confirms totals
  5. At checkout, AI collects contact info by voice:
    • Asks for email and spells it back for confirmation
    • Confirms name and phone
    • Submits order after final confirmation

Example voice flow:

Customer: "Add omega-3 to my cart"
AI: "I found Omega-3 Fish Oil, 120 softgels, for $34.99. Should I add one to your cart?"
Customer: "Yes"
AI: "Added. Your cart now has $34.99. Would you like anything else?"
Customer: "No, let's checkout"
AI: "I'll need your contact info. What's your email address?"
Customer: "john@example.com"
AI: "That's j-o-h-n at example dot com, correct?"
Customer: "Yes"
AI: "And your name?"
...

Cart Persistence

Carts are per-user, not per-conversation. This means:

BehaviorDescription
Cross-sessionCustomer can close chat and return later — cart is preserved
Cross-deviceIf customer logs in on another device, same cart
Guest usersGuest users also have persistent carts tied to their browser session
One active cartEach customer has at most one active cart per tenant

Example: Cross-Conversation Shopping

Monday:
  Customer: "Add vitamin D to my cart"
  AI: [adds item] "Added. Your subtotal is $24.99"
  [Customer closes chat]

Wednesday:
  Customer: "What's in my cart?"
  AI: "You have 1 item: Vitamin D3 ($24.99)"
  Customer: "Add omega-3 too"
  AI: [adds item] "Your subtotal is now $59.98"

Cart Lifecycle

A cart moves through these stages:

  1. Created — Customer adds their first item
  2. Active — Customer continues shopping or leaves items for later
  3. Converted — Customer completes checkout (becomes an order)
  4. Abandoned — No activity for 7 days (configurable)
  5. Expired — Cleaned up after 30 days of inactivity

Cart Statuses

StatusDescription
ActiveCurrent cart, can be modified. One per customer
ConvertedOrder submitted successfully. Customer can start a new cart
AbandonedNo activity for configured period (default: 7 days)
ExpiredMarked for cleanup after retention period

Admin Page

Page Header

  • Title: "Shopping Carts"
  • Active Count: Shows number of active carts
  • Refresh Button: Reload the cart list

Cart List

Each cart card displays:

ElementDescription
CustomerName or email (or "Guest" for anonymous users)
ItemsNumber of items in cart
SubtotalTotal value of cart
StatusCurrent cart status with color coding
Last ActivityHow long since last update

Filtering

Search: Find carts by customer name or email

Status Filter:

  • All Status
  • Active
  • Converted
  • Abandoned

Cart Detail View

Click any cart to see full details:

Customer Information

  • Name, email, phone (if collected)
  • User type (registered or guest)

Cart Contents

  • Product name and variant
  • Quantity and unit price
  • Line total for each item
  • Cart subtotal

Timeline

  • Created date
  • Last activity date
  • Converted date (if applicable)

Linked Order

  • If converted, link to the resulting order/draft order

Checkout Integration

Shopify Checkout

When Shopify is connected:

  1. Cart is converted to a Shopify Draft Order
  2. Draft order includes all line items with prices
  3. Customer receives invoice URL for payment
  4. Payment is processed through Shopify's checkout
  5. Order syncs back to your Shopify admin

External Checkout (Webhook)

If you're not using Shopify, orders can be sent to your own system:

  1. Order details are sent to your checkout system
  2. Your system processes the order and sends a payment link
  3. Customer completes payment on your website

This option requires technical setup — contact support for integration details.


Cart Actions

From the Admin Panel

ActionDescription
ViewSee full cart contents and customer info
ExportDownload cart data (coming soon)

Automatic Actions

TriggerAction
No activity (7 days)Cart marked as abandoned
Abandoned (30 days)Cart marked as expired and cleaned up
Checkout completeCart marked as converted, linked to order

Analytics

Track cart performance:

MetricDescription
Active CartsNumber of customers with items in cart
Conversion RatePercentage of carts that become orders
Average Cart ValueMean subtotal of active carts
Abandonment RatePercentage of carts abandoned

Best Practices

Reducing Cart Abandonment

  1. Follow up on abandoned carts — Review abandoned carts and consider reaching out
  2. Streamline checkout — Ensure checkout flow is quick and frictionless
  3. Clear pricing — Make sure product prices are accurate and up-to-date

Optimizing the Shopping Experience

  1. Keep catalog updated — Sync products regularly so AI has current inventory
  2. Train on common requests — Add product synonyms and common phrasings to your knowledge base
  3. Test voice checkout — Verify the hands-free flow works smoothly for your products

Managing Guest Carts

  • Guest carts persist by browser session
  • Encourage account creation for cross-device persistence
  • Guest carts convert to user carts if customer provides email at checkout

Troubleshooting

"Cart not found" errors

  • Customer may be on a different device than where they added items
  • Guest session may have expired
  • Check if cart was converted or abandoned

Items not adding to cart

  • Verify products are in your catalog with valid prices
  • Check that e-commerce features are enabled in your account settings

Checkout not completing

  • Verify Shopify connection or webhook URL is configured
  • Check that contact collection is working
  • Review error logs for API failures

Related Pages