Shopify Integration

Connect the Fyncall widget with your Shopify store for enhanced e-commerce features.

Overview

When connected to Shopify, the widget can:

• Access customer's cart contents
• Display product information in chat
• Sync customer data automatically
• Trigger cart abandonment flows
• Show order history and status

Setup

Via Shopify App (Recommended)

1. Install the Fyncall app from the Shopify App Store
2. Authorize the connection
3. The widget is automatically installed on your store

Manual Installation

If you prefer manual setup:

1. Connect your Shopify store in Settings → Integrations → Shopify
2. Add the widget script to your theme (see Installation)
3. Enable Shopify features in Settings → Widget → Features

Cart Access

Reading Cart Data

When Shopify integration is enabled, the widget automatically:

• Detects cart changes
• Syncs cart value and items
• Makes cart data available to AI agents

The AI can then reference the customer's cart:

Customer: "What's in my cart?"
AI: "You have 2 items in your cart:
     - Blue Widget (x1) - $29.99
     - Red Gadget (x2) - $39.98
     Total: $69.97"

Cart Operations

The widget can perform cart operations through the chat:

Operation	Example
View cart	"Show me my cart"
Add item	"Add the large blue widget"
Remove item	"Remove the red gadget"
Update quantity	"Change blue widget to 2"
Apply discount	"Use code SAVE10"

These operations use Shopify's Cart API and are reflected on the store immediately.

Customer Sync

Automatic Identification

When a customer logs into your Shopify store:

1. Customer data is automatically synced
2. Chat history is linked to their account
3. Previous conversations are available

Synced Data

Field	Description
Email	Primary identifier
Name	First and last name
Phone	If available
Order count	Total orders placed
Total spent	Lifetime value
Tags	Shopify customer tags

Product Information

Product Cards

AI can send rich product cards in chat:

// Example product card data
{
  "type": "product_carousel",
  "products": [
    {
      "id": "gid://shopify/Product/123",
      "title": "Premium Widget",
      "price": "$99.99",
      "image": "https://...",
      "url": "/products/premium-widget"
    }
  ]
}

Product Search

Customers can search for products:

Customer: "Do you have any blue widgets?"
AI: "We have 3 blue widgets available:"
[Product Carousel: Blue Widget Small, Blue Widget Medium, Blue Widget Large]

Order Tracking

Order Status Cards

Display order tracking in chat:

Customer: "Where is my order?"
AI: "I found your recent order:"
[Order Card:
 Order #1234
 Status: Shipped
 Tracking: 1Z999AA10123456784
 Expected: Feb 5, 2026]

Order Lookup

The widget can look up orders by:

• Order number
• Customer email
• Most recent order

Cart Abandonment

Exit Intent Triggers

Detect when a customer is about to leave with items in cart:

Trigger: Exit intent + Cart value > $50
Message: "Wait! Don't forget your items.
         Need help completing your order?"

See Proactive Engagement for setup.

Recovery Flows

When a customer returns to an abandoned cart:

1. Widget can open automatically
2. Show cart summary
3. Offer assistance or discount

Configuration

Enable Features

In Settings → Widget → Features:

Feature	Description
Cart Access	Read customer cart data
Cart Operations	Allow cart modifications
Product Cards	Display product information
Order Lookup	Look up order status
Customer Sync	Sync Shopify customer data

Permissions

The Shopify integration requires these permissions:

Scope	Purpose
read_products	Product information
read_orders	Order lookup
read_customers	Customer data
read_checkouts	Cart access
write_checkouts	Cart operations

Troubleshooting

Cart Not Syncing

1. Verify Shopify integration is connected
2. Check that cart features are enabled
3. Ensure the widget script is on the page
4. Try refreshing the page

Customer Not Identified

1. Customer must be logged into Shopify
2. Check customer sync is enabled
3. Verify the email matches between systems

Product Cards Not Showing

1. Ensure product catalog is synced
2. Check product has images and pricing
3. Verify the product is published