AI Actions Reference
Kai esate prisijungę su tinkamomis API teisėmis, jūsų AI asistentas gali atlikti šiuos veiksmus jūsų PrestaShop parduotuvėje realiu laiku. Šie veiksmai yra prieinami SmartFlow darbo srautuose ir taip pat gali būti naudojami AI pokalbių su jūsų klientais metu.
Products
Get Product
Gauti visą produkto informaciją pagal jo ID.
- Input: Produkto ID
- Returns: Pavadinimas, aprašymas, trumpas aprašymas, nuoroda, kaina, atsargų kiekis, aktyvumo statusas, SEO laukai (meta pavadinimas, meta aprašymas, meta raktiniai žodžiai)
- API permission:
products(GET)
Update Product Content
Atnaujinti produkto aprašymą ir/arba trumpą aprašymą, su pilna daugiakalbe parama.
- Inputs: Produkto ID, aprašymas (neprivalomas), trumpas aprašymas (neprivalomas), kalbos ID (neprivalomas — numatytas parduotuvės pagrindinė kalba)
- Returns: Patvirtinimas su atnaujintų laukų sąrašu
- API permission:
products(GET + PUT)
AI išsaugo turinį kitomis kalbomis atnaujindamas konkrečią kalbą. Pavyzdžiui, atnaujinus prancūzišką aprašymą, angliškos versijos tai nepaveiks.
Update Product SEO
Atnaujinti produkto SEO laukus, su daugiakalbe parama.
- Inputs: Produkto ID, meta pavadinimas (neprivalomas), meta aprašymas (neprivalomas), meta raktiniai žodžiai (neprivalomi), kalbos ID (neprivalomas)
- Returns: Patvirtinimas su atnaujintomis SEO reikšmėmis
- API permission:
products(GET + PUT)
Orders
Get Order by Reference
Ieškoti konkrečios užsakymo naudojant jo nuorodos numerį (pvz., ABCDEF123).
- Input: Užsakymo nuoroda
- Returns: Visas užsakymo informacijos rinkinys, įskaitant datą, statusą, bendrą sumą, mokėjimo metodą, siuntimo informaciją ir produktų sąrašą
- API permission:
orders(GET),order_details(GET),order_states(GET)
Get Orders by Email
Gauti visus užsakymus, pateiktus konkretaus kliento.
- Inputs: Kliento el. paštas, limitas (neprivalomas — numatytas 10)
- Returns: Užsakymų sąrašas su visa informacija, bendras skaičius
- API permission:
orders(GET),order_details(GET),order_states(GET),customers(GET)
Get Last Order
Gauti naujausią užsakymą konkrečiam klientui.
- Input: Kliento el. paštas
- Returns: Naujausias užsakymas su visa informacija, arba null, jei užsakymų nerasta
- API permission:
orders(GET),order_details(GET),order_states(GET),customers(GET)
Update Order Status
Pakeisti užsakymo statusą (pvz., pažymėti kaip išsiųstą, pažymėti kaip pristatytą).
- Inputs: Užsakymo ID, naujo užsakymo būsenos ID, siųsti el. pašto pranešimą (neprivalomas — numatytas ne)
- Returns: Patvirtinimas su nauju statusu ir ar buvo išsiųstas el. paštas
- API permission:
order_histories(GET + POST)
Užsakymo statuso keitimas gali sukelti klientų el. pašto pranešimus, jei sendEmail parinktis yra įjungta. Įsitikinkite, kad taikomas teisingas statusas.
Customers
Get Customer
Ieškoti kliento pagal jo el. pašto adresą.
- Input: Kliento el. paštas
- Returns: Kliento ID, vardas, pavardė, el. paštas, gimtadienis, naujienlaiškio statusas, registracijos data, pastabos
- API permission:
customers(GET)
Update Customer
Atnaujinti kliento profilio informaciją.
- Inputs: Kliento ID, vardas (neprivalomas), pavardė (neprivaloma), el. paštas (neprivalomas), pastabos (neprivalomos)
- Returns: Patvirtinimas su atnaujintų laukų sąrašu
- API permission:
customers(GET + PUT)
Configuration
Get Languages
Išvardyti visas kalbas, sukonfigūruotas jūsų PrestaShop parduotuvėje.
- No input required
- Returns: Kalbų sąrašas su ID, pavadinimu ir ISO kodu (pvz.,
fr,en,de) - API permission:
languages(GET)
Šis veiksmas naudojamas viduje AI, atliekant daugiakalbius produkto atnaujinimus, siekiant užtikrinti, kad būtų naudojamas teisingas kalbos 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 — Suconfigure the required Webservice permissions
- Webhooks & Skills — Trigger these actions automatically on store events