Feilsøking

Har du problemer? Du er på rett sted. Denne guiden dekker de vanligste problemene utviklere møter når de integrerer widgeten, sammen med trinn-for-trinn-løsninger. De fleste problemer kan løses på bare noen få minutter.

Widgeten lastes ikke

Hvis widgeten ikke vises i det hele tatt på siden din, følg disse feilsøkingstrinnene i rekkefølge:

❌ Problem: Widgetskriptet klarer ikke å laste

✅ Løsning: Bekreft nødvendige attributter

Sørg for at alle nødvendige dataattributter er til stede på skripttagen:

<script src="https://widget.companin.tech/widget.js" data-widget-key="YOUR_WIDGET_KEY" data-locale="en"></script>

❌ Problem: Godkjenning mislyktes

✅ Løsning: Sjekk OAuth-konfigurasjonen

Godkjenningsproblemer er vanligvis enkle å fikse. Gå gjennom disse sjekkene:

• Bekreft at client_id er korrekt i OAuth-applikasjonen din - Kopier den direkte fra dashbordet ditt for å unngå skrivefeil
• Sørg for at OAuth-appen er aktiv og ikke deaktivert i dashbordet ditt
• Sjekk at OAuth-appen har riktige omdirigerings-URI-er konfigurert - Widgetdomene må være tillatt
• Bekreft at widgetdomene er tillatt i CORS-innstillingene på backend-en din
• Hvis du nylig har regenerert legitimasjoner, må du sørge for at du bruker de nye verdiene

Fortsatt fastlåst? Prøv å opprette en ny OAuth-applikasjon i dashbordet ditt. Noen ganger løser det å starte på nytt uklare konfigurasjonsproblemer.

❌ Problem: /api/v1/auth/widget-token returnerer 400 (Opprinnelse ikke tillatt)

✅ Løsning: Juster vertens opprinnelse og OAuth tillatelsesliste

• Legg til opprinnelsen til innsettingssiden din (for eksempel http://localhost:3000) til OAuth tillatte opprinnelser.
• Bruk full format for skjema + vert (+ port), uten etterfølgende bane.
• Når du setter inn i en iframe, må du sørge for at tokenanrop bærer vertssideopprinnelsen i X-Embed-Origin.
• Bekreft at forespørsel-URL-en er /api/v1/auth/widget-token (ikke eldre stier).

Valideringstips: Sjekk nettleserens nettverksfane for tokenforespørselshoder og sammenlign X-Embed-Origin med oppføringen din i OAuth tillatte opprinnelser.

Widgeten er ikke synlig

❌ Problem: Widgeten vises sammenfoldet, men knappen er usynlig

✅ Løsning: Sjekk konfigurasjonsposisjonen

• Bekreft widgetkonfigurasjonens posisjonsinnstilling
• Sjekk for CSS-konflikter med position: fixed
• Sørg for at foreldrekontainere ikke har overflow: hidden

❌ Problem: Widgeten er skjult på mobil

✅ Løsning: Juster mobilinnstillingene

Hvis hide_on_mobile er aktivert i konfigurasjonen, vil widgeten være skjult på mobile enheter. Deaktiver denne innstillingen eller juster mobilbrytningspunktet.

Stilproblemer

Visuelle problemer er vanlige og vanligvis enkle å fikse. Widgeten er designet for å være visuelt isolert fra siden din, men noen ganger kan konflikter oppstå.

❌ Problem: Farger blir ikke brukt

✅ Løsning: Tøm cache og sjekk konfigurasjonen

Følg disse trinnene for å diagnostisere fargeproblemer:

• Tøm nettleserens cache og last inn siden på nytt (Ctrl+Shift+R eller Cmd+Shift+R for hard omlasting)
• Bekreft at fargeverdiene er gyldige heksakoder (må starte med # og ha 6 tegn, f.eks. #FF5733)
• Sjekk at konfigurasjonen ble lagret i dashbordet - Se etter en "lagret" bekreftelse
• Sørg for at du redigerer den riktige konfigurasjonen - Sjekk at konfigurasjons-ID-en samsvarer med skripttagen din
• Vent noen sekunder etter lagring - Konfigurasjonsendringer kan ta 5-10 sekunder å propagere

Feilsøkertips: Åpne widgeten i nettleseren din og bruk verktøyet for å inspisere elementer for å bekrefte hvilke CSS-verdier som faktisk blir brukt. Dette vil vise deg om fargene dine lastes eller blir overstyrt.

❌ Problem: Skrifttyper lastes ikke

✅ Løsning: Skriftkonfigurasjon

• Sørg for at skrifttypen er satt til "system-ui" eller en web-sikker skrift
• Egendefinerte skrifttyper kan ikke lastes på grunn av CORS-restriksjoner
• Sjekk at skrifttypevektene støttes

Funksjonalitetsproblemer

Når widgeten lastes riktig, men funksjoner ikke fungerer som forventet, vil disse løsningene hjelpe.

❌ Problem: Meldinger sendes ikke

✅ Løsning: Sjekk økt og nettverk

Problemer med sending av meldinger relaterer seg vanligvis til nettverkstilkobling eller utløpte økter. Diagnostiser systematisk:

• Bekreft at API-endepunktene er tilgjengelige - Prøv å få tilgang til API-URL-en direkte i nettleseren din
• Sjekk at autentiseringstokenet er gyldig - Se etter 401/403-feil i nettverksfanen
• Sørg for at økten ikke har utløpt - Økter varer vanligvis i 30 minutter med inaktivitet
• Sjekk for nettverkstilkoblingsproblemer - Er internettforbindelsen din stabil?
• Se etter CORS-feil i konsollen - Disse indikerer at domenet ditt kanskje ikke er hvitelistet
• Bekreft at brannmur/sikkerhetsprogramvare ikke blokkerer API-en - Bedriftsnettverk blokkerer noen ganger eksterne API-er

Rask test: Hvis meldinger fungerer i et inkognitovindu, men ikke i din normale nettleser, er problemet sannsynligvis relatert til nettleserutvidelser eller bufret autentiseringsdata.

❌ Problem: Samtalestrømmer fungerer ikke

✅ Løsning: Valider strømkonfigurasjonen

• Sjekk at utløsernøklene samsvarer nøyaktig
• Bekreft at strømresponsene er riktig konfigurert
• Sørg for at knappens handlinger er gyldige

Ytelsesproblemer

❌ Problem: Widgeten lastes sakte

✅ Løsning: Optimaliser lasting

• Bruk produksjonsbygg i stedet for utvikling
• Aktiver nettlesercaching for statiske ressurser
• Minimer egendefinert CSS og bilder
• Vurder lat lasting hvis det ikke er kritisk

❌ Problem: Høy minnebruk

✅ Løsning: Reduser ressursbruken

• Begrens lengden på meldingshistorikken
• Optimaliser bilder og medier
• Deaktiver ubrukte funksjoner

Nettleserkompatibilitet

❌ Problem: Widgeten fungerer ikke i eldre nettlesere

✅ Løsning: Sjekk nettleserstøtte

Widgeten krever moderne nettleserfunksjoner:

• ES6+ JavaScript-støtte
• PostMessage API
• CSS Grid og Flexbox
• Moderne iframe-funksjoner

Minimum støttede nettlesere: Chrome 60+, Firefox 55+, Safari 12+, Edge 79+

Få hjelp

Når du trenger ytterligere hjelp utover denne guiden, vil disse verktøyene og ressursene hjelpe deg med å diagnostisere problemer eller få støtte.

Feilsøkingsmodus

Aktiver feilsøkingsmodus for å se detaljert logging i nettleserkonsollen. Dette gir innsikt i hva widgeten gjør på hvert trinn:

<script  src="https://widget.companin.tech/widget.js"  data-widget-key="YOUR_WIDGET_KEY"  data-dev="true"></script>

Nettleserens utviklerverktøy

• Sjekk Konsoll-fanen for JavaScript-feil
• Sjekk Nettverks-fanen for mislykkede forespørsel
• Sjekk Applikasjons-fanen for lokale lagringsproblemer
• Bruk Elementer-fanen for å inspisere widgetens DOM

Vanlige feilsøkingstrinn

1. Tøm nettleserens cache og informasjonskapsler
2. Prøv i inkognito/privat nettlesermodus
3. Test med forskjellige nettlesere
4. Sjekk nettverkstilkoblingen
5. Bekreft alle konfigurasjonsverdier