Overview
Product Sync uploads your WooCommerce product catalog to your chatbot’s knowledge base (your OpenAI vector store), so the chatbot can answer product questions, recommend products and show product cards.
The AI instructions for using product data are managed automatically by the plugin. They handle missing fields, product variations, recorded prices and stock, and only recommend products based on the synced catalog. You don’t need to write product instructions yourself.
Enabling Product Sync
- Go to WPiko AI Chatbot → AI & Training → AI Settings → Model & Knowledge.
- In the Train AI assistant section, click WooCommerce.
- Turn on Use WooCommerce data in the chatbot.
- In Product catalog → Product data, click Choose fields and tick the fields to include.
- Click Sync now for the first sync.
Product Data Fields
Choose which fields are included in the sync:
- Basic information: Product name, Product ID, SKU, Product URL
- Pricing and stock: Price, Regular price, Sale price, Stock status
- Descriptions: Short description, Full description
- Classification: Categories, Tags, Attributes (e.g. Color, Size, Material)
Your choices save as soon as you tick or untick a field, and apply on the next sync. Include Product URL so the chatbot can link to products, and Price and Stock status if you want it to answer price and availability questions. Full descriptions make the product file much larger, so they’re off by default.
Auto-Sync
Choose how often the catalog is synced automatically: Off (manual only), Hourly, Twice daily, Daily or Weekly.
For catalogs with 500+ products, weekly is recommended. For very large catalogs, or if WP-Cron is unreliable on your host, use WP-CLI with a server cron job instead.
Sync Now and Status
Click Sync now at any time. The sync collects your products, builds one products file, uploads it to OpenAI and replaces the previous products file. Progress is shown while it runs, followed by the result: completed, completed with the fallback method, or failed (with the error, which is also written to the Debug Log).
Synced files are listed under Synced product files, where you can review and delete them.
Data Preview
Under Preview, click Download products JSON to see exactly what is sent. This doesn’t change what the chatbot knows.
What About Orders?
Orders are not synced. Since version 2.1.0 the chatbot looks orders up live in WooCommerce when a customer asks. See Order Assistance.
Troubleshooting
- Sync fails: check that Use WooCommerce data in the chatbot is on and your Pro license is active, then look at the error in the sync status and in Advanced → Debug Log.
- Missing product information: check the field selection, check the product in WooCommerce, then sync again.
- Times out on large catalogs: use the WP-CLI command
wp wpiko-chatbot sync products. - Chatbot gives old prices: click Sync now, or increase the Auto-sync frequency.
