Häufige Probleme und Lösungen für die Widget-Integration und -Nutzung.
Haben Sie Probleme? Sie sind am richtigen Ort. Dieser Leitfaden behandelt die häufigsten Probleme, auf die Entwickler beim Integrieren des Widgets stoßen, sowie Schritt-für-Schritt-Lösungen. Die meisten Probleme können in nur wenigen Minuten gelöst werden.
🔍 Schneller Debugging-Tipp
Öffnen Sie die Entwicklertools Ihres Browsers (F12), bevor Sie mit der Fehlersuche beginnen. Die meisten Widget-Fehler zeigen klare Nachrichten in der Konsole an, die direkt auf das Problem hinweisen.
Wenn das Widget auf Ihrer Seite überhaupt nicht erscheint, befolgen Sie diese Fehlersuche-Schritte in der Reihenfolge:
Fehler: "Widget nicht konfiguriert" (mit Details zu jedem fehlenden data-* Attribut)
Überprüfen Sie die Browser-Konsole auf diese Fehlermeldung.
Stellen Sie sicher, dass alle erforderlichen Datenattribute im Skript-Tag vorhanden sind:
<script src="https://widget.companin.tech/widget.js" data-widget-key="YOUR_WIDGET_KEY" data-locale="en"></script>Fehler: "Authentifizierung erforderlich" oder "Ungültige Anmeldeinformationen"
Das Widget kann sich nicht mit der API authentifizieren. Dies geschieht typischerweise, wenn die Anmeldeinformationen falsch oder abgelaufen sind.
Authentifizierungsprobleme sind in der Regel einfach zu beheben. Arbeiten Sie diese Überprüfungen durch:
client_id in Ihrer OAuth-Anwendung korrekt ist - Kopieren Sie es direkt von Ihrem Dashboard, um Tippfehler zu vermeidenImmer noch festgefahren? Versuchen Sie, eine neue OAuth-Anwendung in Ihrem Dashboard zu erstellen. Manchmal löst ein Neuanfang obskure Konfigurationsprobleme.
Fehler: "Ursprung nicht erlaubt" oder Tokenanforderung des Widgets abgelehnt
Häufig, wenn in einem iframe eingebettet und die Host-Domain nicht in den OAuth-allowed origins aufgeführt ist.
Validierungstipp: Überprüfen Sie den Netzwerk-Tab des Browsers auf die Tokenanforderungsheader und vergleichen Sie X-Embed-Origin mit Ihrem Eintrag in den OAuth-allowed_origins.
Button-Positionierungsproblem
Widget lädt, aber der Button befindet sich außerhalb des Ansichtsbereichs.
position: fixedoverflow: hidden habenWenn hide_on_mobile in der Konfiguration aktiviert ist, wird das Widget auf mobilen Geräten ausgeblendet. Deaktivieren Sie diese Einstellung oder passen Sie den mobilen Breakpoint an.
Visuelle Probleme sind häufig und in der Regel leicht zu beheben. Das Widget ist so konzipiert, dass es visuell von Ihrer Seite isoliert ist, aber manchmal können Konflikte auftreten.
Befolgen Sie diese Schritte, um Farbprobleme zu diagnostizieren:
Debug-Tipp: Öffnen Sie das Widget in Ihrem Browser und verwenden Sie das Inspektor-Tool, um zu überprüfen, welche CSS-Werte tatsächlich angewendet werden. Dies zeigt Ihnen, ob Ihre Farben geladen oder überschrieben werden.
Wenn das Widget korrekt geladen wird, aber Funktionen nicht wie erwartet funktionieren, helfen diese Lösungen.
Netzwerkfehler, Zeitüberschreitung oder Sitzung abgelaufen
Der Benutzer gibt eine Nachricht ein und klickt auf Senden, aber es passiert nichts oder es erscheint ein Fehler. Überprüfen Sie den Netzwerk-Tab des Browsers auf fehlgeschlagene Anfragen (sollte rot im Netzwerk-Tab angezeigt werden).
Probleme beim Senden von Nachrichten hängen normalerweise mit der Netzwerkverbindung oder abgelaufenen Sitzungen zusammen. Diagnostizieren Sie systematisch:
Schneller Test: Wenn Nachrichten in einem Inkognito-Fenster funktionieren, aber nicht in Ihrem normalen Browser, liegt das Problem wahrscheinlich an Browsererweiterungen oder zwischengespeicherten Authentifizierungsdaten.
Das Widget erfordert moderne Browserfunktionen:
Minimale unterstützte Browser: Chrome 60+, Firefox 55+, Safari 12+, Edge 79+
Wenn Sie zusätzliche Unterstützung über diesen Leitfaden hinaus benötigen, helfen Ihnen diese Tools und Ressourcen, Probleme zu diagnostizieren oder Unterstützung zu erhalten.
Aktivieren Sie den Debug-Modus, um detaillierte Protokolle in der Konsole Ihres Browsers zu sehen. Dies bietet Einblicke, was das Widget in jedem Schritt tut:
<script src="https://widget.companin.tech/widget.js" data-widget-key="YOUR_WIDGET_KEY" data-dev="true"></script>Haben Sie immer noch Probleme?
Überprüfen Sie unser Konfigurationshandbuch oder kontaktieren Sie den Support mit Ihren Protokollen der Browser-Konsole und den Konfigurationsdetails.