Vložení widgetu

Stručně

Vložte tento řádek do hlavičky stránky a nahraďte SITE_KEY svým klíčem:

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

To je vše. Loader má 3,48 kB a jádro načte až tehdy, když má prohlížeč čas nebo se návštěvník dotkne tlačítka chatu.

Pokud poskytujete loader.js sami, potřebujete ještě jeden řádek

Někdo raději načítá skript z vlastního adresáře než z naší distribuční sítě — kvůli zásadám, testovacímu prostředí nebo ze zvyku. To funguje, ale pak musíte výslovně uvést připojení chatu:

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

Proč: bez toho widget odvodí adresu z místa, odkud skript přišel. Pokud to byla vaše doména, hledá tam i chat — a nic nenajde.

A selhání je zrádné. Tlačítko se zobrazí, okno se otevře, barva i jazyk jsou správné, vše vypadá hotové. Jen žádná zpráva nikdy nedorazí. Chyba se nezobrazí: připojení se na pozadí dál opakuje a právě to závadu skrývá. Pouze konzole prohlížeče uvádí hostitele, kterého marně hledá.

Výše uvedená hodnota je stejná pro každý účet u nás. Vlastní zadáváte pouze tehdy, pokud server provozujete sami.

Přes subdoménu vlastního webu

Pokud má chat běžet first-party přes vaši subdoménu (například chat.your-company.com místo cdn.reactive.chat), nastavení proxy popisuje návod k vlastní doméně. Účet pak zobrazuje odpovídající vkládací kód.

Když je WebSocket blokovaný

Pokud síť nepropustí WebSocket, například za firemní proxy, chat automaticky pokračuje přes běžné HTTPS. Vaše Content Security Policy k tomu potřebuje níže uvedenou adresu s https:// navíc k adrese s wss://. Kdy se záloha použije a jak ji vynutit pro testování, popisuje Záloha přes HTTP.

Otevření chatu z vlastních odkazů a zobrazení reklamní karty

Libovolný odkaz nebo tlačítko na stránce může otevřít chat, přičemž se okno zobrazí hned vedle něj: Otevření chatu z vlastního odkazu nebo tlačítka. Jak v chatu zobrazit kartu vlastní nabídky, například placeného tarifu, popisuje Reklamní karta v chatu.

Automatické vložení textu o ochraně osobních údajů

Malý prvek na stránce se zásadami ochrany osobních údajů zobrazuje odpovídající text o chatu, vždy podle nastavení projektu a v jazyce stránky: Automatické vložení textu o ochraně osobních údajů.

Proč není potřeba inline skript

Běžná podoba dodávaná konkurencí je inline <script>. Při striktní Content Security Policy bez unsafe-inline se zablokuje dříve, než se provede jediný řádek. Výše uvedená podoba s atributy ho nepotřebuje.

Co dalšího musí zásady povolovat:

• script-src distribučního hostitele, zde cdn.reactive.chat
• connect-src adresu WebSocket, zde wss://ws.reactive.chat
• connect-src stejnou adresu s https:// také, zde https://ws.reactive.chat — offline formulář a záloha přes HTTP ji používají, když firemní proxy blokuje WebSocket

Nastavení na značce script

1. data-rc-site-key — povinné. Bez něj se nic nespustí, a to záměrně.
2. data-rc-locale — de, en nebo pl. Pokud chybí, rozhodne prohlížeč.
3. data-rc-brand — barva vaší značky. Text se přepočítává, dokud není čitelný.
4. data-rc-ws-url — povinné, jakmile loader.js nenačítáte z cdn.reactive.chat. Viz výše.

Vše ostatní je v přehledu funkcí a na stránce s cenami.

Podrobně v dokumentaci

Krok za krokem: Rychlý start. Každý atribut značky script s typem a výchozí hodnotou: Referenční přehled značky script. Všechny kapitoly jsou v dokumentaci.