API Oprávnění
Abychom odemkli plný potenciál AI SmartTalk — například pro vyhledávání objednávek, aktualizaci popisů produktů nebo správu zákazníků — je nutné nakonfigurovat token API PrestaShop Webservice s odpovídajícími oprávněními.
Tento krok je povinný, pokud chcete používat AI Actions (SmartFlow). Bez něj může váš AI asistent stále odpovídat na otázky na základě synchronizovaných znalostí, ale nebude schopen přistupovat k datům obchodu v reálném čase.
1. Povolení Webservice
- Přejděte na Pokročilé parametry > Webservice
- Povolit webservice PrestaShopu
- Klikněte na Uložit
2. Vytvoření API klíče
- Na stránce Webservice klikněte na Přidat nový klíč webservice
- Vyplňte formulář:
- Klíč: Klikněte na Generovat pro vytvoření zabezpečeného tokenu, nebo zadejte svůj vlastní
- Popis klíče:
AI SmartTalk - Stav: Povolen
- Nastavte oprávnění, jak je popsáno níže
- Klikněte na Uložit
Zkopírujte a uložte API klíč — budete ho potřebovat při konfiguraci integrace v AI SmartTalk.
3. Požadovaná oprávnění
V sekci oprávnění vašeho API klíče povolte následující zdroje:
| Zdroje | GET | PUT | POST | Popis |
|---|---|---|---|---|
| produkty | Ano | Ano | — | Číst detaily produktů, aktualizovat popisy a SEO |
| objednávky | Ano | — | — | Vyhledávat objednávky podle reference nebo zákazníka |
| detaily_objednávek | Ano | — | — | Zobrazit produkty v rámci objednávky |
| stavy_objednávek | Ano | — | — | Číst štítky stavů objednávek |
| historie_objednávek | Ano | — | Ano | Číst historii stavů, přidávat změny stavů |
| zákazníci | Ano | Ano | — | Vyhledávat a aktualizovat informace o zákaznících |
| jazyky | Ano | — | — | Seznam dostupných jazyků obchodu |
Zaškrtněte pouze oprávnění uvedená výše. Není třeba poskytovat přístup k dalším zdrojům.
4. K čemu se každý zdroj používá
Produkty (čtení + zápis)
- Číst: Získat detaily produktu — název, popis, krátký popis, cena, reference, sklad, SEO pole (meta název, meta popis, meta klíčová slova)
- Zapsat: Aktualizovat popisy produktů, krátké popisy a SEO pole s plnou vícejazyčnou podporou
Objednávky (pouze čtení)
- Vyhledat objednávku podle jejího referenčního čísla
- Seznam objednávek pro konkrétního zákazníka (podle e-mailu)
- Získat nejnovější objednávku pro zákazníka
Detaily objednávek (pouze čtení)
- Zobrazit produkty v rámci objednávky: název, reference, množství, cena za jednotku
Stavy objednávek (pouze čtení)
- Získat čitelný štítek pro každý stav objednávky (např. "Platba přijata", "Odesláno")
Historie objednávek (čtení + vytvoření)
- Číst: Zobrazit historii změn stavu objednávky
- Vytvořit: Přidat novou změnu stavu k objednávce (např. označit jako odeslanou), s volitelným e-mailovým upozorněním pro zákazníka
Zákazníci (čtení + zápis)
- Číst: Vyhledat zákazníka podle e-mailu nebo ID — získat jméno, e-mail, datum registrace, stav newsletteru, poznámky
- Zapsat: Aktualizovat informace o zákaznících (jméno, příjmení, e-mail, poznámky)
Jazyky (pouze čtení)
- Seznam všech jazyků nakonfigurovaných ve vašem obchodě (používá se pro vícejazyčné aktualizace produktů)
5. Zadání API klíče do AI SmartTalk
Jakmile je váš klíč Webservice vytvořen a nakonfigurován:
- Přejděte na konfiguraci modulu AI SmartTalk v PrestaShopu
- API klíč je obvykle přenášen během OAuth připojení
- Pokud jej potřebujete aktualizovat, přejděte na svůj panel AI SmartTalk > Integrace > PrestaShop a aktualizujte token Webservice
Pro vícewebové nastavení může mít každý web svůj vlastní klíč API Webservice nakonfigurovaný nezávisle.
Další kroky
- Synchronizujte data svého obchodu — Přeneste svůj produktový katalog do AI
- Podívejte se, co AI může udělat — Kompletní reference dostupných akcí