Skip to main content

WooCommerce Installation Guide

Connect your WooCommerce store to Synton AI for AI-powered store management and autonomous automation.

Prerequisites​

Before installing, ensure your WordPress environment meets these requirements:

RequirementMinimum Version
WordPress6.0+
WooCommerce8.0+
PHP8.1+
MySQL8.0+ or MariaDB 10.5+
SSL CertificateRequired (HTTPS)
WordPress REST APIEnabled (default)
Server Requirements

Recommended hosting specifications:

  • Memory limit: 256MB minimum (512MB recommended)
  • Max execution time: 180 seconds
  • WordPress REST API: Accessible from internet (not blocked by firewall)

Step 1: Create Synton AI Account​

  1. Visit app.synton.ai
  2. Click Sign Up
  3. Select WooCommerce as your platform
  4. Complete registration with your email
  5. Verify your email address

Step 2: Download the Plugin​

  1. Log into your Synton AI dashboard
  2. Navigate to Settings > Integrations
  3. Click the WooCommerce card
  4. Click Download Plugin
  5. Save the synton-ai-woocommerce.zip file to your computer
Plugin Distribution

The WooCommerce plugin is distributed directly from Synton AI, not the WordPress.org plugin directory, to ensure you always get the latest version.

Step 3: Install the Plugin in WordPress​

  1. Log into your WordPress admin panel
  2. Navigate to Plugins > Add New
  3. Click Upload Plugin at the top of the page
  4. Click Choose File and select the downloaded .zip file
  5. Click Install Now
  6. Wait for installation to complete
  7. Click Activate Plugin

You should see a success message and a new Synton AI menu item in your WordPress sidebar.

Step 4: Connect to Synton AI​

After activation, you'll be redirected to the connection setup wizard.

  1. Click Connect to Synton AI
  2. You'll be redirected to authorize the connection
  3. Log into your Synton AI account if prompted
  4. Review the permissions and click Authorize
  5. You'll be redirected back to WordPress with a success message

Manual API Key Setup​

If automatic connection doesn't work:

  1. In Synton AI dashboard, go to Settings > API Keys
  2. Click Generate New Key
  3. Select WooCommerce as the platform type
  4. Enter your store URL (e.g., https://yourstore.com)
  5. Click Generate
  6. Copy the generated API key
  7. In WordPress, go to WooCommerce > Settings > Synton AI
  8. Paste the API key in the API Key field
  9. Click Save Changes

Step 5: Configure Plugin Settings​

Navigate to WooCommerce > Settings > Synton AI:

SettingDescriptionRecommended
Sync ModeReal-time or scheduledReal-time
Product SyncAll products or selected categoriesAll products
Order HistoryImport historical ordersLast 90 days
Inventory ThresholdLow stock alert level10 units
Enable WebhooksReal-time event notificationsEnabled

Click Save Changes after configuration.

Verification​

Check Connection Status​

  1. In WordPress, go to WooCommerce > Settings > Synton AI > Status
  2. Click Run Diagnostic
  3. Verify all status indicators are green:
    • ✅ API Connection
    • ✅ Product Sync
    • ✅ Order Sync
    • ✅ Webhooks Active

Verify Data Sync​

  1. In Synton AI dashboard, navigate to Chat
  2. Ask: "How many products do I have?"
  3. Verify the count matches your WooCommerce product count
  4. Ask: "Show me my recent orders"
  5. Verify orders appear correctly

Check Webhooks​

  1. In WordPress admin, go to WooCommerce > Settings > Advanced > Webhooks
  2. You should see entries starting with Synton AI -:
    • Synton AI - Product Created
    • Synton AI - Product Updated
    • Synton AI - Product Deleted
    • Synton AI - Order Created
    • Synton AI - Order Updated
  3. Verify all have Status: Active

Initial Sync​

After connection, an initial sync will begin:

  1. Go to WooCommerce > Settings > Synton AI
  2. You'll see Sync Progress: X% complete
  3. Initial sync time depends on catalog size:
    • Small (< 100 products): 1-2 minutes
    • Medium (100-1,000 products): 5-10 minutes
    • Large (1,000-10,000 products): 30-60 minutes
    • Very large (> 10,000 products): 2-4 hours
tip

You can start using Synton AI immediately. The sync runs in the background.

Category Mapping (Optional)​

For better ad targeting, map your WooCommerce categories to Google Product Categories:

  1. In WordPress, go to Products > Categories
  2. Edit a category
  3. Scroll to Synton AI Settings
  4. Select the matching Google Product Category from the dropdown
  5. Click Update
  6. Repeat for all major categories

Troubleshooting​

"Could not connect to API"​

Causes:

  • Site not using HTTPS
  • REST API blocked by security plugin
  • Firewall blocking outbound connections

Solutions:

  1. Verify your site uses HTTPS (required)
  2. Test REST API accessibility: Visit https://yourstore.com/wp-json/
    • Should show JSON data, not 404 or 403
  3. Check security plugins (Wordfence, Sucuri):
    • Whitelist Synton AI IP addresses
    • Add exception for /wp-json/synton/ endpoints
  4. Ensure permalink structure is NOT "Plain":
    • Go to Settings > Permalinks
    • Use any option except "Plain"

"Authentication failed"​

Solutions:

  1. In Synton dashboard, regenerate API key:
    • Settings > API Keys > Regenerate
  2. Update key in WordPress:
    • WooCommerce > Settings > Synton AI
    • Paste new key and save
  3. Clear WordPress cache (if using caching plugin)
  4. Verify API key has correct permissions

Products not syncing​

Solutions:

  1. Go to WooCommerce > Settings > Synton AI > Status
  2. Click Run Diagnostic
  3. Check for red status indicators
  4. Try manual sync: Click Sync Products Now
  5. Check product visibility:
    • Ensure products are published (not draft)
    • Verify products have SKU, price, and name

Duplicate products appearing​

Causes:

  • Products without unique SKUs
  • Multiple sync operations

Solutions:

  1. Verify all products have unique SKUs
  2. In Synton, go to Settings > Data Management
  3. Click Remove Duplicates
  4. Contact support if issue persists

Webhook delivery failures​

Solutions:

  1. In WordPress, go to WooCommerce > Settings > Advanced > Webhooks
  2. Click on a failed webhook
  3. Check Delivery Logs for error details
  4. Common fixes:
    • Verify Synton API is reachable (check status.synton.ai)
    • Check webhook secret matches
    • Ensure SSL certificate is valid
    • Verify server firewall allows outbound HTTPS

Performance issues​

Symptoms: Slow admin panel, high server load

Solutions:

  1. Change sync mode to Scheduled instead of real-time
  2. Reduce sync frequency in plugin settings
  3. Exclude unnecessary product types from sync
  4. Increase PHP memory limit to 512MB
  5. Use object caching (Redis/Memcached)

Plugin Conflicts​

Known compatibility issues:

PluginIssueWorkaround
WordfenceBlocks API requestsWhitelist Synton IPs in firewall
Sucuri FirewallBlocks webhooksAdd exception for /wp-json/synton/
WP RocketCaches API responsesExclude /wp-json/synton/ from cache
iThemes SecurityBlocks REST APIEnable REST API for authenticated requests

Multisite Support​

For WordPress Multisite installations:

  1. Network activate the Synton AI plugin (or activate per site)
  2. Configure each site individually
  3. Each site requires its own Synton AI connection
  4. Use separate API keys per site
info

Multi-network support allows you to manage multiple WooCommerce stores from a single Synton AI account with separate billing per store.

Uninstallation​

To remove the integration:

  1. In WordPress, go to Plugins > Installed Plugins
  2. Find Synton AI for WooCommerce
  3. Click Deactivate
  4. Click Delete
  5. Confirm deletion
  6. In Synton dashboard, go to Settings > Integrations
  7. Click Disconnect next to WooCommerce
Data Retention

Product and order data synced to Synton is retained for analytics unless you explicitly request deletion. To delete all data, contact support@synton.ai.

Next Steps​

  1. Open Your Dashboard at app.synton.ai
  2. Complete Onboarding — Follow the guided setup in your dashboard
  3. Explore AI Agents — Let Synton start analyzing and optimizing your store

Support​