AI Actions Reference
When connected with the proper API permissions, your AI assistant can perform the following actions on your PrestaShop store in real time. These actions are available in SmartFlow workflows and can also be used by the AI during conversations with your customers.
Products
Get Product
Retrieve full details of a product by its ID.
- Input: Product ID
- Returns: Name, description, short description, reference, price, stock quantity, active status, SEO fields (meta title, meta description, meta keywords)
- API permission:
products(GET)
Update Product Content
Update the description and/or short description of a product, with full multilingual support.
- Inputs: Product ID, description (optional), short description (optional), language ID (optional — defaults to the store's primary language)
- Returns: Confirmation with the list of updated fields
- API permission:
products(GET + PUT)
The AI preserves content in other languages when updating a specific language. For example, updating the French description won't affect the English version.
Update Product SEO
Update the SEO fields of a product, with multilingual support.
- Inputs: Product ID, meta title (optional), meta description (optional), meta keywords (optional), language ID (optional)
- Returns: Confirmation with updated SEO values
- API permission:
products(GET + PUT)
Orders
Get Order by Reference
Look up a specific order using its reference number (e.g., ABCDEF123).
- Input: Order reference
- Returns: Full order details including date, status, total amount, payment method, shipping info, and list of products
- API permission:
orders(GET),order_details(GET),order_states(GET)
Get Orders by Email
Retrieve all orders placed by a specific customer.
- Inputs: Customer email, limit (optional — defaults to 10)
- Returns: List of orders with full details, total count
- API permission:
orders(GET),order_details(GET),order_states(GET),customers(GET)
Get Last Order
Get the most recent order for a specific customer.
- Input: Customer email
- Returns: The latest order with full details, or null if no orders found
- API permission:
orders(GET),order_details(GET),order_states(GET),customers(GET)
Update Order Status
Change the status of an order (e.g., mark as shipped, mark as delivered).
- Inputs: Order ID, new order state ID, send email notification (optional — defaults to no)
- Returns: Confirmation with the new status and whether an email was sent
- API permission:
order_histories(GET + POST)
Changing an order status can trigger customer email notifications if the sendEmail option is enabled. Make sure the correct status is being applied.
Customers
Get Customer
Look up a customer by their email address.
- Input: Customer email
- Returns: Customer ID, first name, last name, email, birthday, newsletter status, registration date, notes
- API permission:
customers(GET)
Update Customer
Update a customer's profile information.
- Inputs: Customer ID, first name (optional), last name (optional), email (optional), notes (optional)
- Returns: Confirmation with the list of updated fields
- API permission:
customers(GET + PUT)
Configuration
Get Languages
List all languages configured on your PrestaShop store.
- No input required
- Returns: List of languages with ID, name, and ISO code (e.g.,
fr,en,de) - API permission:
languages(GET)
This action is used internally by the AI when performing multilingual product updates, to ensure the correct language ID is used.
Summary table
| Action | Category | Read | Write |
|---|---|---|---|
| Get Product | Products | Yes | — |
| Update Product Content | Products | Yes | Yes |
| Update Product SEO | Products | Yes | Yes |
| Get Order by Reference | Orders | Yes | — |
| Get Orders by Email | Orders | Yes | — |
| Get Last Order | Orders | Yes | — |
| Update Order Status | Orders | — | Yes |
| Get Customer | Customers | Yes | — |
| Update Customer | Customers | Yes | Yes |
| Get Languages | Config | Yes | — |
Related
- API Permissions — Configure the required Webservice permissions
- Webhooks & Skills — Trigger these actions automatically on store events