API-oikeudet
Jotta voit hyödyntää AI SmartTalkin täyden potentiaalin — kuten tilausten tarkistamisen, tuotekuvausten päivittämisen tai asiakashallinnan — sinun on määritettävä PrestaShop Webservice API -token oikeilla oikeuksilla.
Tämä vaihe on välttämätön, jos haluat käyttää AI-toimia (SmartFlow). Ilman sitä AI-avustajasi voi silti vastata kysymyksiin synkronoidun tiedon perusteella, mutta se ei voi käyttää reaaliaikaisia myymälätietoja.
1. Webservice-ominaisuuden aktivointi
- Siirry kohtaan Lisäasetukset > Webservice
- Ota käyttöön PrestaShopin webservice
- Napsauta Tallenna
2. API-avaimen luominen
- Webservice-sivulla napsauta Lisää uusi webservice-avain
- Täytä lomake:
- Avain: Napsauta Generoi luodaksesi turvallisen tokenin tai syötä oma
- Avainkuvaus:
AI SmartTalk - Tila: Käytössä
- Aseta oikeudet alla olevan kuvauksen mukaan
- Napsauta Tallenna
Kopioi ja tallenna API-avain — tarvitset sitä, kun määrität integraatiota AI SmartTalkissa.
3. Vaaditut oikeudet
API-avaimesi oikeusosiossa ota käyttöön seuraavat resurssit:
| Resurssi | GET | PUT | POST | Kuvaus |
|---|---|---|---|---|
| tuotteet | Kyllä | Kyllä | — | Lue tuotedetails, päivitä kuvaukset ja SEO |
| tilaukset | Kyllä | — | — | Tarkista tilaukset viitteen tai asiakkaan mukaan |
| tilaus_tiedot | Kyllä | — | — | Näytä tuotteet tilauksessa |
| tilaus_tilat | Kyllä | — | — | Lue tilauksen tila-etiketit |
| tilaus_historian | Kyllä | — | Kyllä | Lue tilan historia, lisää tilamuutoksia |
| asiakkaat | Kyllä | Kyllä | — | Tarkista ja päivitä asiakastiedot |
| kielet | Kyllä | — | — | Listaa käytettävissä olevat myymäläkielet |
Tarkista vain yllä luetellut oikeudet. Ei ole tarpeen myöntää pääsyä muihin resursseihin.
4. Mitä kukin resurssi käyttää
Tuotteet (luku + kirjoitus)
- Luku: Hae tuotedetails — nimi, kuvaus, lyhyt kuvaus, hinta, viite, varasto, SEO-kentät (metaotsikko, meta-kuvaus, meta-avainsanat)
- Kirjoitus: Päivitä tuotekuvaukset, lyhyet kuvaukset ja SEO-kentät täydellä monikielisellä tuella
Tilaukset (vain luku)
- Tarkista tilaus sen viitenumeron mukaan
- Listaa tilaukset tietylle asiakkaalle (sähköpostin mukaan)
- Hae asiakkaan viimeisin tilaus
Tilaustiedot (vain luku)
- Näytä tuotteet tilauksessa: nimi, viite, määrä, yksikköhinta
Tilaustilat (vain luku)
- Hae jokaisen tilan ihmislukeminen etiketti (esim. "Maksu hyväksytty", "Lähetetty")
Tilaushistoriat (luku + luonti)
- Luku: Näytä tilauksen tilamuutosten historia
- Luo: Lisää uusi tilamuutos tilaukseen (esim. merkitse lähetetyksi), valinnaisella sähköpostiviestillä asiakkaalle
Asiakkaat (luku + kirjoitus)
- Luku: Tarkista asiakas sähköpostin tai ID:n mukaan — hae nimi, sähköposti, rekisteröintipäivämäärä, uutiskirjeen tila, muistiinpanot
- Kirjoitus: Päivitä asiakastiedot (etunimi, sukunimi, sähköposti, muistiinpanot)
Kielet (vain luku)
- Listaa kaikki myymälässäsi määritetyt kielet (käytetään monikielisiin tuote päivityksiin)
5. API-avaimen syöttäminen AI SmartTalkiin
Kun Webservice-avaimesi on luotu ja määritetty:
- Siirry AI SmartTalk -moduulin asetuksiin PrestaShopissa
- API-avain siirretään tyypillisesti OAuth-yhteyden aikana
- Jos sinun tarvitsee päivittää se, siirry AI SmartTalk -ohjauspaneeliisi > Integraatio > PrestaShop ja päivitä Webservice-token
Monisivustokokoonpanoissa jokaisella sivustolla voi olla oma Webservice API -avain määritettynä itsenäisesti.
Seuraavat vaiheet
- Synkronoi myymälätietosi — Siirrä tuotekatalogisi AI:hin
- Katso, mitä AI voi tehdä — Täydellinen viittaus saatavilla oleviin toimiin