How to connect PrestaShop to AskSpot

What the connection does

PrestaShop ships with a Webservice (its REST API) that you enable in the admin. Once it is on, an AI Chat Agent built for e-commerce can read your order data through it – so it can answer “where is my order?” in the shopper’s own words, at any hour. Authentication is a single Webservice key you generate once and hand to AskSpot.

Before you start

• Access to the PrestaShop admin as an administrator.
• HTTPS enabled – recommended, so the key travels safely as Basic Auth.

Step 1 – Enable the Webservice

1. Sign in to the PrestaShop admin as an administrator.
2. Go to Advanced Parameters → Webservice (older wording: Parametry zaawansowane → Usługa sieciowa).
3. Turn on Enable PrestaShop’s webservice.
4. (Optional) Turn on CGI mode for PHP if it is available – it helps pass the Authorization header.
5. Save your changes.

Step 2 – Create a Webservice key

1. Click Add new webservice key.
2. Generate, or type, your own 32-character API key.
3. Add a description (e.g. AskSpot order integration).
4. Set the status to Yes / Active.

Step 3 – Grant permissions

• Tick View (GET) for the orders resource.
• (Optional) Add View (GET) for customers and addresses if you need customer and address data.
• Do not tick more than necessary – least privilege keeps the key safe.
• Save your changes.

Step 4 – Test the key

Check it with curl or Postman. Pass the key in the query string with ws_key, and replace your-store.com with your store:

curl "https://your-store.com/api/orders/1?ws_key=YOUR_API_KEY&display=full"

Or use HTTP Basic Auth – the key as the username, an empty password:

curl -u YOUR_API_KEY: "https://your-store.com/api/orders/1"

In Postman, choose Basic Auth and set Username to the key and Password to blank. Add output_format=JSON to the request if you want the response as JSON. Orders in the response mean the key and its permissions are working.

Authentication: ws_key, Basic Auth and Bearer

PrestaShop authenticates with the Webservice key by default – either as ?ws_key= in the URL or as HTTP Basic Auth. It does not accept Authorization: Bearer without modification. If your integration needs Bearer:

• Turn on CGI mode in PrestaShop.
• Or modify the API code to handle the Bearer header.
• Or put a proxy in front that converts Bearer → ws_key.

Where possible, the simplest path is to point the external system at Basic Auth or ws_key – which is exactly what AskSpot uses.

Step 5 – Add the key to AskSpot

That is the PrestaShop side done. You add the connection yourself in the AskSpot partner panel – there is no need to send us the key:

1. Sign in to partners.askspot.io.
2. Open the AI Chats section and go to Order handling.
3. Click Add order platform and choose PrestaShop from the list.
4. Enter your Domain name (with https://, e.g. https://shop-name.com) and paste the Webservice key into the API key field, then click Save connection.

From then on the Agent reads orders straight away – the connection behind “where is my order?” answered without a human.

For placement modes, display options and the full picture, see the PrestaShop integration.

Next – measure conversions. Once the chat is live, connect Google Analytics to see which conversations lead to sales. See how to track the AskSpot chat in Google Analytics.

Official references

For the authoritative, always-current details, see PrestaShop’s own documentation:

• Web service – PrestaShop DevDocs
• Enable the web service and create an access key
• Web service – getting started