Namestite widget

Widget RolChat je en plavajoč gumb, ki se prilagodi vklopljenim modulom: klepet, obrazec za prošnjo za povratni klic, rezervacija sestankov, obrazec za potencialne stranke in iskanje po bazi znanja so vsi v njem. Namestite ga enkrat; kaj prikazuje, določite v nadzorni plošči.

1. Kopirajte kodo

V Nastavitve → Widget izberite spletno mesto in kopirajte kodo za namestitev. Videti je takole:

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

Ključ widgeta je javen in ga lahko varno vključite v stran. Označuje vaše spletno mesto in je podpisan, zato nihče ne more usmeriti kopije widgeta na vaš račun. Ko spreminjate nastavitve widgeta, nadzorna plošča v objekt dodaja nove ključe (pozdrav, naslov glave, tema, delovni čas, postavitev za posamezne velikosti zaslona); po spremembah kodo znova kopirajte ali pa pustite objekt minimalen in naj widget preostanek pridobi sam.

stub.js ima nekaj kilobajtov in preostanek naloži šele, ko ga obiskovalec potrebuje: vmesnik klepeta ob prvem odprtju, sledenje po privolitvi, pasico za privolitev tam, kjer je obvezna.

2. Prilepite jo pred </body>

Kodo dodajte na vsako stran, kjer želite widget, najbolje prek predloge spletnega mesta ali upravitelja oznak, da se hkrati pojavi povsod. Skripta se naloži asinhrono in ne blokira izrisa; paket za prvo nalaganje je namenoma majhen, da ne vpliva na vaše Core Web Vitals.

3. Preverite, ali deluje

Odprite svoje spletno mesto v zasebnem oknu. Gumb se prikaže v kotu, ki ste ga izbrali. V nadzorni plošči Obiskovalci prikaže novo anonimno sejo v realnem času, sporočilo, poslano iz widgeta, pa se v nabiralniku prikaže kot nov pogovor.

Prepoznavanje prijavljenih uporabnikov

Če se vaši obiskovalci prijavljajo v vaš izdelek, povejte RolChat, kdo so, da se pogovori povežejo s pravim stikom:

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

Sprejete lastnosti so email, phone, first_name, last_name, external_id in ploski objekt custom_fields; vse drugo je prezrto. RolChat poišče e-poštni naslov v CRM. Če stik obstaja, se seja poveže z njim in agent vidi profil; če ne, se podatki ohranijo, potencialna stranka pa se ustvari, ko obiskovalec prvič piše.

Za večjo stopnjo zaupanja lahko vaše zaledje identiteto podpiše: skupaj z lastnostmi posredujte podpis, ki ga RolChat izda za uporabnika, seja pa se povzdigne samo, če je podpis veljaven. Ko se uporabnik odjavi, pokličite window.rolchat.reset(), sicer bo naslednja oseba v tem brskalniku videla prejšnji pogovor.

API JavaScript

window.rolchat je na voljo takoj, ko se zažene stub; klici pred nalaganjem paketa se postavijo v vrsto in izvedejo po vrsti.

Metoda	Kaj naredi
show() / hide()	Prikaže ali skrije gumb widgeta
open() / close()	Odpre ali zapre ploščo klepeta
identify(traits)	Poveže sejo z osebo (zgoraj)
reset()	Pozabi identiteto in začne novo anonimno sejo
pushEvent(name, props)	Sporoči dogodek po meri za sprožena sporočila in avtomatizacijo
trackPageView(path?)	Sporoči ogled strani v enostranskih aplikacijah
setLocale(code)	Spremeni jezik widgeta
showConsentPreferences()	Odpre središče nastavitev privolitve
on(event, handler) / off(event, handler)	Naročnina na 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());

Jezik in smer besedila

Widget govori v jeziku, ki ga pripnete s lang v window.rolchatConfig (na primer "lang": "de"); brez njega v jeziku brskalnika obiskovalca, po vrstnem redu nastavitev brskalnika, med 40 jeziki, ki jih podpira RolChat; če se noben ne ujema, v angleščini. Jezikovna nastavitev samega spletnega mesta se ne uporablja: da widget govori v jeziku vašega spletnega mesta, nastavite lang. Arabščina in hebrejščina se prikazujeta od desne proti levi. Widget sporočil agentov ne prevaja; na strani agenta lahko namesto tega uporabite prevajanje v živo z AI.

Piškotki in privolitev

Tam, kjer je pasica za privolitev obvezna, widget obiskovalcev pred privolitvijo ne sledi. Če uporabljate modul Zasebnost RolChat, si pasica in widget delita eno stanje privolitve. Če uporabljate drugo orodje za privolitve, analitični dogodki widgeta čakajo na signal, ki ga nastavite v Nastavitve → Zasebnost → Vdelava.

Kje se nastavlja widget

Kaj	Kje
Barve, položaj, pozdrav, vstopne točke, koda za namestitev	Nastavitve → Widget
Kateri moduli se prikažejo v widgetu	Nastavitve → Moduli (za vsako spletno mesto)
Delovni čas in sporočilo o nedosegljivosti	Nastavitve → Spletna mesta → Delovni čas
Sprožena sporočila na določenih straneh	Marketing → Sprožilci