Skip to main content

PrestaShop Installation Guide

Connect your PrestaShop store to Synton AI for AI-driven commerce operations and advertising automation.

Prerequisites​

Before installing, verify your environment meets these requirements:

RequirementMinimum Version
PrestaShop8.0+ (8.1+ recommended)
PHP8.1+
MySQL5.7+ or MariaDB 10.3+
SSL CertificateRequired (HTTPS)
Webservice APIMust be enabled
PrestaShop 1.7 Support

For PrestaShop 1.7.x stores, contact support@synton.ai for the legacy module version compatible with older installations.

Step 1: Create Synton AI Account​

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

Step 2: Download the Module​

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

Step 3: Install Module in PrestaShop​

  1. Log into your PrestaShop back office
  2. Navigate to Modules > Module Manager
  3. Click Upload a module (top right corner)
  4. Drag and drop or select the synton-ai-prestashop.zip file
  5. Wait for installation to complete
  6. Click Configure when the installation success message appears

Step 4: Enable PrestaShop Webservice​

The Synton AI module requires webservice access to sync data.

  1. In PrestaShop back office, go to Advanced Parameters > Webservice
  2. Set Enable PrestaShop's webservice to Yes
  3. Click Save
  4. Click Add new webservice key

Configure Webservice Key​

Fill in the webservice key form:

Key Description: Synton AI Integration

Status: Enabled

Permissions - Set the following resources:

ResourceGETPUTPOSTDELETE
products✅✅❌❌
combinations✅✅❌❌
categories✅❌❌❌
orders✅❌❌❌
order_details✅❌❌❌
customers✅❌❌❌
stock_availables✅✅❌❌
images✅❌❌❌
manufacturers✅❌❌❌
Quick Selection

Click Select All at the top of each permission column, then uncheck unnecessary permissions according to the table above.

  1. Click Save
  2. Copy the generated API key - you'll need it in the next step
Save Your API Key

PrestaShop shows the generated key immediately after creation. Copy it now - you cannot retrieve it later without regenerating.

Step 5: Connect Module to Synton AI​

Now connect the PrestaShop module to your Synton AI account:

In PrestaShop​

  1. Go to Modules > Module Manager
  2. Find Synton AI in the module list
  3. Click Configure
  4. You'll see the module configuration page

In Synton Dashboard​

  1. Open a new browser tab
  2. Go to app.synton.ai
  3. Navigate to Settings > Integrations > PrestaShop
  4. Enter your credentials:
    • Store URL: Your PrestaShop store URL (e.g., https://mystore.com)
    • Webservice Key: The API key generated in Step 4
  5. Click Connect
  6. Wait for connection verification

Back in PrestaShop​

  1. Return to the PrestaShop module configuration tab
  2. You should see Connection Status: Connected in green
  3. Configure module settings (see next step)

Step 6: Configure Module Settings​

In Modules > Synton AI > Configure:

SettingDescriptionRecommended
Sync ModeReal-time or scheduledReal-time
Sync ProductsAll products or selectedAll
Sync OrdersHistorical order rangeLast 90 days
Low Stock AlertInventory threshold10 units
Enable WebhooksReal-time notificationsEnabled

Click Save at the bottom.

Verification​

Check Connection Status​

  1. In PrestaShop, go to Modules > Synton AI > Configure
  2. Click the Status tab
  3. You should see:
    • ✅ Webservice Connection: Active
    • ✅ Product Sync: Enabled
    • ✅ Order Sync: Enabled
    • ✅ Hooks Registered: All active

Verify Data Sync​

  1. In Synton AI dashboard, navigate to Chat
  2. Ask: "How many products do I have?"
  3. The count should match your PrestaShop catalog
  4. Ask: "Show me my recent orders"
  5. Verify orders display correctly with proper data

Test Webservice Access​

  1. Open a new browser tab
  2. Visit: https://yourstore.com/api/
  3. You should see XML documentation (not a 404 or error)
  4. If you see an error, verify webservice is enabled

Multi-Shop Configuration​

For PrestaShop Multi-Shop installations:

All shops managed under one Synton AI account:

  1. In PrestaShop, switch context to All shops
  2. Install and configure Synton AI module
  3. Each shop syncs to the same Synton account
  4. In Synton, shops appear as separate storefronts
  5. Configure per-shop settings in Synton dashboard

Separate Connection Mode​

Each shop connects independently:

  1. Install module on each shop individually
  2. Create separate webservice keys per shop
  3. Each shop connects to a separate Synton account (or same account with different API keys)
  4. Manage each shop's billing separately
Which Mode to Choose?
  • Single Connection: Easier management, combined analytics, single billing
  • Separate Connections: Complete shop isolation, useful for different business entities

Language Configuration​

PrestaShop multi-language product data is fully supported:

  1. In Synton, go to Settings > Integrations > PrestaShop
  2. Click Language Settings
  3. Map PrestaShop languages to Synton languages:
    • English → English
    • Français → French
    • Español → Spanish
    • Deutsch → German
  4. Select Primary Language for advertising (usually your main market)
  5. Click Save

Product names, descriptions, and metadata sync in all configured languages.

Initial Sync​

After connection, an initial sync begins:

  1. In Synton dashboard, go to Settings > Integrations > PrestaShop
  2. Monitor Sync Progress
  3. Sync time depends on catalog size:
    • Small (< 100 products): 1-2 minutes
    • Medium (100-1,000 products): 5-15 minutes
    • Large (1,000-10,000 products): 30-90 minutes
    • Very large (> 10,000 products): 2-6 hours
note

You can start using Synton AI immediately. The sync runs in the background and doesn't affect store performance.

Troubleshooting​

"Could not connect to webservice"​

Solutions:

  1. Verify webservice is enabled:
    • Advanced Parameters > Webservice
    • Enable PrestaShop's webservice should be Yes
  2. Test webservice URL: Visit https://yourstore.com/api/
    • Should display XML, not an error
  3. Check store URL is correct and accessible
  4. Verify SSL certificate is valid
  5. Check server firewall isn't blocking API requests

"Unauthorized" error​

Solutions:

  1. Verify webservice key is correct
  2. Check key status is Enabled in PrestaShop
  3. Confirm all required permissions are granted (see Step 4)
  4. Regenerate webservice key if needed:
    • Advanced Parameters > Webservice
    • Delete old key and create new one
  5. Update key in Synton dashboard

Products not syncing​

Solutions:

  1. Verify products are active in PrestaShop
  2. Check products have required fields:
    • Name
    • Price
    • Reference (SKU)
  3. Verify webservice permission for products is enabled
  4. In Synton, click Sync Now to trigger manual sync
  5. Check sync logs in Settings > Logs for specific errors

Images not syncing​

Solutions:

  1. Verify images permission is enabled in webservice key
  2. Check image files exist and are accessible
  3. Confirm images are in supported formats (JPG, PNG, GIF)
  4. Ensure image URLs aren't blocked by .htaccess or firewall
  5. Check image file permissions on server (should be readable)

Multi-shop sync issues​

Solutions:

  1. Verify correct shop context when configuring module
  2. Check webservice key scope (all shops vs. specific shop)
  3. In Synton, confirm correct shop is selected
  4. Review multi-shop association settings in PrestaShop
  5. Ensure each shop has unique product references if using separate catalogs

Slow sync performance​

Solutions:

  1. Large catalogs take longer - this is normal
  2. Check server resources (CPU, memory usage)
  3. Switch from Real-time to Scheduled sync mode
  4. Optimize PrestaShop performance:
    • Enable caching
    • Optimize database
    • Update to latest PrestaShop version
  5. Consider upgrading hosting for larger catalogs

Module Compatibility​

Compatible Modules​

Works well with:

  • PrestaShop Checkout
  • Standard payment modules (PayPal, Stripe, etc.)
  • Popular shipping modules
  • ps_metrics (PrestaShop analytics)
  • SEO modules

Potential Conflicts​

May conflict with:

  • Other AI/automation modules (duplicate actions)
  • Custom webservice overrides (verify compatibility)
  • Heavy caching modules (add API exceptions)
  • Security modules blocking webservice
Resolving Conflicts

If experiencing conflicts, temporarily disable other automation modules to isolate the issue. Contact support for compatibility testing.

Advanced Configuration​

Module Hooks​

The Synton AI module uses these PrestaShop hooks:

  • actionProductUpdate - Triggers when products change
  • actionOrderStatusUpdate - Captures order status changes
  • actionUpdateQuantity - Monitors stock level changes
  • displayBackOfficeHeader - Adds admin panel UI elements

Custom Endpoints​

The module adds these endpoints:

  • /modules/syntonai/api/sync - Manual sync trigger
  • /modules/syntonai/api/status - Connection health check
  • /modules/syntonai/api/webhook - Incoming webhook receiver

Uninstallation​

To remove the integration:

In PrestaShop​

  1. Go to Modules > Module Manager
  2. Find Synton AI
  3. Click the dropdown menu (⋮)
  4. Select Uninstall
  5. Confirm uninstallation
  6. Optionally, delete the webservice key:
    • Advanced Parameters > Webservice
    • Find Synton AI key and click Delete

In Synton Dashboard​

  1. Go to Settings > Integrations
  2. Find PrestaShop card
  3. Click Disconnect
  4. Confirm disconnection
Data Retention

Synced product and order data remains in Synton for 30 days after disconnection for potential re-connection. To request immediate deletion, 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​