API Berechtigungen
Fir de komplette Potenzial vun AI SmartTalk ze entsperren — wéi z.B. Bestellungen ze sichen, Produktbeschreiwungen ze aktualiséieren oder Clienten ze verwalten — musst de e PrestaShop Webservice API Token mat de richtegen Berechtigungen konfiguréieren.
Dëse Schrëtt ass noutwendeg wanns de AI Actions (SmartFlow) benotze wëlls. Ouni dëst kann deng AI Assistenz nach Froen baséiert op synchroniséierter Wëssen beäntweren, awer wäert net fäeg sinn, Echtzäit Geschäftsdaten ze accédéieren.
1. Aktivéieren vum Webservice
- Gitt op Erweiderte Parameteren > Webservice
- Aktivéiert PrestaShop's Webservice
- Klickt op Späicheren
2. Erstellen vun engem API Schlüssel
- Op der Webservice Säit, klickt op Neie Webservice Schlüssel derbäi
- Fëllt de Formulaire aus:
- Schlüssel: Klickt op Generéieren fir e sécheren Token ze kreéieren, oder gitt ären eegene an
- Schlüsselbeschreiwung:
AI SmartTalk - Status: Aktivéiert
- Setzt d'Berechtigungen wéi hei drënner beschriwwen
- Klickt op Späicheren
Kopéiert a späichert den API Schlüssel — de wäert et brauchen wanns de d'Integratioun an AI SmartTalk konfiguréiers.
3. Noutwendeg Berechtigungen
An der Berechtigungssäit vun ärem API Schlüssel, aktivéiert déi folgend Ressourcen:
| Ressource | GET | PUT | POST | Beschreiwung |
|---|---|---|---|---|
| produiten | Jo | Jo | — | Liesen Produktdetailer, aktualiséieren Beschreiwungen an SEO |
| bestellungen | Jo | — | — | Sich Bestellungen duerch Referenz oder Client |
| bestell_detailer | Jo | — | — | Vue Produkter an enger Bestellung |
| bestell_statusen | Jo | — | — | Liesen d'Labelen vum Bestellstatus |
| bestell_historië | Jo | — | Jo | Liesen d'Historie vum Status, derbäi Statusännerungen |
| clienten | Jo | Jo | — | Sich a aktualiséieren Clientinformatiounen |
| sproochen | Jo | — | — | Lëscht verfügbar Geschäftssproochen |
Just déi Berechtigungen hei uewen iwwerpréift. Et ass net néideg, Zougang zu anere Ressourcen ze ginn.
4. Firwat all Ressource benotzt gëtt
Produiten (liesen + schreiwen)
- Liesen: Récupéréiert Produktdetailer — Numm, Beschreiwung, kuerz Beschreiwung, Präis, Referenz, Lager, SEO Felder (meta Titel, meta Beschreiwung, meta Schlësselwieder)
- Schreiwen: Aktualiséiert Produktbeschreiwungen, kuerz Beschreiwungen, an SEO Felder mat voller multilingualer Ënnerstëtzung
Bestellungen (just liesen)
- Sich eng Bestellung duerch seng Referenznummer
- Lëscht Bestellungen fir e bestëmmte Client (per E-Mail)
- Kritt déi méi jonk Bestellung fir e Client
Bestell Detailer (just liesen)
- Vue d'Produkter an enger Bestellung: Numm, Referenz, Quantitéit, Eenheetspreis
Bestell Statusen (just liesen)
- Récupéréiert d'mënschlech liesbar Label fir all Bestellstatus (z.B. "Zahlung akzeptéiert", "Versand")
Bestell Historië (liesen + erstellen)
- Liesen: Vue d'Historie vum Statusännerung vun enger Bestellung
- Erstellen: Füügt eng nei Statusännerung zu enger Bestellung derbäi (z.B. als versandt markéieren), mat fakultativer E-Mail Benachrichtung un de Client
Clienten (liesen + schreiwen)
- Liesen: Sich e Client duerch E-Mail oder ID — récupéréiert Numm, E-Mail, Registréierungsdatum, Newsletter Status, Notizen
- Schreiwen: Aktualiséiert Clientinformatiounen (Virnumm, Numm, E-Mail, Notizen)
Sproochen (just liesen)
- Lëscht all Sproochen déi op ärem Geschäft konfiguréiert sinn (benotzt fir multilingual Produktupdates)
5. Ären API Schlüssel an AI SmartTalk aginn
Wann ären Webservice Schlüssel erstallt an konfiguréiert ass:
- Gitt op d'AI SmartTalk Modulkonfiguratioun an PrestaShop
- Den API Schlüssel gëtt typesch während der OAuth Verbindung iwwertragen
- Wanns de et aktualiséiere musst, gitt op däi AI SmartTalk Dashboard > Integratioun > PrestaShop an aktualiséiert den Webservice Token
Fir multi-site Setups, kann all Site seng eegen Webservice API Schlüssel onofhängeg konfiguréieren.
Nächste Schrëtt
- Synchroniséiert ären Geschäftsdaten — Push ären Produktkatalog an d'AI
- Kuckt wat d'AI kann maachen — Voll Referenz vun verfügbar Aktiounen