Arkitektur och förlopp

Delarna

I besökarnas webbläsare:

• loader.js – en liten laddningsdel på några kilobyte. Den läser konfigurationen, kontrollerar samtycke, ritar en tillfällig chattknapp på dess slutliga plats (ingen layoutförskjutning) och skapar window.ReactiveChat med en kommandokö. Den gör inget annat.
• Kärnan (core.<hash>.js) – chattfönster, anslutning, maskering av personuppgifter, regler. Den laddas först när en utlösare aktiveras: webbläsaren är ledig, en mus eller ett finger på chattknappen, ett API-kommando, en frustrationssignal från MousePlayer. De flesta besökare öppnar aldrig chatten och laddar därför inte heller den direkt.
• Moduler vid behov – produktrundturer, integritetstext, butiksfunktioner; var och en först när den behövs.
• Isolering – allt finns i ett slutet shadow DOM; stilar via constructable stylesheets, inga inline-skript, ingen eval, inga cookies.

Hos reactive.chat:

• Leverans på https://cdn.reactive.chat/ – laddare, kärna, moduler.
• Chattserver på wss://ws.reactive.chat/rc_wss/ – WebSocket med protokollet rc.v1; samma adress med https:// för HTTP-reserven, offlineformulär, uppladdningar, integritetstext och Smart Answer.
• Konto på https://reactive.chat/app – projektinställningar, design, kunskapsbas, teamets agentpanel.
• Server-API på https://reactive.chat/v1/ – REST och MCP för din backend.

Hos dig (valfritt):

• Din backend signerar inloggade användares identitet, svarar på kunddataförfrågningar, tar emot webhookar och anropar server-API:et.
• Din proxy levererar allt via en egen underdomän (Egen domän).

Förloppet vid en sidvisning

1. Webbläsaren laddar loader.js (asynkront, blockerar inget).
2. Laddaren läser data-rc-*, ReactiveChatSettings och köade boot-anrop, kontrollerar webbplatsnyckel och samtycke och ritar platshållaren.
3. En utlösare aktiveras; laddaren hämtar kärnan från samma katalog.
4. Kärnan tar över platshållaren och kön och utför de köade kommandona i ordning.
5. Den öppnar anslutningen och skickar init med webbplatsnyckel, ID:n, språk, samtycke, eventuell signerad identitet och sidkontext.
6. Servern kontrollerar ursprung, projekt och identitet och svarar med init_ok: design och texter från kontot, regler, funktioner, gränser och konversationshistoriken hittills.
7. Widgeten är redo (händelsen ready). Den rapporterar själv sidbyten i ensidesappar.

Förloppet för en fråga

1. Besökaren skriver; personuppgifter maskeras i webbläsaren och meddelandet får ett unikt ID.
2. Servern lagrar det (upprepningar känns igen på ID:t), maskerar det igen och bekräftar med en återutsänd kopia.
3. AI-assistenten söker i kunskapsbasen – vid beställningsfrågor från en bekräftad användare även via kunddataslutpunkten – och strömmar svaret. När den lämnar över till teamet anges i kontot (Handbok).
4. Parallellt går händelser via en kö till webhookar och integrationer. Chatten väntar aldrig på dem.

Versioner och leverans

• loader.js har inget versionsnummer i namnet och ersätts vid uppdateringar. Bädda därför in den från cdn.reactive.chat (eller via din proxy), inte som en kopia.
• Kärnan heter core.<hash>.js; hashen kommer från innehållet och varje laddare känner exakt till sin egen kärna. Därmed passar laddare och kärna alltid ihop och en kärna kan cachelagras länge.
• Konfigurationen (design, texter, regler, rundturer) kommer från servern vid varje anslutning. Ändringar i kontot kräver ingen ny inbäddningskod; de får effekt efter en kort stund (beroende på inställning upp till en minut).
• Protokollversionen är 1. Nya fält läggs till; okända ignoreras.
• ReactiveChat.version anger kärnans version när den har laddats.

Var du ställer in vad

• I kontot: utseende, texter, startskärm, regler, rundturer, A/B-test, AI-persona (Anpassning), team, kunskapsbas, kanaler (Handbok).
• På skripttaggen: vad som ska gälla per sida (Skripttaggsreferens).
• I sidans skript: identitet, kontext, öppning från egna element (JavaScript-API).
• På din server: signaturer, kunddata, webhookar, API (Identitet, Kunddata, Webhookar, Server-API).

Nästa: Snabbstart