Bädda in widgeten

Två rader i sidans head. Inget inline-skript, så den fungerar även med strikt CSP.

Kortversionen

Lägg den här raden i sidans head och ersätt SITE_KEY med din nyckel:

<script src="https://cdn.reactive.chat/loader.js"
        data-rc-site-key="SITE_KEY"
        data-rc-locale="en"
        async></script>

Det är allt. Laddaren väger 3,48 kB och hämtar kärnan först när webbläsaren har tid eller besökaren rör vid chattknappen.

Om du levererar `loader.js` själv behövs en rad till

Vissa vill hellre ladda skriptet från en egen katalog än från vårt leveransnätverk — på grund av en policy, en testmiljö eller helt enkelt av vana. Det fungerar, men då måste du uttryckligen ange chattanslutningen:

<script src="/js/loader.js"
        data-rc-site-key="SITE_KEY"
        data-rc-ws-url="wss://ws.reactive.chat/rc_wss/"
        async></script>

Varför: utan detta härleder widgeten adressen från platsen där skriptet kom ifrån. Om det var din domän letar den efter chatten där också — och hittar inget.

Och felet är svårt att se. Chattknappen visas, fönstret öppnas, färg och språk är rätt, allt ser färdigt ut. Men inget meddelande kommer någonsin fram. Inget fel visas: anslutningen fortsätter försöka i bakgrunden och det döljer just felet. Bara webbläsarkonsolen anger värden den letar efter förgäves.

Värdet ovan är samma för alla konton hos oss. Bara om du kör servern själv anger du ditt eget.

Via en underdomän till din egen webbplats

Om chatten ska köras som förstapart via en egen underdomän (t.ex. chat.your-company.com i stället för cdn.reactive.chat) beskrivs proxykonfigurationen i guiden för egen domän. Kontot visar då motsvarande kod.

När WebSocket blockeras

Om ett nätverk inte släpper igenom WebSocket, till exempel bakom en företagsproxy, fortsätter chatten automatiskt via vanlig HTTPS. För detta behöver din Content Security Policy adressen med https:// nedan utöver adressen med wss://. När reserven används och hur du tvingar fram den för test beskrivs i HTTP-reserv.

Öppna chatten från egna länkar, visa reklamkort

Vilken länk eller knapp som helst på sidan kan öppna chatten med fönstret direkt bredvid: Öppna chatten från en egen länk eller knapp. Hur du visar ett kort med ett eget erbjudande i chatten, som din betalda plan, beskrivs i Reklamkortet i chatten.

Bädda in integritetstexten automatiskt

Ett litet element på sidan med integritetspolicyn visar rätt text om chatten, alltid enligt projektinställningarna och på sidans språk: Bädda in integritetstexten automatiskt.

Varför det inte finns något inline-skript

Den vanliga formen som konkurrenterna levererar är ett inline-<script>. Med en strikt Content Security Policy utan unsafe-inline blockeras det innan en enda rad körs. Attributformen ovan behöver inget sådant.

Vad policyn också måste tillåta:

script-src leveransvärden, här cdn.reactive.chat
connect-src WebSocket-adressen, här wss://ws.reactive.chat
connect-src samma adress även med https:// som protokoll, här https://ws.reactive.chat – offlineformuläret och HTTP-reserven använder den när en företagsproxy blockerar WebSocket

Inställningarna på skripttaggen

data-rc-site-key — obligatorisk. Utan den startar inget, och det är avsiktligt.
data-rc-locale — de, en eller pl. Om den saknas bestämmer webbläsaren.
data-rc-brand — din profilfärg. Textfärgen räknas om tills texten är läsbar.
data-rc-ws-url — obligatorisk så snart du inte laddar loader.js från cdn.reactive.chat. Se avsnittet ovan.

Allt annat finns i funktionsöversikten och på prissidan.

På djupet i dokumentationen

Steg för steg: Snabbstart. Varje skripttaggsattribut med typ och standardvärde: Skripttaggsreferens. Alla kapitel finns i dokumentationen.

อัปเดตล่าสุด: 2026-10-25