AI Actions Reference
Ko je povezan s pravimi API dovoljenji, lahko vaš AI asistent izvaja naslednje akcije na vašem PrestaShop trgovini v realnem času. Te akcije so na voljo v SmartFlow delovnih tokovih in jih lahko AI uporablja tudi med pogovori z vašimi strankami.
Products
Get Product
Pridobite popolne podrobnosti o izdelku po njegovem ID-ju.
- Input: ID izdelka
- Returns: Ime, opis, kratek opis, referenca, cena, količina na zalogi, aktivni status, SEO polja (meta naslov, meta opis, meta ključne besede)
- API permission:
products(GET)
Update Product Content
Posodobite opis in/ali kratek opis izdelka, z popolno večjezično podporo.
- Inputs: ID izdelka, opis (neobvezno), kratek opis (neobvezno), ID jezika (neobvezno — privzeto na primarni jezik trgovine)
- Returns: Potrditev s seznamom posodobljenih polj
- API permission:
products(GET + PUT)
AI ohranja vsebino v drugih jezikih, ko posodablja določen jezik. Na primer, posodobitev francoskega opisa ne bo vplivala na angleško različico.
Update Product SEO
Posodobite SEO polja izdelka, z večjezično podporo.
- Inputs: ID izdelka, meta naslov (neobvezno), meta opis (neobvezno), meta ključne besede (neobvezno), ID jezika (neobvezno)
- Returns: Potrditev s posodobljenimi SEO vrednostmi
- API permission:
products(GET + PUT)
Orders
Get Order by Reference
Poiščite določen naročilo z uporabo njegove referenčne številke (npr., ABCDEF123).
- Input: Referenca naročila
- Returns: Popolne podrobnosti naročila, vključno z datumom, statusom, skupnim zneskom, načinom plačila, informacijami o dostavi in seznamom izdelkov
- API permission:
orders(GET),order_details(GET),order_states(GET)
Get Orders by Email
Pridobite vsa naročila, ki jih je oddala določena stranka.
- Inputs: E-pošta stranke, omejitev (neobvezno — privzeto na 10)
- Returns: Seznam naročil s popolnimi podrobnostmi, skupno število
- API permission:
orders(GET),order_details(GET),order_states(GET),customers(GET)
Get Last Order
Pridobite najnovejše naročilo za določeno stranko.
- Input: E-pošta stranke
- Returns: Najnovejše naročilo s popolnimi podrobnostmi ali null, če naročila niso bila najdena
- API permission:
orders(GET),order_details(GET),order_states(GET),customers(GET)
Update Order Status
Spremenite status naročila (npr., označite kot odposlano, označite kot dostavljeno).
- Inputs: ID naročila, nov ID stanja naročila, pošlji e-poštno obvestilo (neobvezno — privzeto ne)
- Returns: Potrditev z novim statusom in ali je bila e-pošta poslana
- API permission:
order_histories(GET + POST)
Sprememba statusa naročila lahko sproži e-poštna obvestila strankam, če je možnost sendEmail omogočena. Prepričajte se, da se uporablja pravilen status.
Customers
Get Customer
Poiščite stranko po njenem e-poštnem naslovu.
- Input: E-pošta stranke
- Returns: ID stranke, ime, priimek, e-pošta, datum rojstva, status novice, datum registracije, opombe
- API permission:
customers(GET)
Update Customer
Posodobite informacije o profilu stranke.
- Inputs: ID stranke, ime (neobvezno), priimek (neobvezno), e-pošta (neobvezno), opombe (neobvezno)
- Returns: Potrditev s seznamom posodobljenih polj
- API permission:
customers(GET + PUT)
Configuration
Get Languages
Naštejte vse jezike, ki so konfigurirani v vaši PrestaShop trgovini.
- No input required
- Returns: Seznam jezikov z ID-jem, imenom in ISO kodo (npr.,
fr,en,de) - API permission:
languages(GET)
Ta akcija se uporablja interno z AI pri izvajanju večjezičnih posodobitev izdelkov, da se zagotovi, da se uporablja pravilen ID jezika.
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 — Konfigurirajte potrebna dovoljenja za spletne storitve
- Webhooks & Skills — Samodejno sprožite te akcije ob dogodkih v trgovini