Skip to main content

Shopify Integration

Connect your Shopify store to enable AI-powered customer support with full e-commerce context.

Overview​

The Shopify integration provides:

  • Product Catalog - AI can search and recommend products
  • Order Management - Real-time order status and history
  • Customer Sync - Unified customer profiles
  • Cart Access - Widget sees customer cart contents
  • Inventory - Real-time stock levels

Prerequisites​

  • Shopify store (any plan)
  • Store owner or staff account with apps permission
  • Fyncall account

Step 1: Install the Fyncall App​

From Shopify App Store​

  1. Go to the Shopify App Store
  2. Search for "Fyncall"
  3. Click Add app
  4. Review permissions
  5. Click Install app

From Fyncall Dashboard​

  1. Go to Settings → Integrations → Shopify
  2. Click Connect Shopify Store
  3. Enter your store URL (e.g., mystore.myshopify.com)
  4. Click Connect
  5. Authorize the app in Shopify

Step 2: Configure Sync Settings​

Products​

SettingDescription
Sync ProductsImport product catalog
Sync VariantsInclude product variants
Sync ImagesDownload product images
CollectionsSync product collections

Orders​

SettingDescription
Sync OrdersImport order history
Order HistoryHow far back to sync
Real-time UpdatesReceive order events

Customers​

SettingDescription
Sync CustomersImport customer data
Match by EmailLink to Fyncall customers
Sync TagsImport Shopify tags

Step 3: Widget Installation​

The Shopify app can auto-install the widget:

  1. In app settings, enable Auto-install Widget
  2. The widget appears on your storefront
  3. Configure widget settings in Fyncall

Or manually add to theme (see Widget Installation).

Synced Data​

Products​

FieldSynced
Title✓
Description✓
Price✓
Compare at price✓
Images✓
Variants✓
SKU✓
Inventory✓
Collections✓
Tags✓
Status✓

Orders​

FieldSynced
Order number✓
Line items✓
Total✓
Status✓
Fulfillment✓
Tracking✓
Customer✓
Shipping address✓
Payment status✓

Customers​

FieldSynced
Name✓
Email✓
Phone✓
Addresses✓
Order count✓
Total spent✓
Tags✓
Marketing consent✓

AI Capabilities​

With Shopify connected, AI can:

Answer Product Questions​

Customer: "Do you have the blue widget in size large?"
AI: "Yes! The Blue Widget is available in Large.
     It's $49.99 and we have 15 in stock."

Check Order Status​

Customer: "Where's my order?"
AI: "I found your order #1234:
     Status: Shipped
     Tracking: 1Z999AA10123456784
     Expected: February 5th"

Process Returns​

Customer: "I want to return my order"
AI: "I can help with that. Order #1234 is eligible
     for return within our 30-day policy.
     Would you like me to start the return process?"

Recommend Products​

Customer: "What goes well with the blue widget?"
AI: [Shows product carousel with complementary items]

Widget Features​

Cart Integration​

When a customer has items in cart:

  • Widget shows cart summary
  • AI references cart contents
  • Can help complete checkout

Customer Recognition​

Logged-in Shopify customers:

  • Automatically identified in widget
  • Full order history available
  • Personalized recommendations

Webhooks​

Automatic Webhook Setup​

The app automatically registers webhooks for:

EventAction in Fyncall
orders/createSync new order
orders/updatedUpdate order status
orders/fulfilledMark as shipped
products/createAdd new product
products/updateUpdate product
customers/createCreate customer
customers/updateUpdate customer

Troubleshooting​

Products Not Syncing​

  1. Check product is published
  2. Verify product is in a sales channel
  3. Try manual sync in settings
  4. Check for API rate limits

Orders Not Appearing​

  1. Check order date is within sync range
  2. Verify order isn't cancelled/archived
  3. Check customer email matches
  4. Try manual sync

Customer Mismatch​

  1. Verify email addresses match
  2. Check phone number format (E.164)
  3. Review merge settings
  4. Manually merge if needed

Widget Not Appearing​

  1. Check app block is added to theme
  2. Verify widget is enabled in Fyncall
  3. Check store domain is configured
  4. Clear CDN cache

Best Practices​

Performance​

  • Limit initial sync to recent orders (90 days)
  • Use selective product sync if catalog is large
  • Monitor sync status regularly

Customer Experience​

  • Configure AI to know return policy
  • Set up order status tracking
  • Enable product recommendations
  • Use cart abandonment triggers

Security​

  • Review app permissions periodically
  • Monitor for unusual activity
  • Keep Shopify app updated