AI Actions Reference

Когато е свързан с правилните API permissions, вашият AI асистент може да извършва следните действия на вашия PrestaShop магазин в реално време. Тези действия са налични в SmartFlow работни потоци и могат да бъдат използвани и от AI по време на разговори с вашите клиенти.

---

Products

Get Product

Извлечете пълни детайли за продукт по неговия 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

Актуализирайте описанието и/или краткото описание на продукт, с пълна многоезична поддръжка.

• 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)

Съвет

AI запазва съдържанието на други езици при актуализиране на конкретен език. Например, актуализирането на френското описание няма да повлияе на английската версия.

Update Product SEO

Актуализирайте SEO полетата на продукт, с многоезична поддръжка.

• 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

Намерете конкретна поръчка, използвайки нейния референтен номер (например, 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

Извлечете всички поръчки, направени от конкретен клиент.

• 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

Получете най-новата поръчка за конкретен клиент.

• 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

Променете статуса на поръчка (например, маркирайте като изпратена, маркирайте като доставена).

• 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)

Внимание

Промяната на статуса на поръчка може да задейства известия по имейл за клиента, ако опцията sendEmail е активирана. Уверете се, че правилният статус е приложен.

---

Customers

Get Customer

Намерете клиент по неговия имейл адрес.

• Input: Customer email
• Returns: Customer ID, first name, last name, email, birthday, newsletter status, registration date, notes
• API permission: customers (GET)

Update Customer

Актуализирайте информацията за профила на клиента.

• 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

Изброете всички езици, конфигурирани на вашия PrestaShop магазин.

• No input required
• Returns: List of languages with ID, name, and ISO code (e.g., fr, en, de)
• API permission: languages (GET)

Информация

Тази функция се използва вътрешно от AI при извършване на многоезични актуализации на продукти, за да се увери, че правилният езиков ID се използва.

---

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 — Конфигурирайте необходимите Webservice permissions
• Webhooks & Skills — Автоматично задействайте тези действия при събития в магазина