Häufige Probleme und Lösungen für Widget-Integration und Nutzung.
Haben Sie Probleme? Hier sind Sie richtig. Dieser Leitfaden behandelt die häufigsten Probleme, auf die Entwickler bei der Integration des Widgets stoßen, sowie Schritt-für-Schritt-Lösungen. Die meisten Probleme können in nur wenigen Minuten gelöst werden.
🔍 Kurzer Debugging-Tipp
Öffnen Sie vor der Fehlerbehebung die Entwicklerkonsole Ihres Browsers (F12). Bei den meisten Widget-Fehlern werden klare Meldungen in der Konsole angezeigt, die direkt auf das Problem hinweisen.
Wenn das Widget überhaupt nicht auf Ihrer Seite angezeigt wird, befolgen Sie diese Schritte zur Fehlerbehebung der Reihe nach:
Fehler: „Widget nicht konfiguriert“ (mit Details zu jedem fehlenden data-*-Attribut)
Überprüfen Sie die Browserkonsole 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 bei der API authentifizieren. Dies geschieht normalerweise, wenn die Anmeldeinformationen falsch oder abgelaufen sind.
Authentifizierungsprobleme lassen sich normalerweise einfach beheben. Führen Sie diese Prüfungen durch:
client_id in Ihrer OAuth-Anwendung korrekt ist. Kopieren Sie es direkt aus Ihrem Dashboard, um Tippfehler zu vermeidenStecken Sie immer noch fest? Versuchen Sie, in Ihrem Dashboard eine neue OAuth-Anwendung zu erstellen. Manchmal löst ein Neustart unklare Konfigurationsprobleme.
Fehler: „Ursprung nicht zulässig“ oder Widget-Token-Anfrage abgelehnt
Häufig beim Einbetten in einen Iframe und wenn die Hostdomäne nicht in den von OAuth zugelassenen Ursprüngen aufgeführt ist.
Validierungstipp: Überprüfen Sie die Registerkarte „Netzwerk“ des Browsers auf die Token-Anforderungsheader und vergleichen Sie X-Embed-Origin mit Ihrem OAuth-Eintrag „allowed_origins“.
Problem mit der Tastenpositionierung
Das Widget wird geladen, aber die Schaltfläche befindet sich außerhalb des Ansichtsfensters.
position: behobenoverflow: versteckt vorhanden istWenn hide_on_mobile in der Konfiguration aktiviert ist, wird das Widget auf Mobilgeräten ausgeblendet. Deaktivieren Sie diese Einstellung oder passen Sie den mobilen Haltepunkt an.
Sehprobleme kommen häufig vor und sind in der Regel leicht zu beheben. Das Widget ist so konzipiert, dass es optisch von Ihrer Seite isoliert ist. Manchmal kann es jedoch zu Konflikten kommen.
Befolgen Sie diese Schritte, um Farbprobleme zu diagnostizieren:
Debug-Tipp: Öffnen Sie das Widget in Ihrem Browser und verwenden Sie das Element-Inspect-Tool, um zu überprüfen, welche CSS-Werte tatsächlich angewendet werden. Dadurch wird Ihnen angezeigt, ob Ihre Farben geladen oder überschrieben werden.
Wenn das Widget korrekt geladen wird, die Funktionen jedoch 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 wird ein Fehler angezeigt. Überprüfen Sie die Registerkarte „Netzwerk“ des Browsers auf fehlgeschlagene Anfragen (sollte auf der Registerkarte „Netzwerk“ rot angezeigt werden).
Probleme beim Senden von Nachrichten hängen normalerweise mit der Netzwerkkonnektivität oder abgelaufenen Sitzungen zusammen. Systematisch diagnostizieren:
Schnelltest: Wenn Nachrichten in einem Inkognito-Fenster funktionieren, aber nicht in Ihrem normalen Browser, hängt das Problem wahrscheinlich mit Browsererweiterungen oder zwischengespeicherten Authentifizierungsdaten zusammen.
Das Widget erfordert moderne Browserfunktionen:
Mindestens unterstützte Browser: Chrome 60+, Firefox 55+, Safari 12+, Edge 79+
Wenn Sie über diesen Leitfaden hinaus zusätzliche Hilfe benötigen, helfen Ihnen diese Tools und Ressourcen bei der Diagnose von Problemen oder beim Erhalten von Support.
Aktivieren Sie den Debug-Modus, um detaillierte Protokolle in Ihrer Browserkonsole anzuzeigen. Dies bietet Einblicke in die Aktionen des Widgets bei jedem Schritt:
<script src="https://widget.companin.tech/widget.js" data-widget-key="YOUR_WIDGET_KEY" data-dev="true"></script>Haben Sie immer noch Probleme?
Schauen Sie sich unsere an Konfigurationsanleitung Oder wenden Sie sich mit Ihren Browserkonsolenprotokollen und Konfigurationsdetails an den Support.