API Oprávnenia
Aby ste odomkli plný potenciál AI SmartTalk — ako je vyhľadávanie objednávok, aktualizácia popisov produktov alebo správa zákazníkov — musíte nakonfigurovať API token PrestaShop Webservice s správnymi oprávneniami.
Tento krok je povinný, ak chcete používať AI Actions (SmartFlow). Bez toho môže váš AI asistent stále odpovedať na otázky na základe synchronizovaných znalostí, ale nebude môcť pristupovať k dátam obchodu v reálnom čase.
1. Povolenie Webservice
- Prejdite na Pokročilé parametre > Webservice
- Povoliť webservice PrestaShop
- Kliknite na Uložiť
2. Vytvorenie API kľúča
- Na stránke Webservice kliknite na Pridať nový webservice kľúč
- Vyplňte formulár:
- Kľúč: Kliknite na Generovať na vytvorenie zabezpečeného tokenu, alebo zadajte svoj vlastný
- Popis kľúča:
AI SmartTalk - Stav: Povolené
- Nastavte oprávnenia, ako je popísané nižšie
- Kliknite na Uložiť
Skopírujte a uložte API kľúč — budete ho potrebovať pri konfigurácii integrácie v AI SmartTalk.
3. Povinné oprávnenia
V sekcii oprávnení vášho API kľúča povolte nasledujúce zdroje:
| Zdroje | GET | PUT | POST | Popis |
|---|---|---|---|---|
| produkty | Áno | Áno | — | Čítať podrobnosti o produktoch, aktualizovať popisy a SEO |
| objednávky | Áno | — | — | Vyhľadávať objednávky podľa referencie alebo zákazníka |
| podrobnosti objednávky | Áno | — | — | Zobraziť produkty v rámci objednávky |
| stavy objednávok | Áno | — | — | Čítať štítky stavov objednávok |
| histórie objednávok | Áno | — | Áno | Čítať históriu stavov, pridať zmeny stavov |
| zákazníci | Áno | Áno | — | Vyhľadávať a aktualizovať informácie o zákazníkoch |
| jazyky | Áno | — | — | Zoznam dostupných jazykov obchodu |
Zaškrtnite iba oprávnenia uvedené vyššie. Nie je potrebné poskytovať prístup k iným zdrojom.
4. Na čo sa každý zdroj používa
Produkty (čítanie + zápis)
- Čítať: Získať podrobnosti o produktoch — názov, popis, krátky popis, cena, referencia, sklad, SEO polia (meta názov, meta popis, meta kľúčové slová)
- Zápis: Aktualizovať popisy produktov, krátke popisy a SEO polia s plnou viacjazyčnou podporou
Objednávky (iba čítanie)
- Vyhľadávať objednávku podľa jej referenčného čísla
- Zoznam objednávok pre konkrétneho zákazníka (podľa e-mailu)
- Získať najnovšiu objednávku pre zákazníka
Podrobnosti objednávky (iba čítanie)
- Zobraziť produkty v rámci objednávky: názov, referencia, množstvo, cena za jednotku
Stavy objednávok (iba čítanie)
- Získať čitateľný štítok pre každý stav objednávky (napr. "Platba prijatá", "Odoslané")
Histórie objednávok (čítanie + vytvorenie)
- Čítať: Zobraziť históriu zmien stavov objednávky
- Vytvoriť: Pridať novú zmenu stavu do objednávky (napr. označiť ako odoslané), s voliteľným e-mailovým upozornením pre zákazníka
Zákazníci (čítanie + zápis)
- Čítať: Vyhľadávať zákazníka podľa e-mailu alebo ID — získať meno, e-mail, dátum registrácie, stav newslettera, poznámky
- Zápis: Aktualizovať informácie o zákazníkoch (meno, priezvisko, e-mail, poznámky)
Jazyky (iba čítanie)
- Zoznam všetkých jazykov nakonfigurovaných vo vašom obchode (používané na viacjazyčné aktualizácie produktov)
5. Zadaní API kľúča v AI SmartTalk
Akonáhle je váš Webservice kľúč vytvorený a nakonfigurovaný:
- Prejdite na konfiguráciu modulu AI SmartTalk v PrestaShop
- API kľúč sa zvyčajne prenáša počas pripojenia OAuth
- Ak ho potrebujete aktualizovať, prejdite na svoj AI SmartTalk dashboard > Integrácia > PrestaShop a aktualizujte Webservice token
Pre multi-site nastavenia môže mať každý web svoj vlastný Webservice API kľúč nakonfigurovaný nezávisle.
Ďalšie kroky
- Synchronizujte dáta svojho obchodu — Posuňte svoj produktový katalóg do AI
- Pozrite sa, čo AI môže robiť — Kompletný prehľad dostupných akcií