Problemen oplossen

De problemen die het vaakst voorkomen, elk met de waarschijnlijke oorzaak en wat je eraan doet.

De chatknop verschijnt niet

Open de ontwikkelaarstools van je browser (F12) en kijk op het tabblad Console.

Wat je vindt	Oorzaak	Wat je doet
`[ChatterLab] missing data-agent`	De tag heeft geen agent-id	Kopieer de snippet opnieuw vanuit Implementeren
Niets over ChatterLab, en `w.js` staat niet onder Netwerk (of Network)	De tag staat niet op deze pagina	Kijk waar je websitebouwer "footercode" plaatst. Sommige voegen die pas toe nadat je publiceert.
`w.js` wordt geblokkeerd, met een melding over Content Security Policy	Je site beperkt welke scripts mogen laden	Sta ons adres toe in je beleid. In Installeren staat waar.
`w.js` laadt en er is nog steeds geen knop	Iets van jezelf bedekt de hoek, of een adblocker verbergt chatwidgets	Probeer een privévenster zonder extensies. Verplaats de knop met `data-side="left"`.

De knop verschijnt, maar de chat blijft leeg of wil niet laden

Bijna altijd Toegestane domeinen. Zodra er iets in de lijst staat, opent de chat alleen op de sites die erin staan, en de vergelijking is exact: https://example.com dekt https://www.example.com niet. Voeg het exacte adres uit de adresbalk van je browser toe, zonder het pad, of *.example.com voor elk subdomein, en wacht een halve minuut. Toegestane domeinen.

Dezelfde oorzaak verklaart "op de live site werkt het, maar op staging niet", en andersom.

Bezoekers zien een foutmelding

De widget zegt een van drie dingen, en welke het is, grenst de oorzaak af.

"Ik kan nu even niet antwoorden. Probeer het later nog eens." Er is iets aan jouw kant dat de agent tegenhoudt, en de melding zegt met opzet niet wat: dat gaat je bezoeker niet aan. De waarschijnlijkste oorzaken eerst:

De credits zijn op. Kijk onder Instellingen, Gebruik. Wat je dan doet.
De agent is gepauzeerd, omdat de werkruimte meer agents heeft dan het abonnement bevat. Dat staat bovenaan de pagina van de agent.
Het model van de agent zit niet meer in je abonnement, na een downgrade naar Free. Kies onder Instellingen een model van 1 credit.

"Dat waren veel berichten kort na elkaar." De bezoeker kwam boven de limiet van 20 berichten per 60 seconden. Dat gaat vanzelf over en er hoeft niets opgelost te worden.

"Er is iets misgegaan." Al het andere: een storing bij de aanbieder van het model, een verbinding die wegviel, of een adres waarop de widget niet ingesloten mag worden. Probeer het even later opnieuw, en mail ons als het aanhoudt.

De Testomgeving zegt het ronduit als de credits op zijn, dus stel je vraag eerst daar.

De agent zegt "dat weet ik niet" over iets wat wel in mijn bronnen staat

Controleer of bij de bron Klaar staat, en niet In wachtrij, Verwerken of Mislukt.
Open het gesprek in Activiteit en bekijk de bronnen onder het antwoord. Staat die van jou er niet bij, dan is die niet gevonden: zie stap 3 van Zwakke antwoorden verbeteren.
Van een bron op Mislukt leert de agent niets. Meestal gaat het om een gescande PDF: die bevat plaatjes van tekst, geen tekst. Bestanden.
Heb je Minimale gelijkenis verhoogd, zet die dan terug op 0,25.

De agent geeft een oud antwoord

De agent kent elke pagina zoals die was toen hij werd gelezen. Is de pagina sindsdien gewijzigd, crawl de site dan opnieuw of voeg de pagina opnieuw toe als Losse link: die wordt bijgewerkt, niet dubbel toegevoegd. Staat de oude informatie op een pagina die van je site is verdwenen, of in een bestand, verwijder die bron dan, want een crawl verwijdert nooit iets. Limieten en actualiteit.

De agent zegt iets wat niet in mijn bronnen staat

Zoek het antwoord op in het Overzicht onder De moeite waard om toe te voegen. Staat er Deels gedekt of Niet gedekt bij, volg dan stap 4 van Zwakke antwoorden verbeteren: verlaag de temperatuur, scherp de instructies aan, vul het gat in je bronnen.

Een crawl vond weinig pagina's, of geen enkele

In Websites staat een tabel met oorzaken. De drie belangrijkste: de site bouwt zijn content op met JavaScript, robots.txt of een firewall houdt de crawler tegen, of de pagina's staan op een andere host, zoals www. of shop..

Een crawl lijkt vast te zitten

Een crawl werkt in korte beurten en pakt na een onderbreking zelf de draad weer op. Staat er op de pagina Bronnen Doorzoeken gepauzeerd, druk dan op Doorzoeken hervatten. Wat al gelezen is, gaat niet verloren. Hij stopt vanzelf aan het einde van de site of bij je opslaglimiet, en met Doorzoeken stoppen stop je hem eerder, waarbij de gelezen pagina's blijven staan.

Een bron eindigt op "Mislukt"

De pagina Bronnen zegt waarom, onder de bron. Een bestand dat niet kon worden gelezen heeft meestal een wachtwoord: haal de beveiliging eraf en upload het opnieuw. Geen tekst gevonden wijst op een scan: haal het bestand eerst door OCR, of plak de inhoud als tekstbron. Te lang gaat over een vraag-antwoordpaar: verdeel het over kortere vragen. Een bron die meerdere keren is gestart en nooit afgerond is te groot om in één keer te verwerken: voeg de inhoud in kleinere delen toe. Staat er dat het aan onze kant misging, klik dan na een paar minuten op Agent opnieuw trainen, en schrijf ons als het weer mislukt.

Een bron wordt geweigerd vanwege de opslag

De agent heeft de opslag van zijn abonnement bereikt. Verwijder bronnen die hij niet nodig heeft, sluit paden uit bij het crawlen, of neem een hoger abonnement. Limieten en actualiteit.

Mijn logo wordt geweigerd of ziet er verkeerd uit

Groter dan 10 MB, of geen PNG, JPG, WebP, GIF of SVG: zet het eerst om.
Piepklein of wazig in de chat: de ruimte in de kop is klein en vierkant. Gebruik je beeldmerk in plaats van je volledige woordmerk, en bekijk in het bijsnijvenster het voorbeeld op ware grootte. Uiterlijk.

Wijzigingen in het uiterlijk zijn niet te zien op mijn site

Druk eerst op Opslaan: het voorbeeld toont wijzigingen die nog niet zijn opgeslagen, je site niet. Daarna onthouden browsers de instellingen van de knop nog maximaal vijf minuten. Vernieuw de pagina geforceerd (Ctrl+F5) en je ziet de nieuwe versie meteen.

Maandrapporten komen niet aan

Zie het einde van Het maandrapport.

De API geeft een fout terug

Elke fout heeft een code. In het overzicht van de API staan ze allemaal. De twee meest voorkomende: 400 invalid_request met een veld in details, meestal een verkeerd gespeld of onbekend veld, want de body wordt strikt gecontroleerd, en 403 forbidden, wat betekent dat het bereik van de sleutel (wat hij mag) de aanroep niet dekt.

Kom je er nog niet uit?

Mail naar management@sri-group.eu. Vermeld de naam van de agent, wat je deed, wat je verwachtte en wat er gebeurde. Gaat het om een probleem met de API, zet dan de x-request-id van het antwoord erbij.