AI Actions Reference
Kun yhteys on muodostettu oikeilla API-oikeuksilla, AI-avustajasi voi suorittaa seuraavat toiminnot PrestaShop-kaupassasi reaaliajassa. Nämä toiminnot ovat saatavilla SmartFlow-työnkuluissa ja niitä voidaan myös käyttää AI:n toimesta keskusteluissa asiakkaidesi kanssa.
Tuotteet
Hae tuote
Hae tuotteen täydelliset tiedot sen ID:n perusteella.
- Syöte: Tuotteen ID
- Palauttaa: Nimi, kuvaus, lyhyt kuvaus, viite, hinta, varastomäärä, aktiivinen tila, SEO-kentät (metaotsikko, meta-kuvaus, meta-avainsanat)
- API-oikeus:
products(GET)
Päivitä tuotteen sisältö
Päivitä tuotteen kuvaus ja/tai lyhyt kuvaus, täydellä monikielisellä tuella.
- Syötteet: Tuotteen ID, kuvaus (valinnainen), lyhyt kuvaus (valinnainen), kieli-ID (valinnainen — oletuksena kaupan ensisijainen kieli)
- Palauttaa: Vahvistus päivitettyjen kenttien luettelolla
- API-oikeus:
products(GET + PUT)
AI säilyttää sisällön muilla kielillä, kun päivitetään tiettyä kieltä. Esimerkiksi ranskalaisen kuvauksen päivittäminen ei vaikuta englanninkieliseen versioon.
Päivitä tuotteen SEO
Päivitä tuotteen SEO-kentät, monikielisellä tuella.
- Syötteet: Tuotteen ID, metaotsikko (valinnainen), meta-kuvaus (valinnainen), meta-avainsanat (valinnainen), kieli-ID (valinnainen)
- Palauttaa: Vahvistus päivitettyjen SEO-arvojen kanssa
- API-oikeus:
products(GET + PUT)
Tilaukset
Hae tilaus viitteen mukaan
Etsi tietty tilaus sen viitenumeron avulla (esim. ABCDEF123).
- Syöte: Tilausviite
- Palauttaa: Täydelliset tilauksen tiedot, mukaan lukien päivämäärä, tila, kokonaismäärä, maksutapa, toimitustiedot ja tuotteiden luettelo
- API-oikeus:
orders(GET),order_details(GET),order_states(GET)
Hae tilaukset sähköpostin mukaan
Hae kaikki tilaukset, jotka on tehty tietyn asiakkaan toimesta.
- Syötteet: Asiakkaan sähköposti, raja (valinnainen — oletuksena 10)
- Palauttaa: Luettelo tilauksista täydellisine tietoineen, kokonaismäärä
- API-oikeus:
orders(GET),order_details(GET),order_states(GET),customers(GET)
Hae viimeisin tilaus
Hae viimeisin tilaus tietylle asiakkaalle.
- Syöte: Asiakkaan sähköposti
- Palauttaa: Viimeisin tilaus täydellisine tietoineen, tai null, jos tilauksia ei löydy
- API-oikeus:
orders(GET),order_details(GET),order_states(GET),customers(GET)
Päivitä tilauksen tila
Vaihda tilauksen tila (esim. merkitse lähetetyksi, merkitse toimitetuksi).
- Syötteet: Tilaus ID, uusi tilauksen tila ID, lähetä sähköpostivaroitus (valinnainen — oletuksena ei)
- Palauttaa: Vahvistus uudella tilalla ja tiedot siitä, lähetettiinkö sähköposti
- API-oikeus:
order_histories(GET + POST)
Tilauksen tilan muuttaminen voi laukaista asiakassähköpostivaroituksia, jos sendEmail-vaihtoehto on käytössä. Varmista, että oikeaa tilaa käytetään.
Asiakkaat
Hae asiakas
Etsi asiakas sähköpostiosoitteen perusteella.
- Syöte: Asiakkaan sähköposti
- Palauttaa: Asiakkaan ID, etunimi, sukunimi, sähköposti, syntymäpäivä, uutiskirjeen tila, rekisteröintipäivämäärä, muistiinpanot
- API-oikeus:
customers(GET)
Päivitä asiakas
Päivitä asiakkaan profiilitiedot.
- Syötteet: Asiakkaan ID, etunimi (valinnainen), sukunimi (valinnainen), sähköposti (valinnainen), muistiinpanot (valinnainen)
- Palauttaa: Vahvistus päivitettyjen kenttien luettelolla
- API-oikeus:
customers(GET + PUT)
Konfiguraatio
Hae kielet
Listaa kaikki PrestaShop-kaupassasi konfiguroidut kielet.
- Ei syötettä vaadita
- Palauttaa: Luettelo kielistä, joissa on ID, nimi ja ISO-koodi (esim.
fr,en,de) - API-oikeus:
languages(GET)
Tätä toimintoa käytetään sisäisesti AI:n toimesta monikielisten tuotepäivitysten suorittamisessa, jotta varmistetaan oikean kieli-ID:n käyttö.
Yhteenvetotaulukko
| Toiminto | Kategoria | Lue | Kirjoita |
|---|---|---|---|
| Hae tuote | Tuotteet | Kyllä | — |
| Päivitä tuotteen sisältö | Tuotteet | Kyllä | Kyllä |
| Päivitä tuotteen SEO | Tuotteet | Kyllä | Kyllä |
| Hae tilaus viitteen mukaan | Tilaukset | Kyllä | — |
| Hae tilaukset sähköpostin mukaan | Tilaukset | Kyllä | — |
| Hae viimeisin tilaus | Tilaukset | Kyllä | — |
| Päivitä tilauksen tila | Tilaukset | — | Kyllä |
| Hae asiakas | Asiakkaat | Kyllä | — |
| Päivitä asiakas | Asiakkaat | Kyllä | Kyllä |
| Hae kielet | Konfiguraatio | Kyllä | — |
Liittyvät
- API-oikeudet — Määritä tarvittavat Webservice-oikeudet
- Webhooks & Taidot — Käynnistä nämä toiminnot automaattisesti kaupan tapahtumien yhteydessä