AI Actions Reference
Kada je povezan s odgovarajućim API dozvolama, vaš AI asistent može izvoditi sljedeće radnje na vašoj PrestaShop trgovini u stvarnom vremenu. Ove radnje su dostupne u SmartFlow radnim tokovima i također se mogu koristiti od strane AI tijekom razgovora s vašim kupcima.
Products
Get Product
Preuzmite potpune detalje o proizvodu prema njegovom ID-u.
- Input: ID proizvoda
- Returns: Ime, opis, kratki opis, referenca, cijena, količina na skladištu, aktivni status, SEO polja (meta naslov, meta opis, meta ključne riječi)
- API permission:
products(GET)
Update Product Content
Ažurirajte opis i/ili kratki opis proizvoda, uz punu podršku za više jezika.
- Inputs: ID proizvoda, opis (opcionalno), kratki opis (opcionalno), ID jezika (opcionalno — prema zadanim postavkama koristi primarni jezik trgovine)
- Returns: Potvrda s popisom ažuriranih polja
- API permission:
products(GET + PUT)
AI čuva sadržaj na drugim jezicima prilikom ažuriranja određenog jezika. Na primjer, ažuriranje francuskog opisa neće utjecati na englesku verziju.
Update Product SEO
Ažurirajte SEO polja proizvoda, uz podršku za više jezika.
- Inputs: ID proizvoda, meta naslov (opcionalno), meta opis (opcionalno), meta ključne riječi (opcionalno), ID jezika (opcionalno)
- Returns: Potvrda s ažuriranim SEO vrijednostima
- API permission:
products(GET + PUT)
Orders
Get Order by Reference
Potražite određenu narudžbu koristeći njen referentni broj (npr., ABCDEF123).
- Input: Referenca narudžbe
- Returns: Potpuni detalji narudžbe uključujući datum, status, ukupni iznos, način plaćanja, informacije o dostavi i popis proizvoda
- API permission:
orders(GET),order_details(GET),order_states(GET)
Get Orders by Email
Preuzmite sve narudžbe koje je postavio određeni kupac.
- Inputs: Email kupca, limit (opcionalno — prema zadanim postavkama 10)
- Returns: Popis narudžbi s punim detaljima, ukupni broj
- API permission:
orders(GET),order_details(GET),order_states(GET),customers(GET)
Get Last Order
Dobijte najnoviju narudžbu za određenog kupca.
- Input: Email kupca
- Returns: Najnovija narudžba s punim detaljima, ili null ako nema pronađenih narudžbi
- API permission:
orders(GET),order_details(GET),order_states(GET),customers(GET)
Update Order Status
Promijenite status narudžbe (npr., označite kao otpremljeno, označite kao isporučeno).
- Inputs: ID narudžbe, novi ID statusa narudžbe, pošaljite email obavijest (opcionalno — prema zadanim postavkama ne)
- Returns: Potvrda s novim statusom i informacijom je li email poslan
- API permission:
order_histories(GET + POST)
Promjena statusa narudžbe može pokrenuti obavijesti putem emaila kupcima ako je opcija sendEmail omogućena. Provjerite je li ispravan status primijenjen.
Customers
Get Customer
Potražite kupca prema njegovoj email adresi.
- Input: Email kupca
- Returns: ID kupca, ime, prezime, email, datum rođenja, status pretplate na newsletter, datum registracije, bilješke
- API permission:
customers(GET)
Update Customer
Ažurirajte profilne informacije kupca.
- Inputs: ID kupca, ime (opcionalno), prezime (opcionalno), email (opcionalno), bilješke (opcionalno)
- Returns: Potvrda s popisom ažuriranih polja
- API permission:
customers(GET + PUT)
Configuration
Get Languages
Popis svih jezika konfiguriranih na vašoj PrestaShop trgovini.
- No input required
- Returns: Popis jezika s ID-om, imenom i ISO kodom (npr.,
fr,en,de) - API permission:
languages(GET)
Ova radnja se koristi interno od strane AI prilikom izvođenja višelingvalnih ažuriranja proizvoda, kako bi se osiguralo da se koristi ispravan 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 potrebne Webservice dozvole
- Webhooks & Skills — Automatski pokrenite ove radnje na događaje u trgovini