Gå til innholdet
Sam Docs

Widget-feilsøking

Denne siden dekker de vanligste problemene med selve chat-widgeten. For konto- eller dashbord-problemer, se Dashbord-feilsøking.

Widgeten vises ikke på nettstedet mitt

Sjekk i denne rekkefølgen:

  1. Åpne nettleserkonsollet. Feilmeldinger med «Sam» eller «viasam» forteller deg årsaken direkte.
  2. Verifiser at install-snippeten er på siden. Høyreklikk → Vis sidekilde, søk etter widget.js. Hvis den mangler, kan CMS-et ditt ha fjernet den — se installasjons-veiledningen.
  3. Sjekk tillatte opphav. I Widget-editoren, åpne widgeten og sjekk at listen over tillatte opphav inneholder akkurat det domenet du tester på (med riktig protokoll — https:// vs http://, med eller uten www.).
  4. Sjekk at widgeten er aktiv. En pauset widget (etter en plannedgradering) lastes ikke. Åpne widgeten i dashbordet og sjekk statusen.

Jeg ser en CORS-feil i konsollet

CORS-feil betyr at domenet i nettleseren ikke matcher tillatte opphav på widgeten. Legg til det eksakte opphavet i listen. Opphav er skjema + vert + port — https://example.com og https://www.example.com er forskjellige opphav.

Jeg ser en Content Security Policy (CSP)-feil

Nettsteder som bruker en streng CSP må tillate Sam-domenene. Legg til følgende i CSP-headeren:

script-src https://widget.viasam.app;
connect-src https://api.viasam.app;
img-src https://cdn.viasam.app;
style-src https://widget.viasam.app 'unsafe-inline';

Tilpass til CSP-stilen din — dette er direktivene Sam trenger.

Fargene matcher ikke det jeg satte

To vanlige årsaker:

  • Edge-cache. Widget-konfigen caches på CDN-et i opptil 5 minutter. Vent, deretter hard-refresh (Ctrl+Shift+R / Cmd+Shift+R).
  • Nettstedets CSS overstyrer widgeten. Noen nettsteder har global CSS som treffer generiske klassenavn. Sams widget kjører i et Shadow DOM som standard for å hindre dette, men på enkelte gamle nettlesere kan det lekke. Hvis du ser nettstedets fonter inne i widgeten, sjekk CSS-en — vanligvis en global * { … }-regel.

Widgeten laster, men svarer ikke

  • Kunnskapsbasen kan være tom eller fortsatt indekserer. Sjekk Kunnskapsbase — alle filer skal være i Uploaded-status, ikke Pending eller Failed.
  • Samtaletaket nådd. Sjekk Fakturering — hvis du er på månedlig tak, kan nye samtaler bli avvist.
  • Trial utløpt. Trial-widgeter slutter å svare etter 7 dager.

Sam gir feil eller rare svar

Sam kan kun svare med det som ligger i:

  1. Kunnskapsbase-filer for den widgeten (filtrert på tagger hvis satt)
  2. System-prompt-overstyringen

Hvis svar er feil, fiks i denne rekkefølgen:

  1. Sjekk tagger. Hvis widgeten har kunnskapstagger satt, leses kun filer med matchende tagger. Dårlig tagging gir «vet ikke»-svar.
  2. Sjekk system-prompten. En prompt som sier «Svar alltid med tre setninger» kan overstyre det besøkende faktisk vil ha.
  3. Sjekk om kunnskapsfiler er ferske. Gamle eller utdaterte filer i Kunnskapsbasen villeder Sam. Erstatt dem.
  4. Sjekk modellen. På Trial og Starter bruker Sam kun gpt-4o-mini. Oppgrader til Growth eller Pro for å bruke gpt-4o for bedre resonnering.

For nyanserte svar (stil, tone, personlighet), bruk system-prompt-overstyring.

Widgeten er for liten / for stor på mobil

Under 480 px viewport-bredde åpner widgeten seg i fullskjerm automatisk. Dette er bevisst — chat-brukbarhet på mobil lider i små flytende paneler. Det finnes ingen innstilling for å skru det av.

Besøkende ser feil språk

Hver widget er låst til ett språk. Sjekk Widget-personlighet — språk-rullegardinen avgjør hva Sam snakker uavhengig av nettleserspråket til den besøkende.

For flerspråklige nettsteder, kjør én widget per språk og bruk sidens locale-logikk for å embedde riktig.

Launcher-knappen er skjult bak et annet element

Launcheren bruker z-index: 2147483000 (svært høy). Hvis noe på nettstedet ditt fortsatt ligger over, har siden en CSS-stabling-konflikt. Pakk det konkurrerende elementet i en position: relative-forelder, eller kontakt oss — vi kan foreslå en løsning.