Speziell zum Crawling gibt es eigene Seiten: Crawl fehlgeschlagen und Crawl hinter Cloudflare. Diese Seite deckt das Widget, die Antwortqualität, Sprache, Kanäle und Caching ab.
Widget erscheint nicht
Wenn das Chat-Widget auf deiner Seite nicht auftaucht, geh diese Punkte der Reihe nach durch. In den meisten Fällen liegt es an einem fehlenden Snippet, einer nicht verifizierten Domain oder dem Browser-Cache.
1
Snippet wirklich eingebunden?
Öffne die Seite, drücke
Strg/Cmd + U (Quelltext anzeigen) und suche nach widget.js. Das Snippet muss genau so aussehen — mit deiner echten Install-ID im Attribut data-alpheris-key:HTML
<!-- Alpheris Chat Widget -->
<script src="https://alpheris.com/widget.js" data-alpheris-key="INSTALL_ID" crossorigin="anonymous" async></script>
<!-- End Alpheris Chat Widget -->2
Lädt das Skript? (Network-Tab)
DevTools öffnen (F12) → Reiter Netzwerk → Seite neu laden → nach
widget.js filtern. Es muss eine 200-Antwort kommen. Eine 404 bedeutet ein falsches Snippet, eine 403 deutet auf einen Domain- oder Plan-Block hin.3
Domain verifiziert?
Alpheris bindet jede Install-ID an die verifizierte Domain und prüft im aktiven Strict-Domain-Modus (Standard) den Origin der Einbettung. Läuft das Widget auf einer anderen Domain als der verifizierten (z. B. Staging, neue Subdomain), wird es blockiert. Verifizierte Domains und das
www.-Handling siehe Domains.4
Content-Security-Policy (CSP)
Hat deine Seite eine strenge CSP, muss
alpheris.com in script-src (und für die Verbindung in connect-src) erlaubt sein, sonst blockiert der Browser das Skript. Die Konsole zeigt dann eine CSP-Fehlermeldung.5
Adblocker & Cache ausschließen
uBlock, AdBlock Plus & Co. blockieren Chat-Widgets manchmal. Teste in einem privaten Fenster ohne Erweiterungen und leere den Cache (siehe Abschnitt Cache & Änderungen werden nicht sichtbar).
Shopify- und WordPress-Installationen verifizieren die Domain automatisch und setzen das Snippet selbst. Erscheint das Widget trotzdem nicht, prüfe in der Console unter Dashboard → Einbindung, ob die Integration noch verbunden ist.
Antworten sind falsch, generisch oder off-topic
Alpheris antwortet gegroundet — also auf Basis deiner Wissensbasis (gecrawlte Website, hochgeladene Dateien, bei Shopify die synchronisierten Produkte). Klingen Antworten falsch oder ausweichend, ist fast immer die Wissensbasis lückenhaft oder veraltet.
1. Wissensbasis prüfen
- Ist die Domain gecrawlt? Console → Datenquellen & Wissensbasis: Steht deine Website als Quelle drin und ist der Crawl erfolgreich abgeschlossen? Schlug er fehl, hilft die Seite Crawl fehlgeschlagen.
- Fehlen Inhalte? Liegen Infos nur in PDFs, Preislisten oder internen Dokumenten, lade sie als Datei hoch. Erlaubt sind u. a.
.pdf,.txt,.md,.csv,.docx,.xlsxsowie Bilder — nicht erlaubt sind.htmlund.svg. Details unter Datenquellen. - Seite geändert? Der Bot übernimmt Website-Änderungen nicht automatisch in Echtzeit. Nach größeren Anpassungen in der Console „Erneut crawlen" auslösen, damit die Wissensbasis aktualisiert wird.
2. Antwortstil & KI-Agent
- Tonalität & Anweisungen schärfen: Unter KI-Agent kannst du Ton und Verhalten vorgeben. Je konkreter die Anweisungen, desto präziser die Antworten.
- Kanal-Ton beachten: Pro Kanal gilt ein eigenes Profil — E-Mail formal/mittellang, Webchat ausgewogen/mittellang, WhatsApp & Instagram freundlich/kurz. Eine kurze WhatsApp-Antwort ist also gewollt, kein Fehler.
Findet die KI in der Wissensbasis keine belastbare Grundlage, antwortet sie bewusst zurückhaltend statt zu raten. Das ist gewollt — es schützt vor erfundenen Aussagen. Der richtige Hebel ist dann fast immer mehr/aktuellere Inhalte, nicht ein anderer Antwortstil.
Falsche Sprache in den Antworten
Alpheris erkennt die Sprache der Kundennachricht automatisch und antwortet in dieser Sprache. Stimmt etwas nicht, hilft meist:
- Sehr kurze oder gemischte Nachrichten („ok", „danke", einzelne Produktnamen) liefern wenig Signal — hier greift die Fallback-Sprache. Eine vollständige Frage führt zuverlässig zur richtigen Sprache.
- Antwortet der Bot konstant in der falschen Sprache, prüfe, ob deine Wissensbasis-Inhalte überwiegend in einer anderen Sprache vorliegen — gibt es zu einem Thema nur englische Quellen, kann die Antwort dorthin kippen.
- Mehr zur Sprachlogik und zur Fallback-Sprache unter Mehrsprachigkeit.
Probleme mit Kanälen (E-Mail, WhatsApp, Instagram)
Neben dem Webchat-Widget kann Alpheris auch E-Mail- und Messaging-Kanäle in der Inbox bedienen. Typische Stolpersteine:
| Symptom | Ursache | Lösung |
|---|---|---|
| Kanal sendet keine automatischen Antworten | Reifegrad noch im Beobachtungsmodus | Neue Intents starten in Shadow → Copilot → Autopilot. Vorschläge werden erst nach genügend akzeptierten Antworten automatisch versendet. Bis dahin kannst du sie in der Inbox manuell freigeben. |
| Beschwerden werden nie automatisch beantwortet | Bewusste Sicherheitsregel | Der Intent-Cluster „Beschwerde" ist dauerhaft vom Autopilot ausgeschlossen und landet immer als Vorschlag bei dir. |
| WhatsApp/Instagram nicht verbunden | OAuth abgelaufen oder abgebrochen | In der Console die Integration neu autorisieren. Die Verbindung läuft über Meta-OAuth mit Webhook-Verifizierung. |
| E-Mails kommen nicht an | Postfach-Anbindung getrennt | Outlook/Microsoft-Verbindung neu autorisieren; bei eigenem SMTP/IMAP die Zugangsdaten prüfen. |
| Sprachausgabe/-eingabe fehlt | Plan-Beschränkung | Voice ist erst ab dem Business-Plan verfügbar. Siehe Pläne & Abrechnung. |
Bekommst du beim Zugriff auf die Inbox-API eine
402 plan required, fehlt der passende Plan: die externe API ist nur in Business und Enterprise verfügbar. Mehr dazu in der API-Referenz.Cache & Änderungen werden nicht sichtbar
Du hast etwas geändert (Snippet, Design, Inhalte), aber es ändert sich nichts? Fast immer ist eine Cache-Ebene schuld. Arbeite dich von außen nach innen vor.
1
Browser-Cache leeren
Ein Hard-Reload lädt das Widget-Skript neu:
Strg + F5 (Windows) bzw. Cmd + Shift + R (Mac). Zum Gegentest ein privates Fenster öffnen.2
CDN / Hosting-Cache des Shops
Plattformen wie Shopify oder Caching-Plugins/CDNs (z. B. Cloudflare vor deiner Seite) cachen das HTML. Leere dort den Cache, damit das aktualisierte Snippet ausgeliefert wird.
3
Inhalts-Änderungen: Crawl auslösen
Geänderte Website-Inhalte landen erst nach einem erneuten Crawl in der Wissensbasis. In der Console „Erneut crawlen" klicken und den Abschluss abwarten.
4
Design-Vorschau prüfen
Design-Änderungen lassen sich über die Live-Vorschau im Editor verifizieren, bevor du sie auf der echten Seite suchst. Details unter Design.
Weiter kommen
Hilft nichts davon weiter, prüfe die passenden Detailseiten oder melde dich beim Support:
Crawl fehlgeschlagen
Wenn deine Website nicht eingelesen wird
Wissensbasis
Quellen, Uploads & erneutes Crawlen
Domains
Verifizierung & Strict-Domain-Modus
FAQ
Schnelle Antworten auf häufige Fragen
Bleibt es hängen, hilft das Team weiter: über die Console oder per E-Mail an [email protected]. Beschreibe Domain, betroffenen Kanal und was du bereits geprüft hast — das beschleunigt die Lösung deutlich.