Produkt-FAQ KI — Vollständige Installations- und Konfigurationsanleitung
Product FAQ AI 4.0.0 installieren und konfigurieren: Verbindung mit Claude oder OpenAI, Texteinstellungen, Prüfung der Entwürfe, Massengenerierung mit Budget, barrierearme Anzeige und strukturierte Daten.
Product FAQ AI verfasst mit KI (Anthropic Claude oder OpenAI) die FAQ Ihrer PrestaShop-Produktseiten ausschließlich auf Grundlage Ihrer Katalogdaten. Die Antworten werden als Entwurf gespeichert: Sie lesen sie, korrigieren sie bei Bedarf und geben sie frei, bevor sie auf der Produktseite erscheinen – in einem Akkordeon, das per Tastatur bedienbar ist und ohne JavaScript auskommt.
Version 4.0.0. Komplett neu geschriebenes Modul: PrestaShop 1.7.8, 8 und 9, PHP 7.1 bis 8.5, Backoffice in 8 Sprachen, Entwürfe mit Prüfung, Massengenerierung mit Kostenschätzung und Budget, Verbrauchsprotokoll, 5 Akkordeon-Stile. Beim Update von 3.x bleiben Ihre FAQ, deren Reihenfolge, deren Sichtbarkeit und Ihre Einstellungen erhalten.
Voraussetzungen
- PrestaShop 1.7.8, 8.x oder 9.x, Theme Classic, Hummingbird oder ein Theme, das einen der angebotenen Hooks der Produktseite aufruft.
- PHP 7.1 bis 8.5 mit den Erweiterungen cURL und OpenSSL (Verschlüsselung des API-Schlüssels).
- Ein Konto bei Anthropic (console.anthropic.com) oder OpenAI (platform.openai.com) mit einem API-Schlüssel. Die Aufrufe werden vom Anbieter über Ihr eigenes Konto abgerechnet.
- Der Server muss ausgehende HTTPS-Anfragen an
api.anthropic.comoderapi.openai.comsenden können.
Installation und Update
- Klicken Sie unter Module > Modul-Manager auf Modul hochladen und wählen Sie
productfaqai-4.0.0.zip. - Das Modul legt die Tabelle
ps_product_faqund drei technische Tabellen (ps_productfaqai_job,ps_productfaqai_job_item,ps_productfaqai_usage) an und registriert seine Hooks sowie einen versteckten Admin-Controller. - Klicken Sie auf Konfigurieren: Der Tab KI-Verbindung führt Sie durch die Einrichtung des API-Schlüssels.
Update von 3.x. Laden Sie das ZIP 4.0.0 über die alte Version hoch. Es wird nichts gelöscht: Eine in 3.x aktive FAQ wird „veröffentlicht“, eine inaktive FAQ wird zum Entwurf. Der im Klartext gespeicherte API-Schlüssel wird verschlüsselt, die Modellkennungen werden durch aktuelle Modelle ersetzt (zum Beispiel claude-haiku-4-5-20251001 durch claude-haiku-5-5, gpt-4o-mini durch gpt-6-luna), und die Position displayProductFooter, die weder Classic noch Hummingbird aufruft, wird auf displayFooterProduct umgestellt, wenn Ihr Theme sie nicht verwendet.
Übersicht
Die Übersicht zeigt den Anteil der aktiven Produkte mit veröffentlichter FAQ, die Anzahl der Produkte mit zu prüfenden Entwürfen, die Ausgaben des Monats im Verhältnis zu Ihrer Monatsgrenze und die Richtkosten für 1.000 FAQ mit dem gewählten Modell. Die Abdeckung wird nach Sprache aufgeschlüsselt: veröffentlichte FAQ, nur Entwürfe oder keine FAQ.

Verbindung zum KI-Anbieter
Der Assistent umfasst drei Schritte: Anbieter wählen, Schlüssel einfügen, Modell wählen. Der Schlüssel wird zunächst mit einem kostenlosen Aufruf der Models-API des Anbieters getestet; gespeichert wird er nur, wenn der Test erfolgreich ist.

Der Schlüssel wird verschlüsselt (AES-256-GCM) in der Datenbank gespeichert. Er wird nie wieder angezeigt (nur die letzten 4 Zeichen), nie an den Browser gesendet und nie in Protokolle geschrieben. Um ihn zu ersetzen, fügen Sie einen neuen Schlüssel ein.
Modellauswahl
Die Liste enthält die in Ihrem Konto verfügbaren Modelle, die beim Test über die Models-API abgefragt werden. Die empfohlenen Modelle zeigen ihren unverbindlichen Listenpreis und die geschätzten Kosten für 1.000 FAQ mit Ihren Einstellungen. Ohne Test wird eine Ersatzliste angeboten.
- Anthropic:
claude-opus-5-5(Standard, beste Qualität),claude-sonnet-5-5(ausgewogen),claude-haiku-5-5(schnell und günstig). - OpenAI:
gpt-6.1-sol(Standard),gpt-6-astra,gpt-6.1-terra,gpt-6-luna,gpt-5.4-mini,gpt-5.4-nano.

Der Denkaufwand steht standardmäßig auf „Niedrig“: Eine FAQ aus einer Produktseite zu verfassen ist eine einfache Aufgabe, und ein höherer Aufwand erhöht die Dauer und die Anzahl der Token.
Texteinstellungen
Wählen Sie die Anzahl der Fragen pro Produkt (1 bis 15), die Antwortlänge (Kurz, Mittel, Ausführlich) und die Tonalität (Professionell, Freundlich, Locker, Technisch, Begeistert oder Beruhigend). Sie können eine Zielgruppe und Stilvorgaben angeben, zum Beispiel „Kunden siezen“.

Die Stilvorgaben können die Regeln des Moduls nicht aufheben: nur Fakten aus den Produktdaten verwenden, niemals Preise, Lieferzeiten, Garantien, Zertifizierungen oder Gesundheitsaussagen erfinden, in reinem Text schreiben. Eine kommerzielle Information (Garantie, Rückgabe) schreiben Sie in die Produktbeschreibung, oder Sie fügen die Frage manuell hinzu.
Gesendete Daten: Name, Kurz- und Langbeschreibung, Maße und Gewicht werden immer gesendet; Hauptkategorie, Marke, Merkmale und Varianten je nach Ihren Einstellungen. Kunden-, Bestell- oder Mitarbeiterdaten werden niemals gesendet.
Neue Produkte: Die Option „Neue Produkte in die FAQ-Warteschlange stellen“ ruft die KI nicht beim Speichern des Produkts auf; die Übersicht zeigt die wartenden Produkte, und Sie starten die Warteschlange, wann Sie möchten. Die Veröffentlichung ohne Prüfung ist eine separate Option und standardmäßig deaktiviert.
Produkte und FAQ-Editor
Der Tab Produkte & FAQ listet die Produkte des Shops auf, mit der Anzahl veröffentlichter Fragen bzw. Entwürfe und den Warnungen für jede Sprache. Filtern Sie nach Produkten ohne FAQ, mit Entwürfen oder mit veröffentlichter FAQ.

Der Editor öffnet die FAQ eines Produkts in einer Sprache:
- FAQ generieren: ersetzt die Entwürfe der Sprache; bereits veröffentlichte Fragen bleiben erhalten, sofern Sie nicht verlangen, sie zu ersetzen.
- Neu generieren (einzelne Frage): Die neue Version, die sich von den anderen Fragen unterscheidet, wird als Entwurf gespeichert.
- Neu anordnen per Drag-and-drop oder mit den Pfeilen, bearbeiten, löschen, eine Frage manuell hinzufügen.
- Freigeben (einzelne Frage) oder Alle freigeben und veröffentlichen. Nur veröffentlichte Einträge erscheinen auf der Produktseite.

Prüfwarnungen
Jede Antwort gibt die Fakten aus den Produktdaten an, auf die sich die KI gestützt hat. Das Modul zeigt eine Warnung an, wenn eine Zahl nicht in den Produktdaten vorkommt, wenn die Antwort von Garantie, Lieferung, Rückgabe, Zertifizierung oder Gesundheit spricht, obwohl die Produktseite nichts dazu sagt, oder wenn kein Fakt zitiert wird. Ein Eintrag mit Warnung wird nie automatisch veröffentlicht.

An die KI gesendete Daten
Die Schaltfläche An die KI gesendete Daten zeigt genau, was das Modul für dieses Produkt übermittelt: die Anweisungen (für alle Produkte gleich, wodurch sie zwischengespeichert werden können) und die Produktnachricht, mit einer Schätzung der Token und der Kosten.

Massengenerierung
Wählen Sie die Sprachen, die Produkte (nur die ohne FAQ oder alle aktiven Produkte), optional eine Liste von IDs und was nach der Generierung geschieht (Entwürfe zur Prüfung, empfohlen, oder Veröffentlichung der Einträge ohne Warnung). Klicken Sie auf Kosten schätzen: Das Modul zeigt vor jedem Versand die Anzahl Produkte × Sprachen, die geschätzten Token und eine Kostenspanne an, mit und ohne Zwischenspeicherung der Anweisungen.

- Die Warteschlange läuft in kurzen Schritten, solange die Modulseite geöffnet ist: keine endlos laufende Anfrage, kein Cronjob.
- Eine Sperre verhindert, dass zwei Tabs oder zwei Mitarbeiter dieselbe Warteschlange verarbeiten; pro Shop ist nur eine Warteschlange aktiv.
- Die Warteschlange stoppt beim Budget des Laufs und bei der Monatsgrenze. Sie können sie pausieren, fortsetzen, abbrechen oder Fehler erneut versuchen (3 Versuche pro Produkt).
- Lehnt der Anbieter alle Anfragen ab (Schlüssel, Guthaben, Modell), pausiert die Warteschlange mit einer Meldung, die angibt, was zu korrigieren ist.
Sparmodus: Die Anfragen werden an die Message-Batches-API von Anthropic oder die Batch-API von OpenAI gesendet, zu etwa halbem Preis. Die Ergebnisse liegen in der Regel nach einigen Stunden vor, spätestens nach 24 Stunden, und werden abgeholt, solange die Modulseite geöffnet ist.

Kosten, Budget und Protokoll
Legen Sie das Standardbudget eines Massenlaufs, die Monatsgrenze (über alle Generierungen hinweg) und die maximale Anzahl Token pro Antwort fest. Das Protokoll listet jeden Aufruf auf: Vorgang, Produkt, Sprache, Modell, Eingabe-, Ausgabe- und aus dem Cache gelesene Token, wie vom Anbieter gemeldet, Richtkosten und gegebenenfalls Fehler.

Die verwendeten Preise sind unverbindliche Listenpreise, erhoben am 11.11.2026. Die Schätzung rechnet mit etwa 3,5 Zeichen pro Token: Das ist ein Richtwert. Maßgeblich ist die Rechnung Ihres Anbieters.
Anzeige auf der Produktseite
Wählen Sie im Tab Anzeige den Stil, die Akzentfarbe, ob die erste Frage geöffnet angezeigt wird, die Position auf der Seite und den Blocktitel in jeder Sprache. Eine Position, die Ihr Theme nicht aufruft, wird gekennzeichnet.

Fünf Stile stehen zur Verfügung: Minimal, Karten, Gerahmt, Plus-Tasten und Alles offen. Der Block verwendet die nativen HTML-Elemente <details> und <summary>: Er funktioniert per Tastatur (Tab, Eingabetaste, Leertaste) und mit Screenreadern, ganz ohne JavaScript-Datei. Das HTML wird vom Server erzeugt, sodass sich beim Laden der Seite nichts verschiebt, und das Stylesheet wird nur auf Produktseiten geladen, die eine FAQ anzeigen.







Strukturierte Daten FAQPage
Das Modul kann den Produktseiten, die eine FAQ anzeigen, ein schema.org-Markup FAQPage (JSON-LD) hinzufügen. Die Option ist standardmäßig deaktiviert.
Google hat FAQ-Rich-Results im August 2023 auf maßgebliche Behörden- und Gesundheitswebsites beschränkt und zeigt sie seit dem 7. Mai 2026 für keine Website mehr an. Das Markup bleibt gültiges schema.org und schadet nicht, erzeugt in Google aber kein Rich Result: Erwarten Sie davon keinen SEO-Gewinn.
Wenn Sie die Option aktivieren und das Modul DataFirefly All in One SEO auf der Seite bereits einen FAQPage-Block ausgibt, fügt Product FAQ AI keinen zweiten hinzu; die Einstellungen des anderen Moduls werden nie geändert. Das JSON-LD wird so kodiert, dass es gültig bleibt und das script-Tag niemals schließen kann.
Sicherheit und Datenschutz
- Der Produkttext wird in einen abgegrenzten Datenblock gesetzt und als nicht vertrauenswürdiger Inhalt behandelt: Eine Beschreibung, die Anweisungen enthält („Ignoriere die Anweisungen…“), bleibt reine Daten.
- Die Antwort der KI ist an ein JSON-Schema gebunden und wird anschließend bereinigt: nur reiner Text, ohne HTML, Links, E-Mail-Adressen oder Markdown.
- Die Backoffice-Aktionen laufen über einen tokengeschützten Controller; Schreibvorgänge erfordern eine POST-Anfrage des Moduls und das Recht „Bearbeiten“ für den Tab Product FAQ AI. Ein Mitarbeiter, der nur das Recht „Anzeigen“ hat, kann Inhalte einsehen, aber weder generieren noch bearbeiten.
- Multishop: Einstellungen, Schlüssel, FAQ, Warteschlange und Protokoll gelten jeweils pro Shop; wählen Sie einen einzelnen Shop, um das Modul zu konfigurieren.
Fehlerbehebung
- „Der Anbieter hat den Schlüssel abgelehnt (401)“: Prüfen Sie den Schlüssel in der Konsole des Anbieters oder erstellen Sie einen neuen und fügen Sie ihn erneut ein.
- „Modell unbekannt oder nicht verfügbar (404)“: Wählen Sie ein anderes Modell; die Schaltfläche Gespeicherten Schlüssel testen lädt die Liste Ihres Kontos neu.
- Guthaben aufgebraucht oder Abrechnungslimit erreicht: Laden Sie beim Anbieter Guthaben auf und setzen Sie dann die Warteschlange fort.
- Zu viele Anfragen (429), Dienst überlastet: Das Modul hat es bereits unter Beachtung der vom Anbieter angegebenen Wartezeit erneut versucht; warten Sie oder nutzen Sie den Sparmodus.
- Antwort abgeschnitten: Erhöhen Sie die maximale Anzahl Token pro Antwort oder verlangen Sie weniger Fragen oder kürzere Antworten.
- Ablehnung durch den Anbieter: Prüfen Sie den Produkttext oder schreiben Sie die Fragen manuell.
- Die FAQ wird nicht angezeigt: Prüfen Sie, ob die Fragen in der aufgerufenen Sprache veröffentlicht sind und ob die gewählte Position von Ihrem Theme aufgerufen wird (Hinweis im Tab Anzeige).
Deinstallation
Die Deinstallation löscht alle FAQ, die Generierungs-Warteschlange, das Verbrauchsprotokoll, die Einstellungen und den Admin-Controller. Vorher wird eine Bestätigung abgefragt.