Troubleshooting
Common issues and solutions for the AI SmartTalk PrestaShop module.
Installation
The module won't install
- Check your PrestaShop version: The module requires PrestaShop 8 or 9
- Check server memory: Ensure your server has enough memory to install modules
- Check file permissions: The
modules/directory must be writable by the web server - Disable conflicting modules: Try disabling other modules temporarily if there are conflicts
The module installed but doesn't appear in the menu
- Clear your PrestaShop cache: Advanced Parameters > Performance > Clear cache
- Try logging out and back in to your PrestaShop admin
Connection
The "Connect with AI SmartTalk" button doesn't work
- Check outbound HTTPS: Your server must allow outbound HTTPS connections to
aismarttalk.tech - Check pop-up blockers: The OAuth flow opens in a new window — ensure your browser isn't blocking it
- Check your firewall: Ensure ports 443 (HTTPS) are not blocked
Connection redirects but nothing happens
- The OAuth token is valid for 10 minutes. If you waited too long, try disconnecting and reconnecting
- Clear your browser cookies and try again
Multi-site: a site shows as "Disconnected"
- Each site needs its own OAuth connection. Go to the affected PrestaShop instance and click Connect again
- Ensure each site has a distinct domain name or port
Chatbot
The chatbot doesn't appear on my store
- Check module status: Make sure the chatbot is enabled in the module's Chatbot tab
- Check assistant selection: Ensure an AI assistant is selected and saved
- Check the connection: The module must be connected to AI SmartTalk (green status badge)
- Clear caches: Clear both PrestaShop cache (Advanced Parameters > Performance) and your browser cache
- Check hook position: Try switching between "Footer" and "Before Footer" in the Appearance settings
The chatbot appears but doesn't respond
- Verify your AI SmartTalk subscription is active
- Check that the selected assistant is properly configured in your AI SmartTalk dashboard
- Check your browser's developer console for JavaScript errors
API & AI Actions
AI actions fail with "permission denied" or "unauthorized"
- Check your Webservice key: Ensure it's enabled and has the correct permissions (see API Permissions)
- Verify the key is entered: The Webservice token should be transmitted during OAuth connection. If it's missing, update it in your AI SmartTalk dashboard under the PrestaShop integration settings
Product updates don't work
- Ensure
productshas both GET and PUT permissions on your Webservice key - Check that the product ID exists and the product is not locked by another module
Order status changes fail
- Ensure
order_historieshas both GET and POST permissions - Verify the order state ID is valid for your store (state IDs vary by PrestaShop configuration)
Customer lookup returns no results
- Ensure
customershas GET permission - Check that the email address is correct and matches an existing customer
Synchronization
Product sync doesn't start or fails
- Check your server's PHP timeout settings — large catalogs may need more time
- Verify your internet connection is stable
- Check the PrestaShop error logs in Advanced Parameters > Logs
Only some products are synced
- Check if sync filters are active (a "Filtered" badge appears on the Synchronize tab)
- Review category and product type filters to ensure they match your expectations
Customer sync doesn't work
- Ensure customer synchronization is enabled in the Synchronize tab
- Customers are exported in batches of 50 — large databases may take several minutes
Webhooks
Webhooks don't trigger
- Verify the webhook triggers are enabled in the Webhooks tab
- Check that your server allows outbound HTTP requests to AI SmartTalk
- Ensure you have a SmartFlow workflow configured to receive the webhook trigger
- Check PrestaShop logs for any errors during hook execution
Webhooks fire but nothing happens in SmartFlow
- Verify your SmartFlow workflow is published and active
- Check that the workflow trigger type matches the PrestaShop webhook event
- Review the SmartFlow execution logs in your AI SmartTalk dashboard
Performance
The module slows down my store
- Disable unused webhook triggers to reduce outbound requests
- Ensure caching is working properly — the module uses a built-in cache for embed configuration
- Check that your server has adequate resources (CPU, memory)
The back office is slow after installing the module
- The module only runs on its own configuration page and in specific hooks — it should not impact general back-office performance
- If you experience issues, check for conflicts with other modules
Still need help?
If your issue isn't covered here:
- Check the AI SmartTalk dashboard for error messages or alerts
- Review your PrestaShop error logs (Advanced Parameters > Logs)
- Contact our support team at contact+support@aismarttalk.tech