Fehlerbehebung: häufige Probleme und Lösungen
Häufige intoCHAT-Probleme lösen: Chat-Bubble fehlt, Crawl findet keine Seiten, Antworten sind vage oder falsch, Lead-Formular fehlt, Aktionen schlagen fehl.
Die meisten Probleme haben nur wenige Ursachen. Geh den Abschnitt durch, der zu dem passt, was du siehst. Die Entwicklerkonsole deines Browsers (F12) nennt die Ursache oft direkt. Meldungen, die der Chat Besuchern zeigt, stehen hier auf Englisch; Besucher sehen sie in der Sprache des Widgets.
Die Chat-Bubble erscheint nicht
- Das Script ist nicht auf der Seite. Öffne den Seitenquelltext und suche nach
embed.js. Viele Website-Baukästen fügen eigenen Code nur auf der veröffentlichten Website ein, nicht in der Editor-Vorschau. Das Script funktioniert im Head und im Body; empfohlen ist der Platz direkt vor</body>. Siehe Mit einem Script-Tag installieren. - Falsche Agent-ID. Die Konsole zeigt
Chatbot not found.Kopiere das Snippet noch einmal aus dem Tab Share. - Die Website steht nicht in den erlaubten Domains. Die Konsole zeigt
intoCHAT: this website is not in the allowed domains of this agent, so the chat is not shown.Der Agent ist auf andere Websites beschränkt. Trag die Domain dieser Website im Tab Share unter Where this agent can appear ein, oder leere die Liste, um jede Website zu erlauben. Bis eine neue Domain im Chatfenster ankommt, kann es bis zu einer Minute dauern. Siehe Erlaubte Domains. - Der Agent ist privat. Die Konsole zeigt
intoCHAT: this agent is private, so the chat is not shown.Schalte im Tab Share die Option Private agent aus und klicke auf Save. - Das Land des Besuchers ist gesperrt. Die Konsole zeigt
intoCHAT: this agent is not offered in the visitor's country (Share > Limits and access), so the chat is not shown.Das Land steht im Tab Share unter Blocked countries. Entferne es und klicke auf Save. Das Land ergibt sich aus der IP-Adresse; mit einem VPN kann ein Besucher in einem anderen Land erscheinen. Siehe Limits und Zugang. - Google Tag Manager. GTM entfernt das Attribut
data-chatbot-idaus Script-Tags in benutzerdefinierten HTML-Tags, das Widget weiß dann nicht, welchen Agenten es laden soll. Die Konsole zeigt „The embed script needs a data-chatbot-id attribute.“ Verwende das Snippet aus der Anleitung für Google Tag Manager. - Content Security Policy. Sendet deine Website einen CSP-Header, erlaube
https://www.intochat.aiinscript-src,connect-srcundframe-src. - Script-Optimierer. Das Script liest die Agent-ID aus seinem eigenen Tag. Fasst ein Plugin Scripts zusammen oder schreibt sie um, nimm
embed.jsdavon aus. - Werbe- oder Tracking-Blocker. Manche Browser-Erweiterungen blockieren Chat-Scripts von Drittanbietern. Teste in einem privaten Fenster ohne Erweiterungen.
- Die Bubble erscheint, aber der Agent antwortet nicht mehr. Besucher sehen „Message limit reached“, wenn dein Monatskontingent aufgebraucht ist, siehe Pläne und Limits.
Ein iframe oder der Direktlink zeigt keinen Chat
- Das iframe bleibt leer oder zeigt einen Browserfehler. Die Website steht nicht in den erlaubten Domains des Agenten, oder der Agent ist privat. Der Browser lädt den Chat dann nicht im iframe, und die Konsole nennt
frame-ancestors. Trag die Domain der Website im Tab Share unter Where this agent can appear ein. - „This agent is private.“ Schalte im Tab Share die Option Private agent aus. Solange sie an ist, können nur du und deine Teammitglieder mit dem Agenten chatten, im Playground.
- „This chat isn't available in your region.“ Das Land des Besuchers steht im Tab Share unter Blocked countries. Entferne es und klicke auf Save.
- „This agent doesn't exist anymore.“ Die Agenten-ID in der Adresse stimmt nicht, oder der Agent wurde gelöscht. Kopiere den Code erneut aus dem Tab Share.
- „The chat couldn't load. Please try again later.“ Die Einstellungen des Agenten ließen sich nicht laden. Lade die Seite neu.
Besucher sehen eine Limit-Meldung
- „Too many messages. Please try again later.“ Dieser Besucher hat Limit messages per visitor im Tab Share erreicht. Er kann wieder schreiben, sobald seine Stunde vorbei ist, gezählt ab seiner ersten Nachricht. Menschen im selben Netzwerk teilen sich ein Limit. Erhöhe die Zahl oder schalte das Limit aus.
- „Too many messages right now. Please try again in a moment.“ Die eigenen Stundenlimits von intoCHAT, die für jeden Agenten gelten, sind für diesen Agenten oder die IP-Adresse des Besuchers erreicht. Warte kurz und versuch es noch einmal.
- „This chat has reached its limit for now. Please try again later.“ Der Agent hat sein Monthly message cap for this agent erreicht. Die Karte zeigt den Stand und das Datum, an dem die Zählung neu beginnt. Erhöhe das Limit oder schalte es aus; der Agent antwortet ab der nächsten Nachricht wieder.
- „This chat isn't available in your region.“ Das Land des Besuchers steht unter Blocked countries.
- „Message limit reached“: Die Nachrichten deines Plans sind für alle deine Agenten aufgebraucht. Siehe Pläne und Limits.
- „The Playground couldn't reply“ mit einem Hinweis auf das monatliche Limit: Nachrichten im Playground zählen auf das Limit des Agenten. Erhöhe es oder schalte es aus.
Siehe Limits und Zugang.
Das Widget zeigt seine Texte in der falschen Sprache
- Buttons und Hinweise erscheinen in der falschen Sprache. Sie folgen der Einstellung Widget language im Tab Appearance. Mit Automatic nutzt die Chat-Bubble zuerst das Attribut
langim<html>-Tag deiner Seite, etwa<html lang="de">, danach die Browsersprachen der Besucher. Viele Website-Baukästen setzen dieses Attribut selbst; prüfe, ob es zur Seite passt. Soll überall dieselbe Sprache erscheinen, wähle sie unter Widget language und klicke auf Save changes. - Eine Seite in einer anderen Sprache zeigt Englisch. Das Widget spricht Englisch, Deutsch, Französisch, Italienisch und Spanisch. Bei jeder anderen Seitensprache geht es zu den Browsersprachen der Besucher über, dann zu Englisch.
- iframe oder Direktlink ignorieren die Sprache der Seite. Sie haben keine umgebende Seite und folgen mit Automatic deshalb dem Browser der Besucher.
- Deine Begrüßung oder andere Texte bleiben in einer Sprache. Was du selbst schreibst, erscheint so, wie du es geschrieben hast. Übersetzt werden nur die Standardtexte.
- Der Agent antwortet in einer anderen Sprache. Antworten folgen Reply language im Tab Setup, nicht dieser Einstellung. Standardmäßig ist das die Sprache, in der Besucher schreiben. Soll jede Antwort in einer Sprache sein, wähl sie unter Reply in, schalte Always use this language ein und klicke auf Save changes. Siehe Anweisungen.
Siehe Aussehen.
Ein Website-Crawl findet keine Seiten
- „No pages found“: intoCHAT konnte auf der Website keine Seiten finden. Prüfe die Adresse oder schalte Single page mode ein und füge die wichtigen Seiten einzeln hinzu.
- Alles herausgefiltert: Prüfe Exclude URLs containing. Ein Muster wie
/trifft auf jede Seite zu. - „The page answered with an error (403)“ oder Ähnliches: Die Website sperrt automatisierte Besucher. Bitte den Betreiber, den Zugriff zu erlauben, oder lade den Inhalt als Datei hoch bzw. füge ihn als Text ein.
- „No meaningful content found“: Die Seite enthält kaum lesbaren Text.
- „Monthly crawl limit reached“: Warte auf den monatlichen Neustart der Zählung oder upgrade. Dateien, Text und Q&A funktionieren weiter.
Siehe Website crawlen und Dateien.
Das Training wird nicht fertig
- Du hast die Seite während des Trainings geschlossen. Das Training läuft auf den Servern von intoCHAT weiter. Öffne den Tab Knowledge, um den Fortschritt zu sehen.
- Quellen warten weiter auf das Training. Öffne den Tab Knowledge: Ein unterbrochener Durchlauf geht dann weiter. Steht im Balken weiterhin „… sources waiting to be trained“, klicke auf Train agent. Fertige Quellen bleiben trainiert.
- Eine Quelle zeigt Failed. Fahr mit der Maus über das Badge, um den Grund zu sehen. Klicke auf Retry failed oder nutze Re-index saved text bei der Quelle.
- Eine hinzugefügte Datei oder Seite fehlt. Sie wurde noch gelesen, als du die Seite verlassen hast. Füge sie erneut hinzu und warte, bis sie als hinzugefügt erscheint.
Siehe Quellen verwalten.
Antworten sind falsch, vage oder veraltet
- Stell die Frage im Playground.
- Nutze im Tab Knowledge bei der Quelle, die die Antwort enthalten sollte, Preview the text. Fehlt der Text dort, wurde die Seite nicht so gelesen, wie du erwartet hast.
- Leg für häufige Fragen ein Q&A-Paar an. Q&A-Antworten haben Vorrang.
- Klicke bei der verlässlichsten Quelle auf den Stern (Mark as priority). Sie rangiert dann vor anderem passendem Wissen und setzt sich bei Widersprüchen durch, ohne neues Training.
- Hat sich eine Seite deiner Website geändert, klicke bei ihrer Quelle auf Refresh from website (von der Website aktualisieren). Die Seite wird neu gelesen und neu trainiert, wenn sich der Text geändert hat. Bei einer geänderten Datei lädst du die neue Version unter demselben Namen hoch und trainierst. Webseiten und Notion-Seiten werden nur von selbst neu gelesen, wenn Auto-resync an ist; Dateien, Text und Q&A nie.
- Lösch veraltete Quellen, die den aktuellen widersprechen, und prüfe deine Instructions.
Findet der Agent nichts Passendes, sagt er, dass er es nicht weiß, statt zu raten. Das ist so gewollt: Ergänze die fehlenden Inhalte. Siehe Quellen verwalten.
Das Lead-Formular erscheint nicht
- Enable lead collection ist an, und du hast auf Save lead settings geklickt.
- Im Modus Manual (visitor asks) erscheint das Formular nur, wenn der Besucher um Kontakt bittet.
- Stichwort-Regeln prüfen nur die letzte Nachricht des Besuchers.
- Das Formular erscheint höchstens dreimal pro Gespräch und nicht mehr, sobald der Besucher in dieser Sitzung Daten genannt hat. Für einen neuen Test öffne ein neues privates Fenster.
- In temporären Chats erscheint es nie.
- Ist die Übergabe per E-Mail an, bekommt ein Besucher, der nach einer Person fragt, statt des Formulars die Übergabe angeboten, außer eine Regel trifft zu.
Siehe Lead-Erfassung.
Eine Aktion schlägt fehl
- Öffne die Aktion und klicke in 2. Try it auf Send test request, um Status und Antwort zu sehen.
- „URL points to a blocked or internal host“: Private und interne Adressen werden abgelehnt. Verwende eine öffentliche URL.
- „This address redirects somewhere else“: Klicke auf Use this address.
- „Request timed out after 30s“: Der Endpunkt ist zu langsam.
- Der Agent ruft sie nie auf: Prüfe, ob die Aktion aktiviert ist und ob When to use die passenden Fragen beschreibt.
- Client-seitige Aktionen laufen nur auf einer Seite mit installiertem Widget vollständig und schlagen in einer Inline-Einbettung per iframe fehl. Siehe Client-seitige Aktionen.
Die Übergabe per E-Mail funktioniert nicht
- Der Agent bietet sie nie an. Prüfe, ob Offer hand-off by email im Tab Setup eingeschaltet ist und du auf Save changes geklickt hast. Der Agent bietet sie nur an, wenn der Besucher nach einer Person fragt oder eine Rückmeldung möchte, die er selbst nicht geben kann. Temporäre Chats lassen sich nicht übergeben. Ist der Live-Chat an und hat jemand den Live-Chat-Posteingang offen, bittet der Agent stattdessen dein Team dazuzukommen und bietet die Übergabe per E-Mail nur an, wenn der Besucher lieber per E-Mail kontaktiert werden möchte.
- Der Agent sagt, er konnte das Gespräch nicht weitergeben. Der Agent hat in der letzten Stunde schon 20 Übergaben verschickt, oder die E-Mail konnte nicht gesendet werden. Versuch es später noch einmal.
- Der Agent sagt, das Team hat das Gespräch schon. Dieses Gespräch wurde vor weniger als 10 Minuten übergeben.
- Es kommt keine E-Mail an. Prüfe die Empfänger unter Email when a new lead arrives im Tab Leads und deinen Spam-Ordner. E-Mails aus dem Playground beginnen mit
[Test].
Siehe Übergabe per E-Mail.
Der Live-Chat wird nicht angeboten
- Der Agent bietet die Übergabe per E-Mail an oder gar keine Person. Prüfe, ob Offer live chat when someone from the team is online unter Live chat im Tab Setup eingeschaltet ist. Der Live-Chat wird nur angeboten, solange jemand aus deinem Team online ist: Der Posteingang Live chat ist in einem Tab offen, innerhalb der letzten 2 Minuten, bei jemandem mit der Rolle Editor oder höher. Ein Tab im Hintergrund zählt nach etwa 17 Minuten nicht mehr.
- Im Playground passiert nichts. Der Playground zeigt keinen Live-Chat. Teste auf deiner Website oder über den Direktlink des Agenten.
- In einem temporären Chat passiert nichts. Temporäre Chats fordern nie einen Live-Chat an.
- Der Besucher sieht meine Antworten nicht. Hast du einen Chat übernommen, in dem der Besucher nicht nach einer Person gefragt hat, zeigt sein Chatfenster deine Antworten erst nach seiner nächsten Nachricht oder einem Neuladen.
Siehe Live-Chat.
Ein Webhook kommt nicht an
Klicke im Tab Leads unter dem Webhook auf Recent deliveries. Der Fehler einer fehlgeschlagenen Zustellung nennt meist die Ursache.
HTTP 301: redirects aren't followedoder ein anderer3xx-Status: Trag die endgültige Adresse ein, auf die weitergeleitet wird.No response within 10 seconds.: Antworte zuerst mit einem2xx-Status und erledige langsame Arbeit danach.The server's TLS certificate isn't valid.: Korrigiere oder erneuere das Zertifikat auf deinem Server.The webhook is turned off. Turn it on to deliver events.: Schalte den Webhook ein und klicke dann auf Resend.- Die Adresse wird beim Speichern abgelehnt: Verwende eine öffentliche Adresse, die mit
https://beginnt. Private und interne Netzwerkadressen sind nicht erlaubt. - Deine Signaturprüfung schlägt fehl: Berechne sie über den unveränderten Inhalt, bevor du das JSON auswertest, nimm den Wert von
X-IntoChat-Timestampmit hinein und verwende das neueste Secret, falls du auf New secret geklickt hast. Lehnst du alte Zeitstempel ab, prüfe die Uhr deines Servers. - Es kommt gar nichts an: Prüfe, ob der Webhook auf Active steht und das Event unter Events to send angehakt ist. Ein wiederkehrender Kontakt löst kein neues
lead.createdaus.
Siehe Webhooks.
Authenticator-App verloren
- Du hast einen Wiederherstellungscode. Klicke im Code-Schritt der Anmeldeseite auf Wiederherstellungscode verwenden und gib einen ein. Schalte danach unter Settings, Account die Zwei-Faktor-Authentifizierung aus und wieder ein, um dein neues Handy einzurichten.
- Du hast keinen Wiederherstellungscode mehr. Schreib von der E-Mail-Adresse deines Kontos an support@intochat.ai. Sobald der Support bestätigt hat, dass du es bist, kann er die Zwei-Faktor-Authentifizierung für dich ausschalten.
- Codes werden immer abgelehnt. Stell die Uhrzeit auf deinem Handy auf automatisch: Die Codes hängen von der Uhr ab. Außerdem funktioniert jeder Code nur einmal.
Siehe Zwei-Faktor-Authentifizierung.
Kommst du nicht weiter? Schreib an support@intochat.ai und gib deine Agent-ID an.