API-Berechtigungen
Um das volle Potenzial von AI SmartTalk freizuschalten — wie das Abrufen von Bestellungen, das Aktualisieren von Produktbeschreibungen oder das Verwalten von Kunden — müssen Sie ein PrestaShop Webservice API-Token mit den richtigen Berechtigungen konfigurieren.
Dieser Schritt ist erforderlich, wenn Sie AI Actions (SmartFlow) verwenden möchten. Ohne ihn kann Ihr KI-Assistent zwar Fragen basierend auf synchronisiertem Wissen beantworten, hat jedoch keinen Zugriff auf Echtzeit-Daten des Shops.
1. Aktivierung des Webservices
- Gehen Sie zu Erweiterte Einstellungen > Webservice
- Aktivieren Sie PrestaShops Webservice
- Klicken Sie auf Speichern
2. Erstellen eines API-Schlüssels
- Klicken Sie auf der Webservice-Seite auf Neuen Webservice-Schlüssel hinzufügen
- Füllen Sie das Formular aus:
- Schlüssel: Klicken Sie auf Generieren, um ein sicheres Token zu erstellen, oder geben Sie Ihren eigenen ein
- Schlüsselbeschreibung:
AI SmartTalk - Status: Aktiviert
- Setzen Sie die Berechtigungen wie unten beschrieben
- Klicken Sie auf Speichern
Kopieren und speichern Sie den API-Schlüssel — Sie benötigen ihn, wenn Sie die Integration in AI SmartTalk konfigurieren.
3. Erforderliche Berechtigungen
Aktivieren Sie im Berechtigungsbereich Ihres API-Schlüssels die folgenden Ressourcen:
| Ressource | GET | PUT | POST | Beschreibung |
|---|---|---|---|---|
| produkte | Ja | Ja | — | Produktdetails lesen, Beschreibungen und SEO aktualisieren |
| bestellungen | Ja | — | — | Bestellungen nach Referenz oder Kunde abrufen |
| bestell_details | Ja | — | — | Produkte innerhalb einer Bestellung anzeigen |
| bestell_status | Ja | — | — | Bestellstatusbezeichnungen lesen |
| bestell_historien | Ja | — | Ja | Statushistorie lesen, Statusänderungen hinzufügen |
| kunden | Ja | Ja | — | Kundeninformationen abrufen und aktualisieren |
| sprachen | Ja | — | — | Verfügbare Shop-Sprachen auflisten |
Überprüfen Sie nur die oben aufgeführten Berechtigungen. Es ist nicht erforderlich, anderen Ressourcen Zugriff zu gewähren.
4. Verwendung jeder Ressource
Produkte (lesen + schreiben)
- Lesen: Produktdetails abrufen — Name, Beschreibung, kurze Beschreibung, Preis, Referenz, Lagerbestand, SEO-Felder (Meta-Titel, Meta-Beschreibung, Meta-Keywords)
- Schreiben: Produktbeschreibungen, kurze Beschreibungen und SEO-Felder mit vollständiger mehrsprachiger Unterstützung aktualisieren
Bestellungen (nur lesen)
- Eine Bestellung anhand ihrer Referenznummer abrufen
- Bestellungen für einen bestimmten Kunden auflisten (nach E-Mail)
- Die letzte Bestellung für einen Kunden abrufen
Bestelldetails (nur lesen)
- Die Produkte innerhalb einer Bestellung anzeigen: Name, Referenz, Menge, Stückpreis
Bestellstatus (nur lesen)
- Die menschenlesbare Bezeichnung für jeden Bestellstatus abrufen (z. B. "Zahlung akzeptiert", "Versendet")
Bestellhistorien (lesen + erstellen)
- Lesen: Die Historie der Statusänderungen einer Bestellung anzeigen
- Erstellen: Eine neue Statusänderung zu einer Bestellung hinzufügen (z. B. als versendet markieren), mit optionaler E-Mail-Benachrichtigung an den Kunden
Kunden (lesen + schreiben)
- Lesen: Einen Kunden nach E-Mail oder ID abrufen — Name, E-Mail, Registrierungsdatum, Newsletter-Status, Notizen abrufen
- Schreiben: Kundeninformationen aktualisieren (Vorname, Nachname, E-Mail, Notizen)
Sprachen (nur lesen)
- Alle im Shop konfigurierten Sprachen auflisten (verwendet für mehrsprachige Produktaktualisierungen)
5. Eingabe des API-Schlüssels in AI SmartTalk
Sobald Ihr Webservice-Schlüssel erstellt und konfiguriert ist:
- Gehen Sie zur Konfiguration des AI SmartTalk-Moduls in PrestaShop
- Der API-Schlüssel wird typischerweise während der OAuth-Verbindung übertragen
- Wenn Sie ihn aktualisieren müssen, gehen Sie zu Ihrem AI SmartTalk-Dashboard > Integration > PrestaShop und aktualisieren Sie das Webservice-Token
Für Multi-Site-Setups kann jede Site ihren eigenen Webservice-API-Schlüssel unabhängig konfigurieren.
Nächste Schritte
- Synchronisieren Sie Ihre Shop-Daten — Übertragen Sie Ihren Produktkatalog an die KI
- Sehen Sie, was die KI tun kann — Vollständige Referenz der verfügbaren Aktionen