Referenční přehled značky script: atributy a zdroje konfigurace

Widget lze celý nastavit atributy na značce script — bez inline skriptu, a tedy i při striktní Content Security Policy. Pokud raději píšete JavaScript, nastavte stejná pole přes window.ReactiveChatSettings nebo ReactiveChat('boot', …).

Design, texty, úvodní obrazovku, pravidla a prohlídky obvykle nastavujete v účtu; při navázání připojení přicházejí ze serveru. Zdejší atributy jsou pro to, co má platit pro jednotlivou stránku. Všechny možnosti designu popisuje Přizpůsobení.

Čtyři zdroje konfigurace a jejich přednost

Pozdější zdroj vyhrává; sloučení je mělké (objektové pole jako brand se nahrazuje celé, neslučuje se do hloubky):

1. Výchozí hodnoty widgetu
2. Atributy data-rc-* na značce loaderu
3. window.ReactiveChatSettings (nastavené před loaderem)
4. Volání ReactiveChat('boot', {...}) z fronty v jejich pořadí

Pole, která widget nezná, se zahodí — atribut s překlepem tedy bez upozornění nemá účinek.

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

Jak se čtou hodnoty atributů

Název se převádí z kebab-case na camelCase: data-rc-site-key → siteKey. Typ vychází z výchozí hodnoty:

• Řetězec – převezme se beze změny.
• Logická hodnota – pouze "false" a "0" jsou false; vše ostatní včetně prázdného atributu je true.
• Seznam – oddělený čárkami, například "idle,pointer".
• Číslo nebo objekt – čte se jako JSON. Pokud JSON není platné, zůstává výchozí hodnota.

Čte se jen právě vykonávaná značka (document.currentScript). Loader proto vkládejte jako klasický skript, ne s type="module".

Povinné

• data-rc-site-key (řetězec, povinné) – klíč projektu, který najdete v účtu pod Projekt → Instalace. Vzor [A-Za-z0-9_-]{8,64}. Pokud chybí nebo je neplatný, nic se nespustí — bez hlášení v konzoli.

Připojení a doručování souborů

• data-rc-ws-url (řetězec, volitelné) – adresa připojení chatu. Pokud není uvedena, odvodí se z umístění loader.js (cdn.reactive.chat → wss://ws.reactive.chat/rc_wss/). Povinné, jakmile loader.js nenačítáte z cdn.reactive.chat, a pro domény s dvoudílnou koncovkou jako .co.uk. Viz Transport.
• data-rc-cdn-base (řetězec, volitelné) – adresář, ze kterého se načítá jádro a moduly. Výchozí: adresář loader.js.
• data-rc-core-url (řetězec, volitelné) – pevná adresa jádra místo core.<hash>.js ze stejného adresáře. Jen pro zvláštní případy, například vlastní zrcadlo.
• data-rc-transport (http, volitelné) – vynutí zálohu přes HTTP od začátku. Funguje na každém prvku přítomném v dokumentu při spuštění; alternativně ReactiveChatSettings.transport = 'http'. Přes boot nemá účinek.
• data-rc-max-retries (číslo, výchozí 2) – opakování při nenačtení jádra (interval 300 ms × pokus).

Jazyk, motiv, pohyb

• data-rc-locale (řetězec, výchozí auto) – de, en nebo pl. auto přebírá <html lang>, pak jazyk prohlížeče, jinak angličtinu. Jiné jazyky přejdou na angličtinu.
• data-rc-theme (auto | light | dark, výchozí auto) – auto sleduje světlý/tmavý režim stránky, jinak systému.
• data-rc-motion (auto | reduced | full, výchozí auto) – animace; auto sleduje prefers-reduced-motion.
• data-rc-strings (objekt JSON, výchozí {}) – přepsání jednotlivých textů, například {"a11y.launcher":"Open help"}. Jinak texty spravujete v účtu (Přizpůsobení).

Zobrazení a poloha

• data-rc-position (right | left, výchozí right) – roh tlačítka chatu a okna.
• data-rc-offset (JSON, výchozí {"x":20,"y":20}) – vzdálenost od okraje v pixelech navíc k bezpečné oblasti.
• data-rc-z-index (číslo, výchozí 2147483000).
• data-rc-avoid-overlap (logická hodnota, výchozí true) – vyhýbá se pevným lištám u dolního okraje (bannery cookies, lišty košíku).
• data-rc-hide-launcher (logická hodnota, výchozí false) – bez ikony chatu; okno se otevírá pouze přes vlastní odkazy nebo JavaScript API. Pobídkové bubliny se pak potlačí. Platí bez ohledu na nastavení účtu.
• data-rc-auto-open (logická hodnota, výchozí false) – otevře okno po spuštění.
• data-rc-isolation (shadow | iframe, výchozí shadow) – widget je v uzavřeném shadow DOM; iframe vykresluje okno do rámce pro stránky s velmi agresivními globálními styly.
• data-rc-brand (objekt JSON) – barva značky a tvar tlačítka chatu. Loader z něj ihned čte primary (#rrggbb), onPrimary, radius a launcher.shape (circle, rounded, square, bubble, leaf), launcher.size (44–72) a launcher.size_m; zbytek kontroluje jádro. Kód z účtu už tyto hodnoty nese — bez platné primary loader nezobrazí zástupné tlačítko, ale počká na barvu ze serveru (bez skoku barvy, ale pozdější tlačítko). Pokud objekt obsahuje jen tato počáteční pole, po navázání spojení platí značka z účtu; s dalšími poli (například accent) platí vaše. Podrobnosti pod Přizpůsobení.
• data-rc-logo (objekt JSON) – src, placement (launcher, header, both), height, alt.
• data-rc-custom-css (řetězec) – vlastní CSS uvnitř shadow DOM. Viz Přizpůsobení.

Načítání a chování

• data-rc-load-triggers (seznam, výchozí všech pět) – kdy se načte jádro: idle (prohlížeč má volnou chvíli), pointer (myš nebo prst na tlačítku chatu), command (příkaz API jiný než boot, update, track, identify), frustration (signál MousePlayeru), push. První spouštěč vyhrává.
• data-rc-idle-timeout-ms (číslo, výchozí 3000) – časový limit spouštěče idle.
• data-rc-consent (auto | granted | denied, výchozí auto) – stav souhlasu. auto se ptá platformy souhlasu (IAB TCF v2 přes __tcfapi, jinak consented.eu); granted/denied ho pevně určí. Viz Integrace soukromí.
• data-rc-dom-spiegel (logická hodnota, výchozí true) – false neposílá asistentovi text stránky a vypíná „Ukažte mi to“.
• data-rc-promo (logická hodnota, výchozí true) – false skryje reklamní kartu na této stránce.
• data-rc-launcher-selector (selektor CSS) – kliknutí na odpovídající prvky přepíná okno. Funguje až po načtení jádra; pro odkazy, které mají fungovat ihned, použijte data-rc-open (níže).
• data-rc-dnd (logická hodnota, výchozí false) – počáteční hodnota pro „Nerušit“.
• data-rc-session-ttl-ms (číslo, výchozí 1800000) – jak dlouho se přebírá relace MousePlayeru.
• data-rc-debug (logická hodnota, výchozí false) – diagnostický výpis v konzoli. Rovnocenné: localStorage.setItem('rc_debug', '1') v prohlížeči.

Atributy na dalších prvcích stránky

Otevření chatu (funguje ihned, i před načtením jádra):

• data-rc-open – na libovolném prvku; kliknutí otevře chat vedle prvku. data-rc-open="corner" ho otevře v rohu.
• href="#rc-open" nebo href="#reactive-chat" – totéž pro odkazy.
• data-rc-anchor="none" – jako corner.
• data-rc-message – text, který se napíše do vstupního pole, ale neodešle (nejvýše 200 znaků).
• data-rc-tab – msg, home nebo help: která karta je vpředu.

Podrobně: Otevření chatu z vlastního odkazu nebo tlačítka.

Text o ochraně osobních údajů:

• data-rc-privacy – zástupný prvek pro část o reactive.chat ve vašich zásadách ochrany osobních údajů, s data-lang, data-heading (2–6) a data-email. Stav v data-rc-privacy-state (loading, done, error). Viz Integrace soukromí.

Vyloučení textu stránky:

• data-rc-private nebo rovnocenně data-rc-ignore – tento podstrom se nikdy neposílá asistentovi jako text stránky a nikdy na něj nemíří „Ukažte mi to“.

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

Parametry URL

• ?rc_ab=A až E – vynutí variantu běžícího A/B testu pro kontrolu kvality (viz Přizpůsobení).

Při načítání widget nevyhodnocuje žádné další parametry v adrese.

Vícenásobné vložení

Pokud je loader na stránce dvakrát (například přes šablonu a správce značek), spustí se jen první s platným klíčem webu; druhý nic nedělá. První značka s neplatným klíčem nezablokuje správnou druhou.

Dále: JavaScript API · Události