API Dovoljenja
Da odklenete polni potencial AI SmartTalk — kot so iskanje naročil, posodabljanje opisov izdelkov ali upravljanje s strankami — morate konfigurirati PrestaShop Webservice API žeton z ustreznimi dovoljenji.
Ta korak je obvezen, če želite uporabljati AI Actions (SmartFlow). Brez tega lahko vaš AI asistent še vedno odgovarja na vprašanja na podlagi sinhroniziranega znanja, vendar ne bo mogel dostopati do podatkov trgovine v realnem času.
1. Omogočanje Webservice
- Pojdite na Napredne nastavitve > Webservice
- Omogočite PrestaShopov webservice
- Kliknite Shrani
2. Ustvarjanje API ključa
- Na strani Webservice kliknite Dodaj nov webservice ključ
- Izpolnite obrazec:
- Ključ: Kliknite Generiraj, da ustvarite varen žeton, ali vnesite svojega
- Opis ključa:
AI SmartTalk - Status: Omogočeno
- Nastavite dovoljenja, kot je opisano spodaj
- Kliknite Shrani
Kopirajte in shranite API ključ — potrebovali ga boste pri konfiguraciji integracije v AI SmartTalk.
3. Zahtevana dovoljenja
V razdelku dovoljenj vašega API ključa omogočite naslednje vire:
| Vir | GET | PUT | POST | Opis |
|---|---|---|---|---|
| products | Da | Da | — | Preberite podrobnosti o izdelkih, posodobite opise in SEO |
| orders | Da | — | — | Iščite naročila po referenci ali stranki |
| order_details | Da | — | — | Ogled izdelkov znotraj naročila |
| order_states | Da | — | — | Preberite oznake statusov naročil |
| order_histories | Da | — | Da | Preberite zgodovino statusov, dodajte spremembe statusa |
| customers | Da | Da | — | Iščite in posodobite informacije o strankah |
| languages | Da | — | — | Naštejte razpoložljive jezike trgovine |
Preverite samo dovoljenja, navedena zgoraj. Ni potrebno dodeliti dostopa do drugih virov.
4. Kaj se uporablja za vsak vir
Izdelki (branje + pisanje)
- Branje: Pridobite podrobnosti o izdelkih — ime, opis, kratek opis, cena, referenca, zaloga, SEO polja (meta naslov, meta opis, meta ključne besede)
- Pisanje: Posodobite opise izdelkov, kratke opise in SEO polja z polno večjezično podporo
Naročila (samo branje)
- Iščite naročilo po številki reference
- Naštejte naročila za določeno stranko (po e-pošti)
- Pridobite najnovejše naročilo za stranko
Podrobnosti naročila (samo branje)
- Ogled izdelkov znotraj naročila: ime, referenca, količina, enotna cena
Stanja naročil (samo branje)
- Pridobite človeško berljivo oznako za vsak status naročila (npr. "Plačilo sprejeto", "Poslano")
Zgodovine naročil (branje + ustvarjanje)
- Branje: Ogled zgodovine sprememb statusa naročila
- Ustvarjanje: Dodajte novo spremembo statusa naročilu (npr. označite kot poslano), z možnostjo obvestila po e-pošti stranki
Stranke (branje + pisanje)
- Branje: Iščite stranko po e-pošti ali ID-ju — pridobite ime, e-pošto, datum registracije, status novice, opombe
- Pisanje: Posodobite informacije o strankah (ime, priimek, e-pošta, opombe)
Jeziki (samo branje)
- Naštejte vse jezike, konfigurirane v vaši trgovini (uporablja se za večjezične posodobitve izdelkov)
5. Vnos API ključa v AI SmartTalk
Ko je vaš Webservice ključ ustvarjen in konfiguriran:
- Pojdite na konfiguracijo modula AI SmartTalk v PrestaShopu
- API ključ se običajno prenese med povezovanjem OAuth
- Če ga potrebujete posodobiti, pojdite na nadzorno ploščo AI SmartTalk > Integracija > PrestaShop in posodobite Webservice žeton
Za več-spletne nastavitve lahko ima vsaka stran svoj Webservice API ključ, konfiguriran neodvisno.
Naslednji koraki
- Sinhronizirajte podatke vaše trgovine — Potisnite svoj katalog izdelkov v AI
- Poglejte, kaj lahko AI stori — Polno sklicevanje na razpoložljive akcije