PrestaShop AI Connect — Installation & Setup Guide

Overview

Goldnat AI Connect for PrestaShop turns your store into a Servio Protocol tool server. The basic module exposes the public catalog (products + store info) to AI agents. Pro upgrade is required for orders, customers (PII), and store management.

What you get:

• 3 free tools — getShopInfo, getProducts, getProduct
• Pro upgrade — getCategories, getOrders, getOrder, getCustomers, getInventory, updateOrderStatus, updateProductPrice, updateStock, createDiscount
• Separate Pro extension: prestashop-marketing-ai-connect (SEO + Email marketing + Reviews + Loyalty)

Prerequisites

• PrestaShop 1.7.8+ (8.x recommended)
• PHP 7.4+ (8.1+ recommended)
• MySQL 5.7+
• Friendly URLs enabled
• HTTPS required in production
• Admin access for installation

Installation

1. Download the module ZIP from your personal area at goldnat.ai (sign in → your plugins → download the latest version).
2. Admin → Modules → Module Manager → Upload a module.
3. Drag the ZIP → module is installed.
4. Configure → Enable → Save.
5. Verify on the module page that status shows “Enabled”.

Important: Because the module exposes a public API, verify that Advanced Parameters → Performance doesn’t block the manifest URL.

Connecting to an AI Agent

1. Front Office → My Account → AI Connect Tokens (or /index.php?fc=module&module=aiconnect&controller=tokens).
2. Generate Prompt → copy and paste into your agent.
3. OAuth PKCE runs → approve.

First Test

• “What’s the store name and currency?” → prestashop.getShopInfo
• “Show 5 recent products” → prestashop.getProducts with limit=5
• “What’s the price of product #7?” → prestashop.getProduct with id=7

With Pro:

• “Show 10 recent orders” → prestashop.getOrders
• “Update the status of order #42 to Shipped” → prestashop.updateOrderStatus

Reconnecting

Tokens valid for 30 days. Refresh:

1. AI Connect Tokens → Revoke the old token.
2. Generate Prompt again.

Token Management

/index.php?...&controller=tokens page in the front office. Filters + individual and bulk revoke.

Uninstalling the Module

1. Revoke all tokens

• AI Connect Tokens → Revoke All — kills every active session.

2. Disable and uninstall via UI

• Admin → Modules → Module Manager → find aiconnect.
• Click Disable → then Uninstall.
• PrestaShop will prompt to remove DB tables → confirm.

3. Delete the module files

rm -rf /path/to/prestashop/modules/aiconnect/

4. Clear cache

Advanced Parameters → Performance → Clear cache (or via CLI: php bin/console cache:clear).

Common Troubleshooting

Error	Cause	Fix
Module not found after install	Cache not refreshed	Advanced Parameters → Performance → Clear cache
Manifest 404	Friendly URLs disabled	Preferences → SEO & URLs → Enable Friendly URL
Order not found	Order ID doesn’t exist or belongs to a different store	Verify Multi-shop if relevant
Access denied to customer data	Requires Pro	Upgrade to the Pro module

Support

Need help? Contact us and we’ll get back to you.

Video Tutorial (Coming Soon)

Segments: (A) Goldnat AI Connect on the Servio Protocol, (B) installing + configuring in PrestaShop admin, (C) connecting to an AI agent, (D) 3 typical shop-owner queries.

What Pro adds

The free PrestaShop module gives AI agents read access to your catalog and shop info. Pro adds order, customer, inventory and write tools, so an agent can manage orders, adjust pricing and stock, and create discount vouchers.

Pro ships as a separate PrestaShop module (aiconnectpro) that declares a dependency on the free aiconnect module. The core module loads the Pro tools only when the edition is Pro — otherwise they never appear in the manifest.

Pro tools

Tool	Scope	What it does
getOrders	read	List orders with an optional status filter
getOrder	read	Get full details of a single order
getCustomers	read	List customers
getInventory	read	Get stock levels for products
updateOrderStatus	write	Change the status of an order
updateProductPrice	write	Update a product’s price
updateStock	write	Update a product’s stock quantity
createDiscount	write	Create a discount voucher (cart rule)

Enabling Pro

1. Install the free PrestaShop module first (see the basic guide above).
2. Install the aiconnectpro module alongside it.
3. Set the edition to Pro: AICONNECT_EDITION in the environment, or the AICONNECT_EDITION PrestaShop Configuration value, to pro.
4. Regenerate your connection prompt — the eight Pro tools now appear in the manifest.

Scope note

The read Pro tools (getOrders, getOrder, getCustomers, getInventory) require the read scope; the rest require write. Some tools return personal data — for example, getCustomers returns customer records. If your agent processes personal data, put a Data Processing Agreement (DPA) in place.