Veelvoorkomende problemen en oplossingen voor widgetintegratie en gebruik.
Loop je tegen problemen aan? Je 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.
🔍 Snelle Debugging Tip
Open de Developer Console van je browser (F12) voordat je gaat probleemoplossen. De meeste widgetfouten zullen duidelijke berichten in de console weergeven die rechtstreeks naar het probleem wijzen.
Als de widget helemaal niet op je pagina verschijnt, volg dan deze probleemoplossingsstappen in volgorde:
Fout: "Widget niet geconfigureerd" (met details over elk ontbrekend data-* attribuut)
Controleer de browserconsole voor 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 authenticeren met de API. Dit gebeurt meestal wanneer referenties onjuist of verlopen zijn.
Authenticatieproblemen zijn meestal eenvoudig op te lossen. Werk deze controles door:
client_id correct is in je OAuth-toepassing - Kopieer het rechtstreeks vanuit je dashboard om typfouten te voorkomenNog steeds vastgelopen? Probeer een nieuwe OAuth-toepassing te maken in je 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 is niet vermeld in de toegestane oorsprongen van OAuth.
Validatietip: Controleer het netwerk tabblad van de browser voor de headers van het tokenverzoek en vergelijk X-Embed-Origin met je invoer in de toegestane_origins van OAuth.
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 het mobiele breekpunt aan.
Visuele problemen zijn gebruikelijk en meestal eenvoudig op te lossen. De widget is ontworpen om visueel geïsoleerd te zijn van je pagina, maar soms kunnen conflicten optreden.
Volg deze stappen om kleurproblemen te diagnosticeren:
Debugtip: Open de widget in je browser en gebruik de inspecteer-element-tool om te verifiëren welke CSS-waarden daadwerkelijk worden toegepast. Dit laat je zien of je 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
Gebruiker typt een bericht en klikt op verzenden, maar er gebeurt niets of er verschijnt een fout. Controleer het netwerk tabblad van de browser op mislukte verzoeken (moet als rood worden weergegeven in het netwerk tabblad).
Problemen met het verzenden van berichten hebben meestal betrekking op netwerkverbinding of verlopen sessies. Diagnose systematisch:
Snelle test: Als berichten werken in een incognito-venster maar niet in je 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 je extra hulp nodig hebt buiten deze gids, zullen deze tools en bronnen je helpen bij het diagnosticeren van problemen of het krijgen van ondersteuning.
Schakel de debugmodus in om gedetailleerde logging in je browserconsole te zien. Dit biedt inzicht in wat de widget doet bij elke stap:
<script src="https://widget.companin.tech/widget.js" data-widget-key="YOUR_WIDGET_KEY" data-dev="true"></script>Heb je nog steeds problemen?
Controleer onze configuratiehandleiding of neem contact op met ondersteuning met je browserconsole-logboeken en configuratiedetails.