A widget telepítése

A RolChat widget egyetlen lebegő gomb, amely alkalmazkodik a bekapcsolt modulokhoz: a chat, a visszahíváskérő űrlap, az időpontfoglalás, az érdeklődői űrlap és a tudásbázis-keresés mind benne található. Egyszer telepíted; hogy mit mutat, azt az irányítópulton döntöd el.

1. A kódrészlet másolása

A Beállítások → Widget menüben válaszd ki a webhelyet, és másold ki a telepítőkódot. Így néz ki:

<!-- 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>

A widgetkulcs nyilvános, és nyugodtan szerepelhet egy oldalon. Megnevezi a webhelyedet, és alá van írva, így senki sem irányíthatja a widget egy másolatát a fiókodra. Ahogy módosítod a widget beállításait, az irányítópult további kulcsokat ad az objektumhoz (üdvözlés, fejléccím, téma, munkaidő, nézetenkénti elrendezés); a módosítások után másold ki újra a kódrészletet, vagy hagyd az objektumot minimálisnak, és hagyd, hogy a widget a többit maga töltse le.

A stub.js néhány kilobájt, és a többit csak akkor tölti be, amikor a látogatónak szüksége van rá: a chatfelületet az első megnyitáskor, a követést a hozzájárulás után, a hozzájárulási sávot ott, ahol kötelező.

2. Beillesztés a </body> elé

Illeszd be a kódrészletet minden olyan oldalra, ahol a widgetet látni szeretnéd, ideális esetben a webhelysablonon vagy a címkekezelőn keresztül, hogy egyszerre mindenhol megjelenjen. A szkript aszinkron módon töltődik be, és nem blokkolja a megjelenítést; az első betöltés csomagja szándékosan kicsi, hogy ne befolyásolja a Core Web Vitals mutatóidat.

3. Működés ellenőrzése

Nyisd meg a webhelyedet egy privát ablakban. A gomb a kiválasztott sarokban jelenik meg. Az irányítópulton a Látogatók valós időben mutatja az új névtelen munkamenetet, a widgetből küldött üzenet pedig új beszélgetésként jelenik meg a Beérkezett üzenetek között.

Bejelentkezett felhasználók azonosítása

Ha a látogatóid bejelentkeznek a termékedbe, közöld a RolChattel, kik ők, hogy a beszélgetések a megfelelő kapcsolathoz kerüljenek:

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

Az elfogadott jellemzők: email, phone, first_name, last_name, external_id és egy lapos custom_fields objektum; minden mást figyelmen kívül hagyunk. A RolChat megkeresi az e-mail-címet a CRM-ben. Ha létezik kapcsolat, a munkamenet hozzá kapcsolódik, és az ügynök látja a profilt; ha nem, az adatok megmaradnak, és érdeklődő jön létre, amikor a látogató először ír.

A nagyobb megbízhatóság érdekében a backended aláírhatja az identitást: add át a jellemzők mellett azt az aláírást, amelyet a RolChat a felhasználóhoz kiállít, és a munkamenet csak akkor kerül előléptetésre, ha az aláírás érvényes. Hívd meg a window.rolchat.reset() függvényt, amikor a felhasználó kijelentkezik, különben a böngészőt következőként használó személy az előző beszélgetést látja.

A JavaScript API

A window.rolchat azonnal elérhető, amint a stub lefut; a csomag betöltése előtt indított hívások sorba kerülnek, és sorrendben hajtódnak végre.

Metódus	Mit csinál
show() / hide()	Megjeleníti vagy elrejti az indítógombot
open() / close()	Megnyitja vagy bezárja a chatpanelt
identify(traits)	A munkamenetet egy személyhez kapcsolja (lásd fent)
reset()	Elfelejti az identitást, és új névtelen munkamenetet indít
pushEvent(name, props)	Egyéni eseményt jelent a triggerüzenetekhez és az automatizáláshoz
trackPageView(path?)	Oldalmegtekintést jelent egyoldalas alkalmazásokban
setLocale(code)	Átváltja a widget nyelvét
showConsentPreferences()	Megnyitja a hozzájárulási beállítások központját
on(event, handler) / off(event, handler)	Feliratkozás a chat:opened, chat:closed, message:sent, message:received, session:started eseményekre

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

Nyelv és írásirány

A widget abban a nyelven szól, amelyet a window.rolchatConfig lang mezőjében megadsz (például "lang": "de"); enélkül a látogató böngészőjének nyelvén, a böngésző beállításainak sorrendjében, a RolChat által támogatott 40 nyelv közül; ha egyik sem egyezik, angolul. A webhely saját nyelvi beállítását nem használja: hogy a widget a webhelyed nyelvén szóljon, add meg a lang értékét. Az arab és a héber jobbról balra jelenik meg. Az ügynöki üzeneteket a widget nem fordítja le; az ügynöki oldalon helyette AI élő fordítás használható.

Sütik és hozzájárulás

Ahol hozzájárulási sáv kötelező, a widget a hozzájárulás előtt nem követi a látogatókat. Ha a RolChat Adatvédelem modult használod, a sáv és a widget közös hozzájárulási állapotot használ. Ha más hozzájáruláskezelő eszközt használsz, a widget analitikai eseményei a Beállítások → Adatvédelem → Beágyazás menüben beállított jelre várnak.

Hol konfigurálható a widget

Mit	Hol
Színek, pozíció, üdvözlés, belépési pontok, telepítőkód	Beállítások → Widget
Mely modulok jelennek meg a widgetben	Beállítások → Modulok (webhelyenként)
Munkaidő és az offline üzenet	Beállítások → Webhelyek → Munkaidő
Adott oldalakon megjelenő triggerüzenetek	Marketing → Triggerek