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 trinnvise løsninger. De fleste problemer kan løses på bare noen få minutter.

Widget lastes ikke

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

❌ Problem: Widget-skriptet mislykkes i å laste

✅ Løsning: Bekreft nødvendige attributter

Sørg for at alle nødvendige data-attributter er til stede på skript-taggen:

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

❌ Problem: Autentisering mislyktes

✅ Løsning: Sjekk OAuth-konfigurasjonen

Autentiseringsproblemer er vanligvis enkle å fikse. Arbeid 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 - Widgetdomenet må være tillatt
• Bekreft at widgetdomenet 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 innbeddingssiden din (for eksempel http://localhost:3000) i OAuth tillatte_opprinnelser.
• Bruk full format for skjema + vert (+ port), uten etterfølgende sti.
• Når du legger 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.

Widget ikke synlig

❌ Problem: Widget vises sammenfoldet, men knappen er usynlig

✅ Løsning: Sjekk konfigurasjonsposisjonering

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

❌ Problem: Widget skjult på mobil

✅ Løsning: Juster mobilinnstillinger

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 riktig konfigurasjon - Sjekk at konfigurasjons-ID-en samsvarer med skript-taggen din
• Vent noen sekunder etter lagring - Konfigurasjonsendringer kan ta 5-10 sekunder å propagere

Feilsøkings tips: Åpne widgeten i nettleseren din og bruk inspiser elementverktøyet 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 skrifttype
• Egendefinerte skrifttyper kan ikke lastes på grunn av CORS-restriksjoner
• Sjekk at skrifttypevektene er støttet

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 nettverksforbindelse 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 sesjonen ikke har utløpt - Sesjoner varer vanligvis i 30 minutter med inaktivitet
• Sjekk for nettverksproblemer - Er internettforbindelsen din stabil?
• Se etter CORS-feil i konsollen - Dette indikerer at domenet ditt kanskje ikke er hvitelistet
• Bekreft at brannmur-/sikkerhetsprogramvare ikke blokkerer API-et - 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ømkonfigurasjon

• Sjekk at utløsernøkkelordene stemmer nøyaktig
• Bekreft at strømresponsene er riktig konfigurert
• Sørg for at knappene har gyldige handlinger

Ytelsesproblemer

❌ Problem: Widgeten laster sakte

✅ Løsning: Optimaliser lasting

• Bruk produksjonsbygg i stedet for utvikling
• Aktiver nettleserbuffer for statiske ressurser
• Minimer tilpasset 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 assistanse 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 din. Dette gir innsikt i hva widgeten gjør i hvert trinn:

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

Nettleserutviklerverktø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 nettleserbuffer og informasjonskapsler
2. Prøv i inkognito-/privat nettlesermodus
3. Test med forskjellige nettlesere
4. Sjekk nettverksforbindelsen
5. Bekreft alle konfigurasjonsverdier