API Leidimai
Norint atskleisti visą AI SmartTalk potencialą — pavyzdžiui, ieškoti užsakymų, atnaujinti produktų aprašymus ar valdyti klientus — reikia sukonfigūruoti PrestaShop Webservice API raktą su tinkamais leidimais.
Šis žingsnis yra privalomas, jei norite naudoti AI Actions (SmartFlow). Be jo, jūsų AI asistentas vis tiek gali atsakyti į klausimus, remdamasis sinchronizuotomis žiniomis, tačiau negalės pasiekti realaus laiko parduotuvės duomenų.
1. Webservice įgalinimas
- Eikite į Išplėstiniai parametrai > Webservice
- Įgalinkite PrestaShop webservice
- Paspauskite Išsaugoti
2. API rakto kūrimas
- Webservice puslapyje paspauskite Pridėti naują webservice raktą
- Užpildykite formą:
- Raktas: Paspauskite Generuoti, kad sukurtumėte saugų raktą, arba įveskite savo
- Rakto aprašymas:
AI SmartTalk - Būsena: Įgalinta
- Nustatykite leidimus, kaip aprašyta žemiau
- Paspauskite Išsaugoti
Nukopijuokite ir išsaugokite API raktą — jo prireiks konfigūruojant integraciją AI SmartTalk.
3. Reikalingi leidimai
API rakto leidimų skyriuje įgalinkite šiuos išteklius:
| Išteklius | GET | PUT | POST | Aprašymas |
|---|---|---|---|---|
| products | Taip | Taip | — | Perskaityti produktų detales, atnaujinti aprašymus ir SEO |
| orders | Taip | — | — | Ieškoti užsakymų pagal nuorodą arba klientą |
| order_details | Taip | — | — | Peržiūrėti produktus užsakyme |
| order_states | Taip | — | — | Perskaityti užsakymo būsenos etiketes |
| order_histories | Taip | — | Taip | Perskaityti būsenos istoriją, pridėti būsenos pakeitimus |
| customers | Taip | Taip | — | Ieškoti ir atnaujinti klientų informaciją |
| languages | Taip | — | — | Išvardyti prieinamas parduotuvės kalbas |
Žymėkite tik aukščiau išvardytus leidimus. Nereikia suteikti prieigos prie kitų išteklių.
4. Kiekvieno ištekliaus naudojimo paskirtis
Produktai (skaityti + rašyti)
- Skaityti: Gauti produktų detales — pavadinimą, aprašymą, trumpą aprašymą, kainą, nuorodą, atsargų kiekį, SEO laukus (meta pavadinimas, meta aprašymas, meta raktiniai žodžiai)
- Rašyti: Atnaujinti produktų aprašymus, trumpus aprašymus ir SEO laukus su pilna daugialypės kalbos parama
Užsakymai (tik skaityti)
- Ieškoti užsakymo pagal jo nuorodos numerį
- Išvardyti užsakymus tam tikram klientui (pagal el. paštą)
- Gauti naujausią užsakymą klientui
Užsakymo detalės (tik skaityti)
- Peržiūrėti produktus užsakyme: pavadinimą, nuorodą, kiekį, vieneto kainą
Užsakymo būsenos (tik skaityti)
- Gauti žmogui suprantamą etiketę kiekvienai užsakymo būsenai (pvz., "Mokėjimas priimtas", "Išsiųsta")
Užsakymo istorijos (skaityti + kurti)
- Skaityti: Peržiūrėti užsakymo būsenos pakeitimų istoriją
- Kurti: Pridėti naują būsenos pakeitimą užsakymui (pvz., pažymėti kaip išsiųstą), su pasirenkamu el. pašto pranešimu klientui
Klientai (skaityti + rašyti)
- Skaityti: Ieškoti kliento pagal el. paštą arba ID — gauti vardą, el. paštą, registracijos datą, naujienlaiškio būseną, pastabas
- Rašyti: Atnaujinti klientų informaciją (vardas, pavardė, el. paštas, pastabos)
Kalbos (tik skaityti)
- Išvardyti visas kalbas, sukonfigūruotas jūsų parduotuvėje (naudojama daugialypės kalbos produktų atnaujinimams)
5. API rakto įvedimas AI SmartTalk
Kai jūsų Webservice raktas sukurtas ir sukonfigūruotas:
- Eikite į AI SmartTalk modulio konfigūraciją PrestaShop
- API raktas paprastai perduodamas per OAuth ryšį
- Jei reikia jį atnaujinti, eikite į savo AI SmartTalk valdymo skydelį > Integracija > PrestaShop ir atnaujinkite Webservice raktą
Dėl daugiapakopės konfigūracijos, kiekviena svetainė gali turėti savo Webservice API raktą, sukonfigūruotą nepriklausomai.
Kiti žingsniai
- Sinchronizuokite savo parduotuvės duomenis — Perkelkite savo produktų katalogą į AI
- Žiūrėkite, ką gali AI — Pilnas prieinamų veiksmų sąrašas