Skip to content
PrestaShop Copilot · Documentation
Website Pricing Contact Open Copilot Try for free

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:

Download sc_aicrew.zip

A single archive works for PrestaShop 1.7, 8 and 9.

Installing

  1. In the store’s back office, open Modules › Module Manager.
  2. Click Upload a module and choose the file sc_aicrew.zip.
  3. Once the installation is finished, open the module’s configuration page.

Linking the store to your account

  1. 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.
  2. 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.
  3. 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 seeWhat 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 arriveAdd 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 keyAn 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 installCheck 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 oldUpdate the module as described above.
The store is behind a protection (password, firewall)Allow calls coming from Copilot to the store’s address.