Product Sync

This document explains how to use the WooCommerce Product Synchronization feature to keep your AI Assistant updated with your product catalog.

Overview

The Product Sync feature allows you to synchronize your WooCommerce product catalog with the AI Assistant, enabling it to provide accurate product information to customers.

Features

• Manual product synchronization
• Automated sync scheduling
• Customizable product field selection
• Real-time sync status monitoring
• JSON data preview capability

Configuration

Enabling Product Sync

• Navigate to the WooCommerce Integration section
• Toggle the “Enable WooCommerce Integration” switch
• Configure your preferred sync settings

Product Data Fields

You can customize which product fields to include in the sync:

• Basic Information

– Product ID
– Product Name
– Short Description
– Full Description
– Product URL

• Pricing

– Price
– Regular Price
– Sale Price

• Inventory

– SKU
– Stock Status

• Classification

– Categories
– Tags
– Attributes

Auto-Sync Options

Choose your preferred automatic synchronization frequency:

• Disabled (Manual sync only)
• Hourly
• Twice Daily
• Daily
• Weekly

Note: For large catalogs (500+ products), weekly syncs are recommended for optimal performance.

Manual Synchronization

To manually sync your products:

• Click the “Sync Existing Products” button
• Monitor the sync progress in real-time
• Wait for confirmation of successful completion

The sync process includes:

• Collecting product data
• Formatting information
• Uploading to the Assistant API
• Updating AI instructions

Monitoring Sync Status

The system provides real-time feedback during synchronization:

• Progress Indicator: Shows percentage of completion
• Status Messages:

– Running: Sync in progress
– Completed: Successful sync
– Failed: Error occurred (with details)
– Completed with Fallback: Alternate sync method used

Data Preview

You can preview the synchronized product data:

• Click “Download Products JSON”
• Review the formatted product information
• Verify the included fields and data structure

Best Practices

• Initial Setup

– Start with a manual sync
– Verify all required product fields are selected
– Check the sync result for accuracy

• Ongoing Maintenance

– Set up auto-sync based on your update frequency
– Monitor sync status regularly
– Review and adjust field selection as needed

• Large Catalogs

– Use weekly sync schedule
– Perform manual syncs during off-peak hours
– Monitor system performance during syncs

Troubleshooting

Common issues and solutions:

• Sync Failures

– Verify WooCommerce integration is enabled
– Check system permissions
– Review error messages in sync status
– Try using manual sync

• Missing Product Information

– Verify field selection in Product Data Fields
– Check source product data in WooCommerce
– Resync after making corrections

• Performance Issues

– Reduce sync frequency for large catalogs
– Optimize product data fields selection
– Schedule syncs during off-peak hours