Wenn etwas nicht klappt

Die häufigsten Probleme beim Einbinden und im Betrieb – mit Lösung.

Das Widget erscheint nicht

Gehe die Punkte der Reihe nach durch:

  1. Abo aktiv? Ohne Abo wird der Chat im Shop nicht angezeigt. Siehe Abrechnung.
  2. Eingeschaltet? Schalter Im Shop aktiv im Überblick.
  3. Richtige Domain? Die Adresse im Browser muss zur hinterlegten Shop-Adresse passen (z.B. https://www.mein-shop.de). Für Testsysteme oder weitere Domains lege einen eigenen Assistenten an oder schreib uns.
  4. Script vorhanden? Rechtsklick › Seitenquelltext anzeigen › nach widget.js suchen. Fehlt es: Plugin aktiviert und Einbindungscode vollständig eingefügt? Cache geleert? Theme kompiliert (Shopware 5)?
  5. Seite ausgeblendet? Unter Einstellungen › Verhalten › Auf diesen Seiten ausblenden steht z.B. /checkout.
  6. Werbeblocker oder Cookie-Tool? Manche blockieren Scripts fremder Domains. In einem privaten Fenster ohne Erweiterungen testen; im Cookie-Tool als funktional freigeben.
  7. Content-Security-Policy? In der Browser-Konsole (F12) erscheint dann „Refused to load the script“. Siehe Sicherheit.

„Der Assistent ist gerade nicht erreichbar“

  • Kurzzeitig: einfach erneut versuchen.
  • Dauerhaft: Abo-Status prüfen, dann ein Support-Ticket mit Uhrzeit und Seite schreiben.

„Die Sicherheitsprüfung hat nicht geklappt“

Der Browser konnte die Rechenaufgabe beim Gesprächsstart nicht lösen – meist bei sehr alten Browsern oder wenn die Seite über http:// statt https:// geladen wird. Seite neu laden; dauerhaft: HTTPS verwenden.

Verbindungstest schlägt fehl

Meldung Lösung
Es fehlen Zugangsdaten Pflichtfelder unter Einstellungen › Verbindungen ausfüllen.
401 / Zugangsdaten ungültig Schlüssel neu kopieren – oft fehlt ein Zeichen am Anfang oder Ende.
keine Leserechte für Bestellungen Rolle der Integration bzw. des API-Benutzers ergänzen (siehe Anleitung deines Shopsystems).
Keine Produkte gefunden Verkaufskanal-Schlüssel des richtigen Kanals? Produkte im Kanal sichtbar?
Keine Inhaltsseiten gefunden Shopware: Texte liegen in Erlebniswelten? WordPress: REST-API von einem Plugin gesperrt? Shopware 5: /sitemap.xml erreichbar?
Interne Adresse nicht erlaubt Shop-Adressen im lokalen Netz (z.B. 192.168…, localhost) sind aus Sicherheitsgründen gesperrt. Der Shop muss öffentlich erreichbar sein.
Keine gültige JSON-Antwort Ein Plugin gibt vor der Schnittstelle HTML aus oder eine Firewall (z.B. Cloudflare) blockiert. Den Assistenten-Server freigeben.

Bestellauskunft funktioniert nicht

  1. Tarif ab Starter? Schalter Bestellauskunft unter Einstellungen › Verhalten an?
  2. Verbindungstest zeigt „Bestellauskunft verbunden“? Sonst fehlen Zugangsdaten oder Leserechte für Bestellungen (Shopware 6: Rolle der Integration; Shopify: read_orders).
  3. Findet der Assistent eine Bestellung nicht, obwohl sie existiert: Stimmt die E-Mail-Adresse der Bestellung (nicht die vom Kundenkonto, falls abweichend)? Bei Postleitzahl und Straße zählt die Rechnungs- oder Lieferadresse.
  4. „Keine weitere Suche möglich“: Nach 3 Fehlversuchen im Gespräch bzw. 5 pro Stunde ist die Suche gesperrt. Neuer Chat oder eine Stunde warten.

Antworten sind falsch oder ungenau

  • Fehlende Infos unter Feste Fakten ergänzen, Inhaltsseite im Shop anlegen oder verbessern.
  • Unter Eigene Regeln gezielt nachsteuern.
  • Überblick › „Hier fehlt dir etwas“ (ab Tarif Starter) zeigt, wonach erfolglos gesucht wurde.
  • Neue Inhaltsseiten liest der Assistent spätestens nach 24 Stunden.

Einbindung wird nicht erkannt

Die Prüfung ruft deine Startseite auf. Blockiert eine Firewall Bots, erkennt der Assistent die Einbindung trotzdem, sobald ein echter Besucher den Chat lädt – dann einfach später erneut prüfen.

Mehr dazu im Ratgeber