Installing the Copilot module
The module is the recommended way to connect a store. It creates by itself an access limited to what Copilot needs: nothing to create or tick. It also adds alerts the moment something happens, cart follow-ups and the advanced gestures of developer mode.
Downloading
The module is always downloaded from the same address, which gives the latest version:
A single archive works for PrestaShop 1.7, 8 and 9.
Installing
- In the store’s back office, open Modules › Module Manager.
- Click Upload a module and choose the file
sc_aicrew.zip. - Once the installation is finished, open the module’s configuration page.
Linking the store to your account
- In Copilot (on the web or in the mobile app), choose Connect with the module, then Get my link key. Copy the key: it is shown only once and is valid for 48 hours.
- On the module page, in the Connect to Copilot section, paste the key and click Connect to Copilot. The module turns the Webservice on if it is off, creates its own Webservice key (a single one, marked “created by Copilot”, with only the rights Copilot uses), checks that it answers, then tells Copilot.
- The Copilot screen updates by itself: “Store connected”. The first analysis starts right away.
Automatic panel sign-in
In the back office, the Copilot panel signs in by itself, without a password: when it opens, the module signs a single-use token valid for two minutes, which Copilot exchanges for a session on your account. That session gives no access to the subscription and billing, the account settings (stores, link key, deletion) or the administration, and follows the rights of the employee's PrestaShop profile; the account owner can switch it off in Copilot, Connections & rules, with the Automatic sign-in from the back office box (everyone then signs in inside the panel).
Updating the module
Download the archive again at the address above and upload it in the Module Manager: PrestaShop replaces the old version. The connection is kept. A module older than version 0.5.17 offered an old token to paste: the update removes it, and the connection is made in one gesture with the link key.
Removing the store from Copilot
When you remove the store in Copilot, the module deletes the Webservice key it created. A key you created yourself is never deleted. If the module cannot be reached at that moment, delete the key “created by Copilot” in Advanced Parameters › Webservice.
If something goes wrong
| What you see | What to do |
|---|---|
| “Key expired” or “not recognised” | In Copilot, click Get my link key again, paste it in the module and click Connect to Copilot again. |
| The module says the Authorization header does not arrive | Add the line RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}] to the .htaccess file at the root of the store (with PHP in FastCGI, ask your host to forward this header), then click again. |
| The module says your profile cannot create a key | An administrator connects from the module, or you choose My own key in Copilot and create the key yourself: see the Webservice key. |
| The module does not install | Check the PrestaShop version (1.7.0 at least) and the write permissions of the modules folder. PrestaShop 1.7.0.x to 1.7.3 is only supported on PHP 5.6 or 7.0 (PrestaShop itself requires it): check the shop’s PHP version. |
| Copilot says the module is too old | Update the module as described above. |
| The store is behind a protection (password, firewall) | Allow calls coming from Copilot to the store’s address. |