Nainštalujte widget

Widget RolChat je jedno plávajúce tlačidlo, ktoré sa prispôsobí zapnutým modulom: chat, formulár so žiadosťou o spätné zavolanie, rezervácia stretnutí, formulár pre leady a vyhľadávanie v báze znalostí sú všetky vnútri. Nainštalujete ho raz; čo zobrazuje, určujete v administrácii.

1. Skopírujte kód

V Nastavenia → Widget vyberte web a skopírujte inštalačný kód. Vyzerá 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>

Kľúč widgetu je verejný a možno ho bezpečne vložiť do stránky. Označuje váš web a je podpísaný, takže nikto nemôže nasmerovať kópiu widgetu na váš účet. Keď meníte nastavenia widgetu, administrácia pridáva do objektu ďalšie kľúče (pozdrav, titulok hlavičky, motív, pracovný čas, rozloženie pre jednotlivé veľkosti obrazovky); po zmenách kód skopírujte znova, alebo nechajte objekt minimálny a zvyšok si widget načíta sám.

stub.js má pár kilobajtov a zvyšok načíta, až keď ho návštevník potrebuje: rozhranie chatu pri prvom otvorení, sledovanie po udelení súhlasu, lištu súhlasu tam, kde sa vyžaduje.

2. Vložte ho pred </body>

Pridajte kód na každú stránku, kde má byť widget, ideálne cez šablónu webu alebo správcu tagov, aby sa objavil všade naraz. Skript sa načítava asynchrónne a neblokuje vykresľovanie; balík pre prvé načítanie je zámerne malý, aby neovplyvnil vaše Core Web Vitals.

3. Overte, že funguje

Otvorte svoj web v anonymnom okne. Tlačidlo sa objaví vo zvolenom rohu. V administrácii ukazuje Návštevníci novú anonymnú reláciu v reálnom čase a správa odoslaná z widgetu sa objaví v schránke ako nová konverzácia.

Identifikácia prihlásených používateľov

Ak sa vaši návštevníci prihlasujú do vášho produktu, povedzte RolChat, kto sú, aby sa konverzácie pripojili k správnemu kontaktu:

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

Prijímané vlastnosti sú email, phone, first_name, last_name, external_id a plochý objekt custom_fields; všetko ostatné sa ignoruje. RolChat vyhľadá e-mail v CRM. Ak kontakt existuje, relácia sa s ním prepojí a agent vidí profil; ak nie, údaje sa uchovajú a lead sa vytvorí, keď návštevník prvýkrát napíše.

Pre vyššiu dôveru môže váš backend identitu podpísať: spolu s vlastnosťami odovzdajte podpis, ktorý RolChat pre používateľa vydá, a relácia sa povýši len pri úspešnom overení podpisu. Keď sa používateľ odhlási, zavolajte window.rolchat.reset(), inak ďalšia osoba v tomto prehliadači uvidí predchádzajúcu konverzáciu.

JavaScript API

window.rolchat je k dispozícii, len čo sa spustí stub; volania vykonané pred načítaním balíka sa zaradia do frontu a vykonajú sa v poradí.

Metóda	Čo robí
show() / hide()	Zobrazí alebo skryje tlačidlo widgetu
open() / close()	Otvorí alebo zatvorí panel chatu
identify(traits)	Prepojí reláciu s osobou (pozrite vyššie)
reset()	Zabudne identitu a začne novú anonymnú reláciu
pushEvent(name, props)	Nahlási vlastnú udalosť pre spúšťané správy a automatizáciu
trackPageView(path?)	Nahlási zobrazenie stránky v jednostránkových aplikáciách
setLocale(code)	Prepne jazyk widgetu
showConsentPreferences()	Otvorí centrum predvolieb súhlasu
on(event, handler) / off(event, handler)	Odber udalostí 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 smer textu

Widget hovorí jazykom, ktorý pripnete pomocou lang v window.rolchatConfig (napríklad "lang": "de"); bez neho jazykom prehliadača návštevníka, v poradí preferencií prehliadača, spomedzi 40 jazykov, ktoré RolChat podporuje; ak sa žiadny nezhoduje, anglicky. Jazykové nastavenie samotného webu sa nepoužíva: aby widget hovoril jazykom vášho webu, nastavte lang. Arabčina a hebrejčina sa zobrazujú sprava doľava. Správy agentov widget neprekladá; na strane agenta možno namiesto toho použiť živý preklad pomocou AI.

Cookies a súhlas

Tam, kde sa vyžaduje lišta súhlasu, widget návštevníkov pred udelením súhlasu nesleduje. Ak používate modul Súkromie RolChat, lišta a widget zdieľajú jeden stav súhlasu. Ak používate iný nástroj na súhlasy, analytické udalosti widgetu čakajú na signál, ktorý nastavíte v Nastavenia → Súkromie → Vloženie.

Kde sa widget nastavuje

Čo	Kde
Farby, pozícia, pozdrav, vstupné body, inštalačný kód	Nastavenia → Widget
Ktoré moduly sa vo widgete zobrazujú	Nastavenia → Moduly (pre každý web)
Pracovný čas a offline správa	Nastavenia → Weby → Pracovný čas
Spúšťané správy na konkrétnych stránkach	Marketing → Spúšťače