Referens för skripttaggen: alla attribut och konfigurationskällor

Widgeten kan konfigureras helt genom attribut på skripttaggen – utan inbäddat skript och därmed även med en strikt Content Security Policy. Om du föredrar JavaScript anger du samma fält via window.ReactiveChatSettings eller ReactiveChat('boot', …).

Utseende, texter, startskärm, regler och rundturer ställs vanligtvis in i kontot; de hämtas från servern när anslutningen upprättas. Attributen här gäller sådant som ska gälla per sida. Alla utseendealternativ beskrivs under Anpassning.

Fyra konfigurationskällor och deras prioritetsordning

Den senare källan vinner; sammanslagningen är ytlig (ett objektfält som brand ersätts i sin helhet, utan djup sammanslagning):

1. Widgetens standardvärden
2. data-rc-*-attribut på laddartaggen
3. window.ReactiveChatSettings (anges före laddaren)
4. Anrop till ReactiveChat('boot', {...}) från kön, i deras ordning

Fält som widgeten inte känner till slopas – ett felskrivet attribut får alltså ingen effekt och ger inget felmeddelande.

<script>
  window.ReactiveChatSettings = { locale: 'en', position: 'left' };
</script>
<script src="https://cdn.reactive.chat/loader.js"
        data-rc-site-key="SITE_KEY"
        async></script>

Hur attributvärden läses

Namnet omvandlas från kebab case till camel case: data-rc-site-key → siteKey. Typen bestäms av standardvärdet:

• Sträng – tas över oförändrad.
• Booleskt värde – bara "false" och "0" är falska; allt annat, även ett tomt attribut, är sant.
• Lista – kommaseparerad, till exempel "idle,pointer".
• Tal eller objekt – läses som JSON. Om JSON är ogiltigt behålls standardvärdet.

Bara den tagg som körs för tillfället läses (document.currentScript). Bädda därför in laddaren som ett klassiskt skript, inte med type="module".

Obligatoriskt

• data-rc-site-key (sträng, obligatorisk) – projektets nyckel, som finns i kontot under Projekt → Installation. Mönster [A-Za-z0-9_-]{8,64}. Om den saknas eller är ogiltig startar inget – utan något meddelande i konsolen.

Anslutning och distribution

• data-rc-ws-url (sträng, valfri) – chattanslutningens adress. Om den inte anges härleds den från platsen för loader.js (cdn.reactive.chat → wss://ws.reactive.chat/rc_wss/). Obligatorisk så snart du inte laddar loader.js från cdn.reactive.chat, och för domäner med tvådelad ändelse som .co.uk. Se Transport.
• data-rc-cdn-base (sträng, valfri) – katalogen som kärnan och modulerna laddas från. Standard: katalogen för loader.js.
• data-rc-core-url (sträng, valfri) – fast adress till kärnan i stället för core.<hash>.js från samma katalog. Bara för specialfall, som en egen spegel.
• data-rc-transport (http, valfri) – tvingar fram HTTP-reserven från start. Fungerar på alla element som finns i dokumentet vid starten; alternativt ReactiveChatSettings.transport = 'http'. Det har ingen effekt via boot.
• data-rc-max-retries (tal, standard 2) – nya försök om kärnan inte laddas (intervall 300 ms × försök).

Språk, tema och rörelse

• data-rc-locale (sträng, standard auto) – de, en eller pl. auto använder <html lang>, sedan webbläsarspråket, annars engelska. Andra språk faller tillbaka på engelska.
• data-rc-theme (auto | light | dark, standard auto) – auto följer sidans ljusa/mörka läge, annars systemets.
• data-rc-motion (auto | reduced | full, standard auto) – animationer; auto följer prefers-reduced-motion.
• data-rc-strings (JSON-objekt, standard {}) – ersätt enskilda texter, till exempel {"a11y.launcher":"Open help"}. Annars hanterar du texterna i kontot (Anpassning).

Visning och placering

• data-rc-position (right | left, standard right) – hörn för chattknappen och fönstret.
• data-rc-offset (JSON, standard {"x":20,"y":20}) – avstånd från kanten i pixlar, utöver den säkra ytan.
• data-rc-z-index (tal, standard 2147483000).
• data-rc-avoid-overlap (booleskt, standard true) – undviker fasta fält vid nederkanten (cookie-banners, varukorgsfält).
• data-rc-hide-launcher (booleskt, standard false) – ingen chattikon; fönstret öppnas bara via egna länkar eller JavaScript-API:et. Tipsbubblor undertrycks då. Gäller oavsett inställningen i kontot.
• data-rc-auto-open (booleskt, standard false) – öppnar fönstret efter starten.
• data-rc-isolation (shadow | iframe, standard shadow) – widgeten finns i ett slutet shadow DOM; iframe återger fönstret i en ram, för sidor med mycket aggressiva globala stilar.
• data-rc-brand (JSON-objekt) – profilfärg och chattknappens form. Laddaren läser direkt primary (#rrggbb), onPrimary, radius och launcher.shape (circle, rounded, square, bubble, leaf), launcher.size (44–72) och launcher.size_m ur det; kärnan kontrollerar resten. Kodsnutten från kontot har redan dessa värden – utan en giltig primary visar laddaren ingen platshållarknapp utan väntar tills färgen kommer från servern (inget färgbyte, men knappen visas senare). Om objektet bara innehåller dessa startfält gäller profilen från kontot när anslutningen har upprättats; med ytterligare fält (till exempel accent) gäller din. Mer under Anpassning.
• data-rc-logo (JSON-objekt) – src, placement (launcher, header, both), height, alt.
• data-rc-custom-css (sträng) – egen CSS inuti shadow DOM. Se Anpassning.

Laddning och beteende

• data-rc-load-triggers (lista, standard alla fem) – när kärnan laddas: idle (webbläsaren är inaktiv), pointer (mus eller finger på chattknappen), command (ett API-kommando utom boot, update, track, identify), frustration (signal från MousePlayer), push. Den första utlösaren vinner.
• data-rc-idle-timeout-ms (tal, standard 3000) – tidsgräns för utlösaren idle.
• data-rc-consent (auto | granted | denied, standard auto) – samtyckesstatus. auto frågar din samtyckesplattform (IAB TCF v2 via __tcfapi, annars consented.eu); granted/denied låser värdet. Se Integrera integritetsskydd.
• data-rc-dom-spiegel (booleskt, standard true) – false skickar ingen sidtext till assistenten och stänger av ”Visa mig”.
• data-rc-promo (booleskt, standard true) – false döljer reklamkortet på den här sidan.
• data-rc-launcher-selector (CSS-selektor) – klick på matchande element öppnar eller stänger fönstret. Fungerar först när kärnan har laddats; för länkar som ska fungera direkt använder du data-rc-open (nedan).
• data-rc-dnd (booleskt, standard false) – startvärde för ”Stör ej”.
• data-rc-session-ttl-ms (tal, standard 1800000) – hur länge en MousePlayer-session tas över.
• data-rc-debug (booleskt, standard false) – diagnostik i konsolen. Motsvarande: localStorage.setItem('rc_debug', '1') i webbläsaren.

Attribut på andra element på din sida

Öppna chatten (fungerar direkt, även innan kärnan har laddats):

• data-rc-open – på valfritt element; ett klick öppnar chatten intill elementet. data-rc-open="corner" öppnar den i hörnet.
• href="#rc-open" eller href="#reactive-chat" – samma för länkar.
• data-rc-anchor="none" – som corner.
• data-rc-message – text som skrivs in i inmatningsfältet men inte skickas (högst 200 tecken).
• data-rc-tab – msg, home eller help: vilken flik som visas främst.

Mer information: Öppna chatten från egen länk eller knapp.

Integritetstext:

• data-rc-privacy – platshållare för avsnittet om reactive.chat i din integritetspolicy, med data-lang, data-heading (2–6) och data-email. Status i data-rc-privacy-state (loading, done, error). Se Integrera integritetsskydd.

Undanta sidtext:

• data-rc-private eller, likvärdigt, data-rc-ignore – det här underträdet skickas aldrig till assistenten som sidtext och blir aldrig mål för ”Visa mig”.

<aside data-rc-private>
  Internal notes the assistant should not read.
</aside>

URL-parametrar

• ?rc_ab=A till E – tvingar fram en variant av ett pågående A/B-test för kvalitetskontroller (se Anpassning).

Widgeten utvärderar inga andra parametrar i adressen när den laddas.

Bädda in flera gånger

Om laddaren finns två gånger på sidan (till exempel via en mall och en tagghanterare) startar bara den första med en giltig webbplatsnyckel; den andra gör inget. En första tagg med ogiltig nyckel blockerar inte en korrekt andra tagg.

Nästa: JavaScript-API · Händelser