Felsökning och checklista

Verktyg

• Utvecklarverktyg → Nätverk: loader.js, core.<hash>.js, WebSocket-anslutningen (fliken ”Messages” eller ”Frames” visar init, init_ok, error) eller HTTP-reservens anrop (h/auf, …/sse, …/tx).
• Aktivera diagnostik: data-rc-debug="true" på laddarskriptets tagg eller localStorage.setItem('rc_debug','1') i konsolen, och ladda sedan om.
• Konsol: ReactiveChat('getSession'), ReactiveChat('getEndpoint'), ReactiveChat('isOpen'), ReactiveChat.version.

Ingen chattknapp syns

• Webbplatsnyckeln saknas eller är ogiltig. Laddarskriptet avbryter då utan felmeddelande. Kontrollera data-rc-site-key (8–64 tecken ur A–Z a–z 0–9 _ -) på den tagg som körs – tagghanterare och ramverkshjälpare utelämnar ibland attribut.
• type="module" på skripttaggen: laddarskriptet hittar då inte sin tagg. Bädda in det som ett klassiskt skript.
• data-rc-hide-launcher="true", eller ”Endast via egna länkar (ingen chattikon)” är valt i kontot.
• Ingen profilfärg i kodsnutten: utan en giltig färg i data-rc-brand visas knappen först när anslutningen är upprättad. Kopiera kodsnutten från kontot igen.
• Projektet är pausat eller webbplatsnyckeln är okänd: servern svarar med unknown_site_key (stängningskod 4002); i den här fliken gör widgeten inga nya försök under tio minuter.
• Kärnan laddas inte: konsolen visar [reactive.chat] core.js …. Ofta blockerar script-src eller en annonsblockerare adressen – se Egen domän.

Chattknappen syns, men inga meddelanden kommer fram

• Egen distribution av loader.js utan data-rc-ws-url: widgeten söker efter chattservern under din domän. På nätverksfliken ser du misslyckade anslutningsförsök till wss://ws.<your-domain>/rc_wss/. Lösning: data-rc-ws-url="wss://ws.reactive.chat/rc_wss/".
• origin_denied, stängningskod 1008: sidans domän saknas under Tillåtna ursprung. Ange webbplatsens domän, inte chattens underdomän.
• CSP blockerar: konsolen visar ett CSP-meddelande om wss://… eller https://…/rc_wss/h/auf. Lägg till båda formerna i connect-src.
• Företagsnät utan WebSocket: efter två misslyckade försök växlar widgeten till HTTP-reserven. Om den inte heller fungerar kontrollerar du om någon proxy avbryter anrop efter mindre än 30 sekunder eller buffrar svar (Transport).
• Blockering genom skyddet mot missbruk (stängningskod 1008 blocked): vanligt bakom en egen proxy utan giltig proxynyckel, eftersom alla besökare då har samma adress.
• För långt meddelande: widgeten skickar inte texter som överskrider planens gräns (1 000 eller 4 000 tecken).

En inloggad användare räknas som anonym

Ramen error innehåller auth_failed med detail.reason:

• no_hash – userHash saknas i identify.
• no_secret – ingen hemlighet har ställts in i projektet.
• bad_exp – exp anges i millisekunder i stället för sekunder, eller är inte ett heltal.
• expired – sidan har varit öppen länge eller serverns klocka går fel; beräkna en ny hash när sidan laddas.
• exp_too_far – mer än 24 timmar framåt i tiden.
• bad_hash – hemligheten, ordningen (userId + "." + exp) eller teckenuppsättningen stämmer inte; hemligheten används som nyckel i form av en sträng, inte avkodade byte. En e-postadress måste signeras exakt så som du skickar den.

Mer information: Identifiera besökare.

Kunddata kommer inte fram

• Assistenten ber användaren att logga in trots att hen är inloggad: exp saknas eller har gått ut – utan exp finns inga kunddata.
• Testa anslutning i kontot anger orsaken (http_401, zeitueberschreitung, umleitung, adresse_privat …). Strängen som signeras är X-RC-Zeit + "." + raw body – verifiera mot mottagna byte, inte mot JSON som kodats om.
• Ett fält saknas i assistentens svar: det är inte aktiverat i kontot eller finns på listan över fält som aldrig tas med.

Mer information: Slutpunkt för kunddata.

Webhooks kommer inte fram

• Är integrationen påslagen och händelsen vald (inget val = alla)? Vänta upp till 15 sekunder efter aktiveringen.
• Din slutpunkt tar mer än 10 sekunder på sig att svara eller svarar med en omdirigering.
• Din slutpunkt har en gång svarat med 410 – det inaktiverar integrationen. Slå på den igen.
• Signaturen stämmer inte: beräkna den med den råa meddelandekroppen och X-RC-Timestamp + "." + body, och tänk på prefixet sha256=.
• Innehåll saknas i data: vilka fält varje händelse innehåller anges under Webhooks; en händelse som inte är vald kommer inte alls fram.

Server-API

• 401 auth_failed: nyckeln har återkallats, är felskriven eller skapades av någon som inte längre är administratör.
• 403 insufficient_scope: behörighetens omfattning räcker inte; required_scope anger vad som krävs.
• 429: gränsen på 120 anrop per minut har överskridits; följ Retry-After.
• 415/413: Content-Type: application/json saknas eller meddelandekroppen är större än 64 KiB.

Integritetstexten visas inte

• Laddarskriptet saknas på sidan eller blockeras av samtyckesplattformen: bädda in datenschutz.js direkt.
• Webbplatsen är inte angiven som domän i projektet eller projektet är pausat.
• data-rc-privacy-state="error" på elementet visar att ett anrop misslyckades.

Checklista inför lanseringen

1. Alla webbplatsens domäner är angivna under Tillåtna ursprung.
2. Kodsnutten från kontot finns oförändrad på alla sidor där chatten ska visas – även integritetssidan.
3. CSP: distributionsadressen i script-src, connect-src med wss:// och https://, img-src för bilder.
4. Samtycke: data-rc-consent eller samtyckesplattformen (TCF v2 / consented.eu) har kontrollerats – testa med och utan samtycke.
5. Integritetspolicyn har kompletterats (<div data-rc-privacy> eller ett textblock).
6. Identitet: userHash med exp beräknas på servern, hemligheten finns bara i servermiljön, init_ok.identity.verified är true.
7. Områden med konfidentiell text är märkta med data-rc-private.
8. Med egen domän: alla fem kontrollsteg visar ”OK”, proxynyckeln finns bara i proxykonfigurationen, /rc_wss/h/ finns inte i åtkomstloggen.
9. Webhooks: signatur och tidsstämpel har verifierats, dubbletter upptäcks med X-RC-Delivery, snabbt 2xx-svar.
10. HTTP-reserven har testats en gång med data-rc-transport="http".
11. Mobilvyn (under 480 pixlar öppnas chatten i helskärm) och tangentbordsanvändningen har kontrollerats.