Connecting your PrestaShop store to Fexa AI takes 3 steps: about 3 minutes, no key to copy.
- Download the module from the Connect page in Fexa AI.
- In PrestaShop: Modules › Module Manager › Upload a module.
- Click « Connecter à Fexa AI » (Connect to Fexa AI), then « Ouvrir Fexa AI pour finaliser » (Open Fexa AI to finish), and confirm on Fexa AI.
The module's buttons are in French; this guide quotes them exactly as they appear, with a translation in brackets. It details each step, then the fixes for the most common blockers.
Before you start
- A Fexa AI account (free). You can also create it during the connection, at step 3.
- Administrator access to the PrestaShop back office, to install a module. Not the one running PrestaShop? Send this guide to the person who does: they install the module and send you the link from step 3, which you confirm yourself with your own account.
- An online store, reachable over
https://. A store installed locally or protected by a password cannot be reached. - Universal compatibility: a single lightweight
.zipfile (~90 KB) works on every PrestaShop 1.7, 8 and 9 store (PHP 7.1 to 8.4). PrestaShop 1.6 is not supported.
Install the module
- In Fexa AI, open the Connect page and download the module. Keep the
.zipfile as it is, without unzipping it. - In the PrestaShop back office, go to Modules › Module Manager, click Upload a module and drop the file.
- Once the installation is done, click Configure.
Connect
- In the module configuration, click « Connecter à Fexa AI » (Connect to Fexa AI).
- Then click « Ouvrir Fexa AI pour finaliser » (Open Fexa AI to finish): a Fexa AI tab opens.
- Sign in to your account (or create it for free), check the store address shown and confirm.
The security code travels inside the link automatically: there is nothing to retype. The link is valid for 15 minutes and works only once. Once the connection is confirmed, you can close the PrestaShop tab.
You stay in control: Fexa AI only accesses your catalog (products, categories, CMS pages) and nothing is published without an action on your part: either you approve each page, or you start an automatic optimization yourself, which only publishes the fields that passed its checks, reports everything back to you and can be undone in 1 click.
Troubleshooting
The store is in maintenance mode
Fexa AI cannot reach a store in maintenance mode on older module versions. Update the module to version 3.9.2 or later (download it again from the Connect page and upload it: PrestaShop updates it), or turn maintenance off while you connect (Shop Parameters › General › Maintenance).
The store is protected by Cloudflare or a firewall
If your store uses Cloudflare or a hosting firewall (WAF), the automated bot mitigation (Bot Fight Mode) may challenge Fexa AI's server checks with a firewall error.
To whitelist the connection in 30 seconds:
- In your Cloudflare dashboard, select your domain.
- Go to Security › WAF › Custom rules, then click Create rule.
- Configure the rule:
- Name:
Allow Fexa AI Connector - Field:
URIcontainsfexa_ai_connector(expression:(http.request.uri contains "fexa_ai_connector")) - Action: Skip, checking WAF Managed Rules, Bot Fight Mode, and Rate limiting.
- Name:
- Click Deploy, then restart the connection from PrestaShop.
The store is in a subfolder
For example https://example.com/shop/. Module versions before 3.8.1 lose that subfolder, and Fexa AI then says it cannot find the module. Update the module, then click « Connecter à Fexa AI » again. If the error persists, the manual connection (at the bottom of this page) works with the full address.
Address with or without "www"
https://www.example.com and https://example.com are two different addresses: if one redirects to the other, the check can fail with a message saying the key was refused. Make sure the domain set in PrestaShop (Shop Parameters › Traffic & SEO, "Set shop URL" section) matches exactly the address shown in your browser, then try again.
A code was pasted somewhere by mistake
There is no code to retype any more: it travels inside the link. If you pasted the 6-character code into a field by mistake, nothing needs to be done: it works only once and expires with the link. Just click « Connecter à Fexa AI » again to get a new link. On the other hand, never share the module key (64 characters): if in doubt, contact support.
The link has expired
The finishing link is valid for 15 minutes and works only once. If it has expired, go back to the module configuration and click « Connecter à Fexa AI » again: a new link is created. Close the old Fexa AI tab, which no longer matches.
PHP 7 error with an older module version
Since v3.9, the single universal module runs natively on PHP 7.1 to 8.4 (PrestaShop 1.7 to 9) with no separate edition to choose. If an older pre-3.9 module caused an error under PHP 7 ("Parse error", blank page, module manager unavailable), delete the modules/fexa_ai_connector folder from your hosting (over FTP or with your host's file manager), then download and upload the current universal .zip from the Connect page.
Still stuck?
We'll do it with you, for free, over screen sharing: you do the clicking, and we never ask for a password.
Connect with the module key
Useful if your module has no « Connecter à Fexa AI » button (version older than 3.7). In the module configuration, expand « Connexion manuelle (avancé) » (Manual connection, advanced) and copy the key. On the Connect page, click “Connect with the module key”, enter the exact store address (including any subfolder) and paste the key. This key gives access to your catalog: never share it anywhere else.
Next step: Connect Google Search Console → SEO Configuration of your store