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)

namig

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)

opozorilo

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)

informacija

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