Nainstalujte widget

Widget RolChat je jedno plovoucí tlačítko, které se přizpůsobí zapnutým modulům: chat, formulář s žádostí o zpětné zavolání, rezervace schůzek, formulář pro leady a vyhledávání ve znalostní bázi jsou všechny uvnitř. Nainstalujete ho jednou; co zobrazuje, určujete v administraci.

1. Zkopírujte kód

V Nastavení → Widget vyberte web a zkopírujte instalační kód. Vypadá takto:

<!-- RolChat widget -->
<script>
  window.rolchatConfig = {
    "site_id": "ste_…",
    "account_id": "…",
    "widget_key": "wk1.<site>.<signature>",
    "modules": ["chat"]
  };
</script>
<script async src="https://widget.rolchat.com/stub.js"></script>

Klíč widgetu je veřejný a lze ho bezpečně vložit do stránky. Označuje váš web a je podepsaný, takže nikdo nemůže nasměrovat kopii widgetu na váš účet. Když měníte nastavení widgetu, administrace přidává do objektu další klíče (pozdrav, titulek záhlaví, motiv, pracovní doba, rozvržení pro jednotlivé velikosti obrazovky); po změnách kód zkopírujte znovu, nebo nechte objekt minimální a zbytek si widget načte sám.

stub.js má pár kilobajtů a zbytek načte, až když ho návštěvník potřebuje: rozhraní chatu při prvním otevření, sledování po udělení souhlasu, lištu souhlasu tam, kde je vyžadována.

2. Vložte ho před </body>

Přidejte kód na každou stránku, kde má být widget, ideálně přes šablonu webu nebo správce tagů, aby se objevil všude najednou. Skript se načítá asynchronně a neblokuje vykreslování; balíček pro první načtení je záměrně malý, aby neovlivnil vaše Core Web Vitals.

3. Ověřte, že funguje

Otevřete svůj web v anonymním okně. Tlačítko se objeví ve zvoleném rohu. V administraci ukazuje Návštěvníci novou anonymní relaci v reálném čase a zpráva odeslaná z widgetu se objeví ve schránce jako nová konverzace.

Identifikace přihlášených uživatelů

Pokud se vaši návštěvníci přihlašují do vašeho produktu, řekněte RolChat, kdo jsou, aby se konverzace připojily ke správnému kontaktu:

window.rolchat.identify({
  email: "alice@example.com",
  first_name: "Alice",
  last_name: "Martin",
  phone: "+15551234567",
  external_id: "user_12345",
  custom_fields: { plan: "pro" },
});

Přijímané vlastnosti jsou email, phone, first_name, last_name, external_id a plochý objekt custom_fields; vše ostatní se ignoruje. RolChat vyhledá e-mail v CRM. Pokud kontakt existuje, relace se s ním propojí a agent vidí profil; pokud ne, údaje se uchovají a lead se vytvoří, až návštěvník poprvé napíše.

Pro vyšší důvěru může váš backend identitu podepsat: předejte spolu s vlastnostmi podpis, který RolChat pro uživatele vydá, a relace se povýší jen při úspěšném ověření podpisu. Když se uživatel odhlásí, zavolejte window.rolchat.reset(), jinak další osoba v tomto prohlížeči uvidí předchozí konverzaci.

JavaScript API

window.rolchat je k dispozici, jakmile se spustí stub; volání provedená před načtením balíčku se zařadí do fronty a provedou se v pořadí.

Metoda	Co dělá
show() / hide()	Zobrazí nebo skryje tlačítko widgetu
open() / close()	Otevře nebo zavře panel chatu
identify(traits)	Propojí relaci s osobou (viz výše)
reset()	Zapomene identitu a zahájí novou anonymní relaci
pushEvent(name, props)	Nahlásí vlastní událost pro spouštěné zprávy a automatizaci
trackPageView(path?)	Nahlásí zobrazení stránky v jednostránkových aplikacích
setLocale(code)	Přepne jazyk widgetu
showConsentPreferences()	Otevře centrum předvoleb souhlasu
on(event, handler) / off(event, handler)	Odběr událostí chat:opened, chat:closed, message:sent, message:received, session:started

window.rolchat.pushEvent("cart_abandoned", { value: 129.9, currency: "EUR" });
window.rolchat.on("message:received", () => audio.play());

Jazyk a směr textu

Widget mluví jazykem, který zadáte v lang v window.rolchatConfig (například "lang": "de"); bez něj jazykem prohlížeče návštěvníka podle pořadí preferencí prohlížeče z 40 jazyků, které RolChat podporuje; pokud žádný nesedí, anglicky. Jazyk nastavený na webu se nepoužívá: aby widget mluvil jazykem vašeho webu, nastavte lang. Arabština a hebrejština se zobrazují zprava doleva. Zprávy agentů widget nepřekládá; na straně agenta lze místo toho použít živý překlad pomocí AI.

Cookies a souhlas

Tam, kde je vyžadována lišta souhlasu, widget návštěvníky před udělením souhlasu nesleduje. Pokud používáte modul Soukromí RolChat, lišta a widget sdílejí jeden stav souhlasu. Pokud používáte jiný nástroj pro souhlasy, analytické události widgetu čekají na signál, který nastavíte v Nastavení → Soukromí → Vložení.

Kde se widget nastavuje

Co	Kde
Barvy, pozice, pozdrav, vstupní body, instalační kód	Nastavení → Widget
Které moduly se ve widgetu zobrazují	Nastavení → Moduly (pro každý web)
Pracovní doba a offline zpráva	Nastavení → Weby → Pracovní doba
Spouštěné zprávy na konkrétních stránkách	Marketing → Spouštěče