Architektura a průběh

Součásti

V prohlížeči vašich návštěvníků:

• loader.js – malá načítací část o několika kilobajtech. Přečte konfiguraci, ověří souhlas, vykreslí zástupné tlačítko chatu v konečné poloze (bez posunu rozvržení) a vytvoří window.ReactiveChat s frontou příkazů. Nic dalšího nedělá.
• Jádro (core.<hash>.js) – okno chatu, připojení, maskování osobních údajů, pravidla. Načte se až po aktivaci spouštěče: prohlížeč má volnou chvíli, myš nebo prst na tlačítku chatu, příkaz API, signál frustrace z MousePlayeru. Většina návštěvníků chat nikdy neotevře, a proto ho ani hned nenačítá.
• Moduly podle potřeby – prohlídky produktu, text o ochraně osobních údajů, funkce obchodu; každý pouze tehdy, když je potřeba.
• Izolace – vše je v uzavřeném shadow DOM; styly přes konstruovatelné styly CSS, žádné inline skripty, žádný eval, žádné cookies.

U reactive.chat:

• Doručování souborů na https://cdn.reactive.chat/ – loader, jádro, moduly.
• Chatovací server na wss://ws.reactive.chat/rc_wss/ – WebSocket s protokolem rc.v1; stejná adresa s https:// pro zálohu přes HTTP, offline formulář, nahrávání, text o ochraně osobních údajů a Smart Answer.
• Účet na https://reactive.chat/app – nastavení projektu, design, znalostní báze, pult vašeho týmu.
• Serverové API na https://reactive.chat/v1/ – REST a MCP pro váš backend.

Na vaší straně (volitelně):

• Váš backend podepisuje identitu přihlášených uživatelů, odpovídá na požadavky na zákaznická data, přijímá webhooky a volá serverové API.
• Vaše proxy poskytuje vše přes vlastní subdoménu (Vlastní doména).

Průběh zobrazení stránky

1. Prohlížeč načte loader.js (asynchronně, nic neblokuje).
2. Loader přečte data-rc-*, ReactiveChatSettings a volání boot ve frontě, ověří klíč webu a souhlas a vykreslí zástupný prvek.
3. Aktivuje se spouštěč; loader načte jádro ze stejného adresáře.
4. Jádro převezme zástupný prvek i frontu a zpracuje příkazy ve frontě v daném pořadí.
5. Otevře připojení a odešle init s klíčem webu, ID, jazykem, souhlasem, případnou podepsanou identitou a kontextem stránky.
6. Server ověří origin, projekt a identitu a odpoví init_ok: design a texty z účtu, pravidla, funkce, limity, dosavadní historie konverzace.
7. Widget je připraven (událost ready). Změny stránek v jednostránkových aplikacích hlásí sám.

Průběh otázky

1. Návštěvník píše; osobní údaje se maskují v prohlížeči a zpráva nese jedinečné ID.
2. Server ji uloží (opakování pozná podle ID), znovu ji maskuje a potvrdí ozvěnou.
3. Asistent AI prohledá vaši znalostní bázi — u otázek na objednávky od potvrzeného uživatele navíc přes endpoint zákaznických dat — a streamuje odpověď. Kdy předá konverzaci týmu, nastavujete v účtu (Příručka).
4. Souběžně události procházejí frontou k webhookům a integracím. Chat na ně nikdy nečeká.

Verze a doručování souborů

• loader.js nemá v názvu číslo verze a při aktualizacích se nahrazuje. Proto ho vkládejte z cdn.reactive.chat (nebo přes svou proxy), ne jako kopii.
• Jádro se jmenuje core.<hash>.js; hash vychází z jeho obsahu a každý loader přesně zná své jádro. Loader a jádro tak vždy odpovídají a jádro lze dlouhodobě ukládat do mezipaměti.
• Konfigurace (design, texty, pravidla, prohlídky) přichází ze serveru při každém připojení. Změny v účtu nevyžadují nový vkládací kód; projeví se po krátké době (podle nastavení až do jedné minuty).
• Verze protokolu je 1. Nová pole se přidávají; neznámá se ignorují.
• ReactiveChat.version vrací verzi jádra po jeho načtení.

Kde co nastavit

• V účtu: vzhled, texty, úvodní obrazovka, pravidla, prohlídky, A/B testy, osobnost AI (Přizpůsobení), tým, znalostní báze, kanály (Příručka).
• Na značce script: co má platit pro jednotlivou stránku (Referenční přehled značky script).
• Ve skriptu stránky: identita, kontext, otevírání z vlastních prvků (JavaScript API).
• Na vašem serveru: podpisy, zákaznická data, webhooky, API (Identita, Zákaznická data, Webhooky, Serverové API).

Dále: Rychlý start