AI Actions Reference
Amikor a megfelelő API jogosultságok mellett csatlakozik, az AI asszisztens valós időben a következő műveleteket hajthatja végre a PrestaShop boltjában. Ezek a műveletek elérhetők a SmartFlow munkafolyamatokban, és az AI is használhatja őket a vásárlókkal folytatott beszélgetések során.
Products
Get Product
Egy termék teljes részleteinek lekérése az azonosítója alapján.
- Input: Termék azonosító
- Returns: Név, leírás, rövid leírás, referencia, ár, készlet mennyiség, aktív státusz, SEO mezők (meta cím, meta leírás, meta kulcsszavak)
- API permission:
products(GET)
Update Product Content
Egy termék leírásának és/vagy rövid leírásának frissítése, teljes többnyelvű támogatással.
- Inputs: Termék azonosító, leírás (opcionális), rövid leírás (opcionális), nyelv azonosító (opcionális — alapértelmezett a bolt elsődleges nyelve)
- Returns: Megerősítés a frissített mezők listájával
- API permission:
products(GET + PUT)
Az AI megőrzi a tartalmat más nyelveken, amikor egy adott nyelvet frissít. Például a francia leírás frissítése nem befolyásolja az angol verziót.
Update Product SEO
Egy termék SEO mezőinek frissítése, többnyelvű támogatással.
- Inputs: Termék azonosító, meta cím (opcionális), meta leírás (opcionális), meta kulcsszavak (opcionális), nyelv azonosító (opcionális)
- Returns: Megerősítés a frissített SEO értékekkel
- API permission:
products(GET + PUT)
Orders
Get Order by Reference
Egy konkrét rendelés keresése a referencia számának használatával (pl. ABCDEF123).
- Input: Rendelési referencia
- Returns: Teljes rendelési részletek, beleértve a dátumot, státuszt, teljes összeget, fizetési módot, szállítási információt és a termékek listáját
- API permission:
orders(GET),order_details(GET),order_states(GET)
Get Orders by Email
Minden rendelés lekérése, amelyet egy adott vásárló adott le.
- Inputs: Vásárló e-mail, limit (opcionális — alapértelmezett 10)
- Returns: Rendelések listája teljes részletekkel, összesített szám
- API permission:
orders(GET),order_details(GET),order_states(GET),customers(GET)
Get Last Order
A legutolsó rendelés lekérése egy adott vásárló számára.
- Input: Vásárló e-mail
- Returns: A legfrissebb rendelés teljes részletekkel, vagy null, ha nem található rendelés
- API permission:
orders(GET),order_details(GET),order_states(GET),customers(GET)
Update Order Status
A rendelés státuszának megváltoztatása (pl. jelölje meg kiszállítva, jelölje meg kézbesítve).
- Inputs: Rendelés azonosító, új rendelési állapot azonosító, e-mail értesítés küldése (opcionális — alapértelmezett nem)
- Returns: Megerősítés az új státusszal és hogy küldtek-e e-mailt
- API permission:
order_histories(GET + POST)
A rendelés státuszának megváltoztatása vásárlói e-mail értesítéseket indíthat el, ha a sendEmail opció engedélyezve van. Győződjön meg arról, hogy a megfelelő státuszt alkalmazza.
Customers
Get Customer
Egy vásárló keresése az e-mail címe alapján.
- Input: Vásárló e-mail
- Returns: Vásárló azonosító, keresztnév, vezetéknév, e-mail, születésnap, hírlevél státusz, regisztráció dátuma, megjegyzések
- API permission:
customers(GET)
Update Customer
Egy vásárló profilinformációinak frissítése.
- Inputs: Vásárló azonosító, keresztnév (opcionális), vezetéknév (opcionális), e-mail (opcionális), megjegyzések (opcionális)
- Returns: Megerősítés a frissített mezők listájával
- API permission:
customers(GET + PUT)
Configuration
Get Languages
A PrestaShop boltjában konfigurált összes nyelv listázása.
- No input required
- Returns: Nyelvek listája az azonosítóval, névvel és ISO kóddal (pl.
fr,en,de) - API permission:
languages(GET)
Ezt a műveletet belsőleg használja az AI, amikor többnyelvű termékfrissítéseket végez, hogy biztosítsa a helyes nyelv azonosító használatát.
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 — A szükséges Webservice jogosultságok konfigurálása
- Webhooks & Skills — Ezeknek a műveleteknek az automatikus aktiválása bolt események során