WooCommerce Integration

Connect your WooCommerce store to provide AI-powered support with e-commerce context.

Overview

The WooCommerce integration provides:

• Product catalog synchronization
• Order status and history
• Customer data sync
• Real-time updates via webhooks

Prerequisites

• WordPress site with WooCommerce
• WooCommerce REST API enabled
• Admin access to create API keys
• HTTPS enabled (required for webhooks)

Step 1: Generate API Keys

Create API Credentials

1. Log in to WordPress Admin
2. Go to WooCommerce → Settings → Advanced → REST API
3. Click Add key
4. Fill in details:
   • Description: "Fyncall Integration"
   • User: Select admin user
   • Permissions: Read/Write
5. Click Generate API key
6. Copy the Consumer Key and Consumer Secret

caution

Save the Consumer Secret immediately! It won't be shown again.

Step 2: Connect in Fyncall

1. Go to Settings → Integrations → WooCommerce
2. Click Connect WooCommerce
3. Enter your details:
   • Store URL: https://yourstore.com
   • Consumer Key: ck_xxxx...
   • Consumer Secret: cs_xxxx...
4. Click Connect
5. Verify connection status

Step 3: Configure Webhooks

Automatic Setup

Fyncall can create webhooks automatically:

1. In integration settings, click Configure Webhooks
2. Fyncall will create necessary webhooks
3. Verify webhooks in WooCommerce settings

Manual Setup

If automatic setup fails:

1. Go to WooCommerce → Settings → Advanced → Webhooks
2. Create webhooks for each event:

Name	Topic	Delivery URL
Order Created	order.created	https://api.fyncall.com/api/v1/webhooks/woocommerce
Order Updated	order.updated	https://api.fyncall.com/api/v1/webhooks/woocommerce
Product Created	product.created	https://api.fyncall.com/api/v1/webhooks/woocommerce
Product Updated	product.updated	https://api.fyncall.com/api/v1/webhooks/woocommerce
Customer Created	customer.created	https://api.fyncall.com/api/v1/webhooks/woocommerce
Customer Updated	customer.updated	https://api.fyncall.com/api/v1/webhooks/woocommerce

Step 4: Configure Sync

Products

Setting	Description
Sync Products	Import product catalog
Include Variations	Sync variable products
Product Status	Published only, or include drafts
Categories	Sync product categories

Orders

Setting	Description
Sync Orders	Import order data
Order Statuses	Which statuses to sync
History Limit	How far back to import

Customers

Setting	Description
Sync Customers	Import customer data
Guest Orders	Include guest customers
Match by Email	Link to existing customers

Synced Data

Products

Field	Synced
Name	✓
Description	✓
Short description	✓
Regular price	✓
Sale price	✓
Images	✓
Categories	✓
Tags	✓
SKU	✓
Stock status	✓
Stock quantity	✓
Attributes	✓
Variations	✓

Orders

Field	Synced
Order ID	✓
Order number	✓
Status	✓
Date created	✓
Total	✓
Line items	✓
Shipping	✓
Billing address	✓
Payment method	✓
Customer note	✓

Customers

Field	Synced
Email	✓
First name	✓
Last name	✓
Billing address	✓
Shipping address	✓
Username	✓

AI Capabilities

With WooCommerce connected:

Product Lookup

Customer: "Is the premium widget in stock?"
AI: "Yes, the Premium Widget is in stock.
     We have 23 available. Price: $79.99"

Order Tracking

Customer: "What's the status of order 5678?"
AI: "Order #5678 is currently being processed.
     Items: Premium Widget (x1), Basic Widget (x2)
     Total: $189.97"

Customer History

Customer: "What did I order last time?"
AI: "Your last order was #5432 on January 15th:
     - Deluxe Widget Pack ($149.99)
     - Express Shipping ($9.99)"

Widget Installation

Manual Installation

Add the widget script to your theme:

1. Edit footer.php or use a plugin
2. Add the script before </body>

<script async src="https://cdn.fyncall.com/widget/loader.js"
        data-fyncall-widget="fw_your_widget_id"></script>

Plugin Installation

Use a code snippets plugin like "Insert Headers and Footers":

1. Install the plugin
2. Add script to footer section
3. Save changes

Troubleshooting

Connection Failed

1. Verify store URL includes https://
2. Check API keys are correct
3. Ensure REST API is enabled
4. Check for firewall blocking API

Webhooks Not Working

1. Verify HTTPS is working
2. Check webhook delivery URL
3. Review webhook logs in WooCommerce
4. Test webhook manually

Products Not Syncing

1. Check product is published
2. Verify API permissions
3. Check for plugin conflicts
4. Review error logs

Orders Missing

1. Check order status filter
2. Verify date range
3. Check customer email matching
4. Try manual sync

Performance Considerations

Large Catalogs

For stores with 10,000+ products:

• Enable incremental sync
• Sync during off-peak hours
• Monitor API rate limits

API Rate Limits

WooCommerce may rate limit API requests:

• Default: No hard limit
• Hosting may impose limits
• Monitor 429 responses

Security

API Key Best Practices

• Use dedicated API key for Fyncall
• Grant minimum required permissions
• Rotate keys periodically
• Monitor API key usage

Webhook Security

Fyncall verifies webhooks using:

• WooCommerce webhook secret
• Source IP validation
• Timestamp validation