AI Actions Reference

Wenn Sie mit den entsprechenden API-Berechtigungen verbunden sind, kann Ihr KI-Assistent die folgenden Aktionen in Echtzeit in Ihrem PrestaShop-Shop ausführen. Diese Aktionen sind in SmartFlow-Workflows verfügbar und können auch von der KI während Gesprächen mit Ihren Kunden genutzt werden.

---

Produkte

Produkt abrufen

Vollständige Details eines Produkts anhand seiner ID abrufen.

• Eingabe: Produkt-ID
• Gibt zurück: Name, Beschreibung, kurze Beschreibung, Referenz, Preis, Lagerbestand, aktiver Status, SEO-Felder (Meta-Titel, Meta-Beschreibung, Meta-Keywords)
• API-Berechtigung: products (GET)

Produktinhalt aktualisieren

Aktualisieren Sie die Beschreibung und/oder die kurze Beschreibung eines Produkts mit vollständiger mehrsprachiger Unterstützung.

• Eingaben: Produkt-ID, Beschreibung (optional), kurze Beschreibung (optional), Sprach-ID (optional — standardmäßig die Hauptsprache des Shops)
• Gibt zurück: Bestätigung mit der Liste der aktualisierten Felder
• API-Berechtigung: products (GET + PUT)

Tipp

Die KI bewahrt Inhalte in anderen Sprachen, wenn eine bestimmte Sprache aktualisiert wird. Zum Beispiel hat die Aktualisierung der französischen Beschreibung keine Auswirkungen auf die englische Version.

Produkt-SEO aktualisieren

Aktualisieren Sie die SEO-Felder eines Produkts mit mehrsprachiger Unterstützung.

• Eingaben: Produkt-ID, Meta-Titel (optional), Meta-Beschreibung (optional), Meta-Keywords (optional), Sprach-ID (optional)
• Gibt zurück: Bestätigung mit aktualisierten SEO-Werten
• API-Berechtigung: products (GET + PUT)

---

Bestellungen

Bestellung nach Referenz abrufen

Suchen Sie eine bestimmte Bestellung anhand ihrer Referenznummer (z. B. ABCDEF123).

• Eingabe: Bestellreferenz
• Gibt zurück: Vollständige Bestelldetails einschließlich Datum, Status, Gesamtbetrag, Zahlungsmethode, Versandinformationen und Liste der Produkte
• API-Berechtigung: orders (GET), order_details (GET), order_states (GET)

Bestellungen nach E-Mail abrufen

Rufen Sie alle Bestellungen ab, die von einem bestimmten Kunden aufgegeben wurden.

• Eingaben: Kunden-E-Mail, Limit (optional — standardmäßig 10)
• Gibt zurück: Liste der Bestellungen mit vollständigen Details, Gesamtanzahl
• API-Berechtigung: orders (GET), order_details (GET), order_states (GET), customers (GET)

Letzte Bestellung abrufen

Holen Sie sich die aktuellste Bestellung für einen bestimmten Kunden.

• Eingabe: Kunden-E-Mail
• Gibt zurück: Die letzte Bestellung mit vollständigen Details oder null, wenn keine Bestellungen gefunden wurden
• API-Berechtigung: orders (GET), order_details (GET), order_states (GET), customers (GET)

Bestellstatus aktualisieren

Ändern Sie den Status einer Bestellung (z. B. als versendet markieren, als zugestellt markieren).

• Eingaben: Bestell-ID, neue Bestellstatus-ID, E-Mail-Benachrichtigung senden (optional — standardmäßig nein)
• Gibt zurück: Bestätigung mit dem neuen Status und ob eine E-Mail gesendet wurde
• API-Berechtigung: order_histories (GET + POST)

Warnung

Das Ändern eines Bestellstatus kann E-Mail-Benachrichtigungen an Kunden auslösen, wenn die Option sendEmail aktiviert ist. Stellen Sie sicher, dass der korrekte Status angewendet wird.

---

Kunden

Kunde abrufen

Suchen Sie einen Kunden anhand seiner E-Mail-Adresse.

• Eingabe: Kunden-E-Mail
• Gibt zurück: Kunden-ID, Vorname, Nachname, E-Mail, Geburtstag, Newsletter-Status, Registrierungsdatum, Notizen
• API-Berechtigung: customers (GET)

Kunden aktualisieren

Aktualisieren Sie die Profilinformationen eines Kunden.

• Eingaben: Kunden-ID, Vorname (optional), Nachname (optional), E-Mail (optional), Notizen (optional)
• Gibt zurück: Bestätigung mit der Liste der aktualisierten Felder
• API-Berechtigung: customers (GET + PUT)

---

Konfiguration

Sprachen abrufen

Listen Sie alle in Ihrem PrestaShop-Shop konfigurierten Sprachen auf.

• Keine Eingabe erforderlich
• Gibt zurück: Liste der Sprachen mit ID, Name und ISO-Code (z. B. fr, en, de)
• API-Berechtigung: languages (GET)

Info

Diese Aktion wird intern von der KI verwendet, wenn mehrsprachige Produktaktualisierungen durchgeführt werden, um sicherzustellen, dass die korrekte Sprach-ID verwendet wird.

---

Zusammenfassungstabelle

Aktion	Kategorie	Lesen	Schreiben
Produkt abrufen	Produkte	Ja	—
Produktinhalt aktualisieren	Produkte	Ja	Ja
Produkt-SEO aktualisieren	Produkte	Ja	Ja
Bestellung nach Referenz abrufen	Bestellungen	Ja	—
Bestellungen nach E-Mail abrufen	Bestellungen	Ja	—
Letzte Bestellung abrufen	Bestellungen	Ja	—
Bestellstatus aktualisieren	Bestellungen	—	Ja
Kunde abrufen	Kunden	Ja	—
Kunden aktualisieren	Kunden	Ja	Ja
Sprachen abrufen	Konfiguration	Ja	—

---

Verwandt

• API-Berechtigungen — Konfigurieren Sie die erforderlichen Webservice-Berechtigungen
• Webhooks & Fähigkeiten — Diese Aktionen automatisch bei Shop-Ereignissen auslösen