FAQ – DasUCP | Designburg.net Docs

Kein Abo. Nur nutzungsbasierte API-Kosten direkt bei OpenAI oder Anthropic. Richtwerte:

gpt-4o-mini: ca. 0,01–0,03 EUR pro Gespräch (10 Nachrichten)
gpt-4o: ca. 0,05–0,15 EUR pro Gespräch
claude-sonnet-4-5-20250514: ca. 0,02–0,05 EUR pro Gespräch

5 EUR Guthaben reichen mit gpt-4o-mini für 150–500 Kundengespräche.

Nein. ChatGPT Plus (20 $/Monat) und die OpenAI API sind zwei verschiedene Produkte. Das Plugin nutzt die API und wird pro Anfrage abgerechnet (pay-as-you-go). Du brauchst nur einen OpenAI- oder Anthropic-Account mit API-Guthaben.

Prüfe der Reihe nach:

Ist Chat-Widget aktivieren in der Plugin-Konfiguration auf Ja?
Ist ein gültiger API-Key eingetragen? (Klick auf „API Key testen“)
Wurde nach der Installation ./bin/build-storefront.sh und bin/console cache:clear ausgeführt?
Browser-Cache leeren: Strg+Shift+R
Ist der Cookie-Consent-Manager aktiv? Wenn ja, muss der Besucher zustimmen, bevor das Widget angezeigt wird.

Häufigste Ursachen:

API-Key falsch — in der Plugin-Konfiguration testen
Guthaben leer — bei OpenAI/Anthropic nachladen
Modellname nicht korrekt geschrieben
Log prüfen: var/log/prod_*.log, Kanal sven_das_ucp

HTTPS ist zwingend erforderlich — Browser blockieren Mikrofon-Zugriff auf HTTP-Seiten. Auf localhost geht es ausnahmsweise. Außerdem:

Im Browser muss der Mikrofon-Zugriff für die Domain erlaubt sein
Unterstützt wird die Web Speech API (Chrome, Edge, Safari – Firefox eingeschränkt)
Spracheingabe unter Design → Spracheingabe / -ausgabe aktivierbar

Die Analyse läuft asynchron über die Shopware Message Queue. Der Queue-Worker muss laufen:

bin/console messenger:consume async

Bei managed Hosting läuft der Worker meist als Cron-Job. Falls nicht, starte ihn manuell oder per Supervisor. Status-Prüfung im Shopware-Log (var/log/) unter Kanal messenger.

Alte Gespräche vor dem Aktivieren werden nicht rückwirkend geloggt. Nach dem Einschalten einen neuen Chat im Storefront starten — dieser erscheint dann unter UCP → Chat-Verlauf.

Debug:

bin/console doctrine:query:sql "SELECT COUNT(*) FROM sven_ucp_chat_log"

Wenn die Zahl nach einem neuen Chat auf 2 steht (User + Assistant), aber die Liste im Admin leer bleibt — Admin-Cache leeren: bin/console cache:clear.

Nach der Installation folgende Befehle ausführen:

./bin/build-administration.sh
./bin/build-storefront.sh
bin/console cache:clear

Administration im Browser mit Strg+Shift+R neu laden. Das Element findest du unter Block-Kategorie UCP → Block FAQ-Accordion.

Wie jede KI kann sie gelegentlich ungenaue Antworten geben. Das Plugin minimiert das Risiko durch:

Produktdaten (Preis, Name, Verfügbarkeit) kommen direkt aus Shopware, die kann die KI nicht erfinden
Shop-spezifisches Wissen fließt via Self-Learning-Crawler, FAQ-Manager und System-Prompt in den Kontext
Je mehr FAQ-Einträge gepflegt sind, desto präziser die Antworten

Nein. Keine Kundendaten (Name, Adresse, Zahlungsdaten) werden an OpenAI oder Anthropic gesendet. Der Chat kommuniziert nur mit deinem eigenen Server (/ucp/chat), der Server spricht mit der KI-API. Der Checkout läuft über den normalen, sicheren Shopware-Checkout.

Was an die KI geht: die Chat-Nachrichten selbst (inkl. was der Kunde tippt), Produktdaten (Name, Preis, Beschreibung) und der System-Prompt mit Shop-Wissen und FAQs.

Kundendaten (Adresse, Zahlung) fließen nicht über die KI
Chat-Nachrichten gehen an OpenAI/Anthropic — beide bieten DPA (Data Processing Agreement)
Chat-Logging ist standardmäßig aus (Opt-in)
Bei aktivem Logging: Datenschutzhinweis im Widget anzeigbar + konfigurierbare Retention + pro Session löschbar (Auskunftsrecht)
Empfehlung: Absatz zum KI-Chat in deiner Datenschutzerklärung ergänzen

Empfehlung für den Start: gpt-4o-mini — schnell, günstig, gut genug für Shopping-Assistenz. Bei komplexen Shops oder Wunsch nach noch präziseren Antworten:

gpt-4o — OpenAIs Top-Modell
claude-sonnet-4-5-20250514 — Claude Sonnet 4.5 (oft besser im Verstehen von Kontext)

Das Plugin erkennt Credit-Errors automatisch:

E-Mail an die hinterlegte Benachrichtigungs-Adresse
Chat-Widget wird automatisch deaktiviert (wenn Auto-Disable aktiviert)
Der Shop funktioniert ganz normal weiter — nur der Chat ist weg
Nach dem Aufladen einfach Chat-Widget wieder aktivieren

Ja. Das Plugin stellt eine komplette REST-API mit OpenAPI 3.0 Spec und AI-Plugin-Manifest zur Verfügung. Damit können externe AI-Systeme den Shop als Tool nutzen:

ChatGPT Custom GPT: OpenAPI-Spec importieren unter /ucp/openapi.json
LangChain / LlamaIndex: Tools automatisch aus der Spec generieren
n8n / Zapier: HTTP-Nodes auf die Endpoints
Eigener Chatbot: Auf anderer Website, WhatsApp, Telegram

Dazu einen UCP-API-Schlüssel in der Plugin-Konfiguration setzen und als Bearer-Token senden.

Das AI-Discoverability-Pack sorgt für maximale Sichtbarkeit:

Schema.org JSON-LD (Organization, Product, FAQPage) → Rich Snippets bei Google
/llms.txt → LLM-Crawler kennen deinen Shop beim Indexieren
/ucp/feed.json → strukturierter Produktkatalog für AI-Shopping-Agenten
/.well-known/ai-plugin.json → ChatGPT kann den Shop als Plugin entdecken