ShopAssist ShopAssist PrestaShop install guide

Installing ShopAssist on PrestaShop

Upload the ShopAssist module in your PrestaShop admin and click Connect.

PrestaShop 8 and 9 · Hummingbird, Classic and themes based on them

What you get

ComponentDescription
Chat widgetA floating chat button on every page of your store. Shoppers ask about your products, and the assistant answers, recommends, and compares items.
Add to cartShoppers pick a size or colour inside the chat and add the product to their PrestaShop cart. They check out as usual.
Question pillsQuestions about the product under the add-to-cart button. A shopper clicks one and the chat opens with the answer.
CompareA Compare button on the product image and on product cards in category and search results. The chat shows two products side by side.
Sales reportingThe orders that followed a conversation, with their revenue, in your ShopAssist dashboard.
The ShopAssist chat on a PrestaShop store, answering with a product card for the Hummingbird printed t-shirt.
The assistant answers with products from your catalog.

Shoppers click Choose options on a product, pick a size and a colour, and add it to the cart.

The ShopAssist chat picker for the Hummingbird printed t-shirt, with size M and colour White selected and an Add to Cart button.
The size and colour picker in the chat.

Customizable products link to their own product page, where shoppers fill in the customization and add them to the cart.

Before you start

The chat button appears once ShopAssist activates your store. You can install and connect first. The button then appears on its own when your store goes live.

1Install the module

  1. Download shopassist.zip.
  2. In the PrestaShop admin, go to Modules → Module Manager and click Upload a module at the top right.
  3. Drag shopassist.zip into the window, or click select file and choose it.
The PrestaShop Upload a module window with the area to drop the zip file.
Modules → Module Manager → Upload a module.

PrestaShop installs the module and shows Module installed! with a Configure button.

The Upload a module window showing Module installed! and a Configure button.
The module is installed. Click Configure.

2Connect

  1. Click Configure. Later, you find the same page under Modules → Module Manager, next to ShopAssist.
  2. Click Connect to ShopAssist.
The ShopAssist settings page in the PrestaShop admin, with the status Not connected yet and the Connect to ShopAssist button.
The ShopAssist settings page before you connect.

The module creates a read-only Webservice key for your catalog and orders, and sends it to ShopAssist. A green message confirms the connection.

The ShopAssist settings page with a green message confirming the connection.
Connected.

You find the key under Advanced Parameters → Webservice, named ShopAssist (read-only catalog).

The Webservice page in the PrestaShop admin, listing the key ShopAssist (read-only catalog) as enabled.
Advanced Parameters → Webservice.

3Check it works

The top of the ShopAssist settings page shows where you are:

StatusNext step
Not connected yetClick Connect to ShopAssist.
Connected. Waiting for ShopAssist to switch the assistant on.ShopAssist activates your store. The chat button then appears on its own.
Connected and live.The assistant is on your store.

When the status says Connected and live:

  1. Open your store in a new browser tab.
  2. Wait about five seconds.
  3. Look for a round chat button in the bottom corner.
  4. Click it and ask something, such as What do you sell?
A PrestaShop home page with the round ShopAssist chat button at the bottom.
The chat button at the bottom of your store.

You are done when the assistant answers with products from your catalog.

On a product page with questions, the questions appear under the add-to-cart button, and a Compare button sits on the product image.

A PrestaShop product page with a Compare button on the image and question pills under the Add to cart button.
Question pills and the Compare button on a product page.

On a category page, each product card has a Compare button. Click it on two products, and the chat shows them side by side.

A PrestaShop category page with a Compare button in the corner of each product card.
Compare buttons on a category page.
The ShopAssist chat comparing two products side by side, with price, availability and other rows.
Two products compared in the chat.

Settings

The ShopAssist settings page has three switches, all on after the install.

SettingWhat it does
Show the assistantShows or hides the whole assistant on your store.
Question pills on product pagesShows the questions under the add-to-cart button. A product shows them once it has questions in your ShopAssist dashboard.
Compare buttonsShows the Compare buttons. ShopAssist switches Compare on for your store, so email us to turn it on.
The ShopAssist settings form with the three switches Show the assistant, Question pills on product pages and Compare buttons, all set to Yes.
The three switches. Click Save after a change.

The chat uses your store’s language and currency on every page, including stores with several languages or currencies.

Pausing and removing

To pause: set Show the assistant to No and click Save. The chat button disappears at the next page load. Your account, settings and past conversations stay as they are.

To remove: in Modules → Module Manager, open the menu next to ShopAssist and choose Uninstall. The module also deletes its Webservice key.

Troubleshooting

What you seeWhat to do
“ShopAssist could not read your catalog with the Webservice key”Go to Shop Parameters → Traffic & SEO, set Friendly URL to Yes and click Save. PrestaShop rewrites its server settings. Then click Connect to ShopAssist again. If the message comes back, ask your host to pass the Authorization header to PHP.
“ShopAssist could not reach your store”Make your store reachable over HTTPS, including the /api address, then click Connect to ShopAssist again.
“Your bot protection blocked ShopAssist”Email us with the name of your firewall or bot protection service.
The status says ShopAssist is unreachable right nowAllow your server to make outgoing HTTPS requests to api.getshopassist.com.
The chat button is missingCheck the status at the top of the settings page, and that Show the assistant is Yes. A status of Waiting means ShopAssist is activating your store.
A product page shows no questionsAdd questions for the product in your ShopAssist dashboard.
Adding a product from the chat asks for required fieldsThe product is customizable. Shoppers add it from its own product page.

For help, email support@getshopassist.com with the step you reached, the message you saw, and the address of your store.