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 — Автоматично задействайте тези действия при събития в магазина