Integrace: technická reference pro vývojáře

Tato reference je určena vývojářům, kteří začleňují reactive.chat do webu, aplikace nebo backendu. Popisuje rozhraní a postupy tak, jak jsou implementovány v kódu – s názvy, typy, výchozími hodnotami a chybovými stavy.

Nastavení vzhledu, textů, úvodní obrazovky, pravidel, průvodců, A/B testů a osobnosti AI popisuje část Přizpůsobení. Používání účtu a pultu popisuje Příručka.

Na první pohled

Your visitors' browser                      reactive.chat                         your server
----------------------                      -------------                         -----------
loader.js  --(trigger)-->   core.<hash>.js  cdn.reactive.chat
   window.ReactiveChat (API, events)
   WebSocket rc.v1  <------------------->   ws.reactive.chat/rc_wss/
   HTTP fallback (SSE/Poll) <----------->   ws.reactive.chat/rc_wss/h/
                                            chat server  --- POST (signed) ---->  customer data endpoint
                                                         --- POST (signed) ---->  webhook receiver
                                            reactive.chat/v1  <--- Bearer -----  REST API / MCP
identify(userHash)  <-------------------------------------- HMAC-SHA256 ------  identity secret

Na straně klienta vložíte značku script a volitelně ovládáte widget přes window.ReactiveChat. Na straně serveru podepisujete identitu přihlášených uživatelů, podle potřeby odpovídáte na požadavky na zákaznická data, přijímáte webhooky a používáte REST API.

Kapitoly

Základy

• Architektura a průběh – jednotlivé části, jejich spolupráce, verze a doručování
• Rychlý start – vložení, zadání domény, CSP, kontrola

V prohlížeči

• Reference značky script – všechny atributy data-rc-* a zdroje konfigurace
• JavaScript API – všechny příkazy ReactiveChat(…)
• Události – on/off a události DOM
• Identifikace návštěvníků a předávání kontextu – identify, userHash, exp, track
• Jednostránkové aplikace a změny stránek
• Zabezpečení a Content Security Policy

Připojení a doručování

• Vlastní doména a proxy na vaší doméně – nginx, Apache, Caddy
• Přenos: WebSocket, záloha přes HTTP, opětovné připojení – protokol, chybové kódy a kódy uzavření

Na vašem serveru

• Endpoint zákaznických dat – načítání a import objednávek
• Webhooky – události, podpis, opakované pokusy, REST hooky
• Serverové API (REST v1) a MCP
• Integrace a kanály – WhatsApp, Messenger, Instagram, Telegram, SMS, e-mail

Další místa pro začlenění

• Mobilní aplikace – chat ve WebView
• Smart Answer – odpověď AI ve vyhledávání na vašem webu

Provoz

• Integrace ochrany soukromí – souhlas, úložiště, text o ochraně osobních údajů
• Limity a kvóty
• Řešení problémů a kontrolní seznam

Další stránky k tématu

• Vložení widgetu – stručná verze
• Technické podrobnosti – naměřené velikosti, přístupnost a kontrast
• Otevření chatu vlastním odkazem nebo tlačítkem
• Reklamní karta v chatu
• Zákaznická data v chatu
• Vlastní doména (first-party)
• Záloha přes HTTP
• Automatické vložení textu o ochraně osobních údajů

Pojmy

• Klíč webu – veřejný klíč projektu (24 znaků), který je součástí vkládacího kódu. Není tajný.
• Projekt – web nebo aplikace s vlastními nastaveními; několik projektů tvoří pracovní prostor.
• Pult operátorů – rozhraní, ve kterém váš tým odpovídá.
• Potvrzený uživatel – návštěvník, jehož identitu váš server podepsal pomocí userHash.
• Loader / jádro – malá načítací část loader.js a následně načtená hlavní část core.<hash>.js.

Přehled všech částí dokumentace: Dokumentace.