Veelvoorkomende problemen en oplossingen voor widgetintegratie en -gebruik.
Problemen ondervonden? U bent op de juiste plek. Deze gids behandelt de meest voorkomende problemen waarmee ontwikkelaars worden geconfronteerd bij het integreren van de widget, samen met stapsgewijze oplossingen. De meeste problemen kunnen in slechts een paar minuten worden opgelost.
50D Snelle debugtip
Open de ontwikkelaarsconsole van uw browser (F12) voordat u problemen oplost. De meeste widgetfouten geven duidelijke berichten weer in de console die rechtstreeks naar het probleem wijzen.
Als de widget helemaal niet op uw pagina verschijnt, volg dan deze stappen voor probleemoplossing in volgorde:
Fout: "Widget niet geconfigureerd" (met details over elk ontbrekend data-* attribuut)
Controleer de browserconsole op dit foutbericht.
Zorg ervoor dat alle vereiste data-attributen aanwezig zijn op de script-tag:
<script src="https://widget.companin.tech/widget.js" data-widget-key="YOUR_WIDGET_KEY" data-locale="en"></script>Fout: "Authenticatie vereist" of "Ongeldige referenties"
Widget kan niet authentiseren met de API. Dit gebeurt meestal wanneer referenties onjuist of verlopen zijn.
Authenticatieproblemen zijn meestal eenvoudig op te lossen. Doorloop deze controles:
client_id correct is in uw OAuth-toepassing - Kopieer het rechtstreeks van uw dashboard om typfouten te voorkomenNog steeds vastgelopen? Probeer een nieuwe OAuth-toepassing te maken in uw dashboard. Soms lost een frisse start obscure configuratieproblemen op.
Fout: "Oorsprong niet toegestaan" of widget-tokenverzoek afgewezen
Veelvoorkomend bij insluiten in een iframe en de hostdomein niet is vermeld in de toegestane oorsprongen van OAuth.
Validatietip: Controleer het netwerk tabblad van de browser voor de token aanvraagheaders en vergelijk X-Embed-Origin met uw OAuth toegestane_origins invoer.
Probleem met knoppositionering
Widget laadt maar de knop bevindt zich buiten het viewport.
position: fixedoverflow: hidden hebbenAls hide_on_mobile is ingeschakeld in de configuratie, wordt de widget verborgen op mobiele apparaten. Schakel deze instelling uit of pas de mobiele breekpunten aan.
Visuele problemen zijn gebruikelijk en meestal eenvoudig op te lossen. De widget is ontworpen om visueel geïsoleerd te zijn van uw pagina, maar soms kunnen conflicten optreden.
Volg deze stappen om kleurproblemen te diagnosticeren:
Debugtip: Open de widget in uw browser en gebruik de inspectie-tool om te verifiëren welke CSS-waarden daadwerkelijk worden toegepast. Dit laat zien of uw kleuren worden geladen of worden overschreven.
Wanneer de widget correct laadt maar functies niet werken zoals verwacht, zullen deze oplossingen helpen.
Netwerkfout, time-out of sessie verlopen
De gebruiker typt een bericht en klikt op verzenden, maar er gebeurt niets of er verschijnt een fout. Controleer het netwerktabblad van de browser op mislukte verzoeken (moet als rood worden weergegeven in het netwerktabblad).
Problemen met het verzenden van berichten hebben meestal te maken met netwerkverbinding of verlopen sessies. Diagnose systematisch:
Snelle test: Als berichten werken in een incognito-venster maar niet in uw normale browser, is het probleem waarschijnlijk gerelateerd aan browserextensies of gecachte authenticatiegegevens.
De widget vereist moderne browserfuncties:
Minimaal ondersteunde browsers: Chrome 60+, Firefox 55+, Safari 12+, Edge 79+
Wanneer u aanvullende hulp nodig heeft buiten deze gids, zullen deze tools en bronnen u helpen bij het diagnosticeren van problemen of het krijgen van ondersteuning.
Schakel de debugmodus in om gedetailleerde logging in uw browserconsole te zien. Dit biedt inzicht in wat de widget op elke stap doet:
<script src="https://widget.companin.tech/widget.js" data-widget-key="YOUR_WIDGET_KEY" data-dev="true"></script>Heeft u nog steeds problemen?
Controleer onze configuratiehandleiding of neem contact op met de ondersteuning met uw browserconsole-logboeken en configuratiedetails.