For AI assistants: this page as plain markdown is at https://docs.voicelogica.ai/raw/integrations/eshops/prestashop.md, and https://docs.voicelogica.ai/llms.txt lists the docs by topic, one file each, small enough to read whole. Read those rather than this HTML page.
PrestaShop
With PrestaShop connected, the agent recognises a customer from the number they call from, reads back their recent orders, answers product questions by name or reference, and, if you allow it, moves an existing order to another status (for example from awaiting payment to payment accepted). Integrations - Catalogue - PrestaShop - Connect opens the connect dialog. One connection is shared by every agent in the company.
What you need before you start
Section titled “What you need before you start”A Webservice key from the PrestaShop back office:
- Advanced Parameters - Webservice, and enable the webservice.
- Add new webservice key. Generate the key and give it permissions on
customers,addresses,products,orders,order_statesandorder_histories. Read access covers lookups; the agent needs write access onordersandorder_historiesto create orders or change their status. - Save and copy the key.
What you enter
Section titled “What you enter”https://, for example https://myshop.example.1, the shop’s default language.First setup
Section titled “First setup”-
Integrations - Catalogue - PrestaShop - Connect, fill the fields, Test connection, then Connect. PrestaShop appears under Connected and customers and products start copying in the background.
-
Open My Agents, pick the agent, then Skills - Tools & Workflows. Turn on PrestaShop and click Configure.
-
Pick the operations. Identify caller by phone is on by default. Add Get orders by customer and Search products for order and product questions. To let the agent change an order’s status, add Update order status together with List order states, so it only picks a status your shop has. Leave Create order off unless you have read the limitation under Troubleshooting.
-
Click Save in the settings window, then Save the agent.
-
Call the agent from a phone number saved on a PrestaShop customer address (or use Try this agent). Ask “What’s happening with my last order?”. The agent should greet you by name and read back the order status. Then ask for a product by name.
What the agent can do
Section titled “What the agent can do”| Job | What happens on the call |
|---|---|
| Recognise the caller | Matches the caller’s number to a PrestaShop customer. Can also find a customer by name or email and remember the number for next time. |
| Order questions | Reads the caller’s recent orders or one order: status, totals, items. Pre-fetch recent orders on call start loads the last 10 orders before the agent speaks. |
| Order status changes | Reads the shop’s list of order states and moves an order to one of them. |
| Product questions | Searches by name, reference (SKU), barcode (EAN-13) or manufacturer part number and reads one product’s details. Out-of-stock products are listed last. |
| Create an order | Limited: PrestaShop accepts it only for a cart that already exists (see Troubleshooting). Your Max order value, Max order lines and Custom order attributes apply. |
Customers and products are refreshed daily. Sync now on the PrestaShop card under Connected refreshes them immediately.
Troubleshooting
Section titled “Troubleshooting”Why does the PrestaShop test connection fail with 401 or 403?
PrestaShop refused the webservice key. Check that the webservice is enabled under Advanced Parameters - Webservice, that the key is active, and that you copied the whole key. A 403 can also mean the key exists but lacks permissions on customers, addresses, products, orders, order_states and order_histories.
Why are PrestaShop product names in the wrong language or empty?
Default language id points to a language the products are not translated into. Use the id of your shop’s main language (shown under International - Localization - Languages). To change it, disconnect PrestaShop under Connected and connect again with the right id.
Why can't the agent change an order's status in PrestaShop?
Update order status needs write access on order_histories for the webservice key, and works best with List order states also selected so the agent uses a status name that exists in your shop.
Why does creating an order in PrestaShop fail?
PrestaShop only accepts an order created through the Webservice for a cart that already exists, with a carrier, currency and both delivery and invoice addresses set. It does not work these out itself, and the agent does not create carts. For phone orders on PrestaShop, have the agent take the details and pass them to your team (for example with a workflow), and use the integration for caller recognition, order status and product questions.
