API Jogosultságok
Az AI SmartTalk teljes potenciáljának kiaknázásához — például a rendelések megkereséséhez, a termékleírások frissítéséhez vagy az ügyfelek kezeléséhez — konfigurálnia kell egy PrestaShop Webservice API tokent a megfelelő jogosultságokkal.
Ez a lépés kötelező, ha használni szeretné a AI Actions (SmartFlow) funkciót. Enélkül az AI asszisztense még válaszolhat a szinkronizált tudás alapján feltett kérdésekre, de nem lesz képes valós idejű boltadatokhoz hozzáférni.
1. A Webservice engedélyezése
- Lépjen a Haladó paraméterek > Webservice menüpontra
- Engedélyezze a PrestaShop webservice-t
- Kattintson a Mentés gombra
2. API kulcs létrehozása
- A Webservice oldalon kattintson az Új webservice kulcs hozzáadása gombra
- Töltse ki a űrlapot:
- Kulcs: Kattintson a Generálás gombra egy biztonságos token létrehozásához, vagy adja meg a sajátját
- Kulcs leírása:
AI SmartTalk - Állapot: Engedélyezve
- Állítsa be a jogosultságokat az alábbiak szerint
- Kattintson a Mentés gombra
Másolja és mentse el az API kulcsot — szüksége lesz rá az integráció konfigurálásához az AI SmartTalk-ban.
3. Kötelező jogosultságok
Az API kulcs jogosultságai szakaszában engedélyezze az alábbi erőforrásokat:
| Erőforrás | GET | PUT | POST | Leírás |
|---|---|---|---|---|
| products | Igen | Igen | — | Termékadatok olvasása, leírások és SEO frissítése |
| orders | Igen | — | — | Rendelések megkeresése hivatkozás vagy ügyfél alapján |
| order_details | Igen | — | — | Termékek megtekintése egy rendelésen belül |
| order_states | Igen | — | — | Rendelési állapot címkék olvasása |
| order_histories | Igen | — | Igen | Állapot előzmények olvasása, állapotváltozások hozzáadása |
| customers | Igen | Igen | — | Ügyféladatok megkeresése és frissítése |
| languages | Igen | — | — | Elérhető bolt nyelvek listázása |
Csak a fenti jogosultságokat jelölje be. Nincs szükség más erőforrásokhoz való hozzáférés engedélyezésére.
4. Milyen célra használhatóak az egyes erőforrások
Termékek (olvasás + írás)
- Olvasás: Termékadatok lekérése — név, leírás, rövid leírás, ár, hivatkozás, készlet, SEO mezők (meta cím, meta leírás, meta kulcsszavak)
- Írás: Termékleírások, rövid leírások és SEO mezők frissítése teljes többnyelvű támogatással
Rendelések (csak olvasás)
- Rendelés megkeresése hivatkozási szám alapján
- Rendelések listázása egy adott ügyfél számára (e-mail alapján)
- Legutolsó rendelés lekérése egy ügyfél számára
Rendelés részletei (csak olvasás)
- A rendelésen belüli termékek megtekintése: név, hivatkozás, mennyiség, egységár
Rendelési állapotok (csak olvasás)
- Az egyes rendelési állapotok emberi olvasásra alkalmas címkéjének lekérése (pl. "Fizetés elfogadva", "Kiszállítva")
Rendelési előzmények (olvasás + létrehozás)
- Olvasás: A rendelés állapotváltozásainak előzményeinek megtekintése
- Létrehozás: Új állapotváltozás hozzáadása egy rendeléshez (pl. megjelölés kiszállítva), opcionális e-mail értesítéssel az ügyfél számára
Ügyfelek (olvasás + írás)
- Olvasás: Ügyfél megkeresése e-mail vagy ID alapján — név, e-mail, regisztráció dátuma, hírlevél státusz, megjegyzések lekérése
- Írás: Ügyféladatok frissítése (keresztnév, vezetéknév, e-mail, megjegyzések)
Nyelvek (csak olvasás)
- Az üzletében konfigurált összes nyelv listázása (többnyelvű termékfrissítésekhez használva)
5. Az API kulcs megadása az AI SmartTalk-ban
Miután a Webservice kulcs létrejött és konfigurálva lett:
- Lépjen a PrestaShop AI SmartTalk modul konfigurációjába
- Az API kulcsot általában az OAuth kapcsolaton keresztül továbbítják
- Ha frissítenie kell, lépjen az AI SmartTalk irányítópultjára > Integráció > PrestaShop és frissítse a Webservice tokent
Többhelyszínes beállítások esetén minden helyszín saját Webservice API kulccsal rendelkezhet, amelyet függetlenül konfigurálnak.
Következő lépések
- Szinkronizálja boltadatait — Töltse fel termékkatalógusát az AI-ra
- Nézze meg, mit tud az AI — Az elérhető műveletek teljes hivatkozása