API Dozvole
Kako biste otključali puni potencijal AI SmartTalk — kao što su pretraživanje narudžbi, ažuriranje opisa proizvoda ili upravljanje kupcima — potrebno je konfigurirati PrestaShop Webservice API token s pravim dozvolama.
Ovaj korak je obavezan ako želite koristiti AI Actions (SmartFlow). Bez toga, vaš AI asistent može odgovarati na pitanja na temelju sinkroniziranog znanja, ali neće moći pristupiti podacima trgovine u stvarnom vremenu.
1. Omogućavanje Webservisa
- Idite na Napredne postavke > Webservis
- Omogućite PrestaShopov webservis
- Kliknite Spremi
2. Kreiranje API ključa
- Na stranici Webservisa, kliknite Dodaj novi webservis ključ
- Ispunite obrazac:
- Ključ: Kliknite Generiraj za stvaranje sigurnog tokena, ili unesite vlastiti
- Opis ključa:
AI SmartTalk - Status: Omogućeno
- Postavite dozvole kao što je opisano u nastavku
- Kliknite Spremi
Kopirajte i spremite API ključ — trebat će vam prilikom konfiguriranja integracije u AI SmartTalk.
3. Potrebne dozvole
U odjeljku dozvola vašeg API ključa, omogućite sljedeće resurse:
| Resurs | GET | PUT | POST | Opis |
|---|---|---|---|---|
| proizvodi | Da | Da | — | Čitanje detalja proizvoda, ažuriranje opisa i SEO |
| narudžbe | Da | — | — | Pretraživanje narudžbi prema referenci ili kupcu |
| detalji_narudžbe | Da | — | — | Pregled proizvoda unutar narudžbe |
| stanja_narudžbe | Da | — | — | Čitanje oznaka statusa narudžbe |
| historije_narudžbi | Da | — | Da | Čitanje povijesti statusa, dodavanje promjena statusa |
| kupci | Da | Da | — | Pretraživanje i ažuriranje informacija o kupcima |
| jezici | Da | — | — | Popis dostupnih jezika trgovine |
Samo označite dozvole navedene iznad. Nema potrebe za davanjem pristupa drugim resursima.
4. Što se koristi za svaki resurs
Proizvodi (čitanje + pisanje)
- Čitanje: Dohvatite detalje proizvoda — naziv, opis, kratak opis, cijena, referenca, zaliha, SEO polja (meta naslov, meta opis, meta ključne riječi)
- Pisanje: Ažurirajte opise proizvoda, kratke opise i SEO polja s punom višelingvalnom podrškom
Narudžbe (samo čitanje)
- Pretražite narudžbu prema njenom referentnom broju
- Popis narudžbi za određenog kupca (prema e-pošti)
- Dohvatite najnoviju narudžbu za kupca
Detalji narudžbe (samo čitanje)
- Pregledajte proizvode unutar narudžbe: naziv, referenca, količina, cijena po jedinici
Stanja narudžbe (samo čitanje)
- Dohvatite ljudski čitljive oznake za svaki status narudžbe (npr., "Plaćanje prihvaćeno", "Poslano")
Historije narudžbi (čitanje + kreiranje)
- Čitanje: Pregledajte povijest promjena statusa narudžbe
- Kreiranje: Dodajte novu promjenu statusa narudžbi (npr., označite kao poslanu), uz opcionalnu obavijest e-poštom kupcu
Kupci (čitanje + pisanje)
- Čitanje: Pretražite kupca prema e-pošti ili ID-u — dohvatite ime, e-poštu, datum registracije, status pretplate na bilten, bilješke
- Pisanje: Ažurirajte informacije o kupcu (ime, prezime, e-pošta, bilješke)
Jezici (samo čitanje)
- Popis svih jezika konfiguriranih u vašoj trgovini (koristi se za višelingvalna ažuriranja proizvoda)
5. Unos API ključa u AI SmartTalk
Kada je vaš Webservis ključ kreiran i konfiguriran:
- Idite na konfiguraciju AI SmartTalk modula u PrestaShopu
- API ključ se obično prenosi tijekom OAuth veze
- Ako ga trebate ažurirati, idite na svoju AI SmartTalk nadzornu ploču > Integracija > PrestaShop i ažurirajte Webservis token
Za multi-site postavke, svaka stranica može imati svoj vlastiti Webservice API ključ konfiguriran neovisno.
Sljedeći koraci
- Sinkronizirajte podatke svoje trgovine — Pošaljite svoj katalog proizvoda AI-u
- Pogledajte što AI može učiniti — Potpuna referenca dostupnih radnji