Instalirajte widget

RolChat widget je jedan plutajući gumb koji se prilagođava uključenim modulima: chat, obrazac za zahtjev za povratni poziv, rezervacija sastanaka, obrazac za leadove i pretraživanje baze znanja nalaze se u njemu. Instalirate ga jednom; što prikazuje, odlučujete na nadzornoj ploči.

1. Kopirajte isječak

U Postavke → Widget odaberite stranicu i kopirajte isječak za instalaciju. Izgleda ovako:

<!-- 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 javan i može se sigurno uključiti u stranicu. Označava vašu stranicu i potpisan je, pa nitko ne može usmjeriti kopiju widgeta na vaš račun. Dok mijenjate postavke widgeta, nadzorna ploča dodaje objektu nove ključeve (pozdrav, naslov zaglavlja, tema, radno vrijeme, raspored za pojedine veličine zaslona); nakon promjena ponovno kopirajte isječak ili ostavite objekt minimalnim i pustite widget da sam dohvati ostalo.

stub.js ima nekoliko kilobajta i ostatak učitava tek kada ga posjetitelj treba: sučelje chata pri prvom otvaranju, praćenje nakon privole, traku privole ondje gdje je obavezna.

2. Zalijepite ga prije </body>

Dodajte isječak na svaku stranicu na kojoj želite widget, najbolje putem predloška stranice ili upravitelja oznaka kako bi se odjednom pojavio posvuda. Skripta se učitava asinkrono i ne blokira prikaz; paket za prvo učitavanje namjerno je malen kako ne bi utjecao na vaše Core Web Vitals.

3. Provjerite radi li

Otvorite svoju stranicu u privatnom prozoru. Gumb se pojavljuje u kutu koji ste odabrali. Na nadzornoj ploči Posjetitelji prikazuju novu anonimnu sesiju u stvarnom vremenu, a poruka poslana iz widgeta pojavljuje se u ulaznom pretincu kao novi razgovor.

Identifikacija prijavljenih korisnika

Ako se vaši posjetitelji prijavljuju u vaš proizvod, recite RolChatu tko su kako bi se razgovori povezali s pravim kontaktom:

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

Prihvaćena obilježja su email, phone, first_name, last_name, external_id i ravni objekt custom_fields; sve ostalo se zanemaruje. RolChat traži e-poštu u CRM-u. Ako kontakt postoji, sesija se povezuje s njim i agent vidi profil; ako ne postoji, podaci se čuvaju, a lead se izrađuje kada posjetitelj prvi put napiše.

Za veću razinu povjerenja vaš pozadinski sustav može potpisati identitet: uz obilježja proslijedite potpis koji RolChat izdaje za korisnika, a sesija se podiže samo ako je potpis valjan. Pozovite window.rolchat.reset() kada se korisnik odjavi, inače će sljedeća osoba u tom pregledniku vidjeti prethodni razgovor.

JavaScript API

window.rolchat dostupan je čim se pokrene stub; pozivi upućeni prije učitavanja paketa stavljaju se u red i izvršavaju redom.

Metoda	Što radi
show() / hide()	Prikazuje ili skriva gumb widgeta
open() / close()	Otvara ili zatvara ploču chata
identify(traits)	Povezuje sesiju s osobom (gore)
reset()	Zaboravlja identitet i pokreće novu anonimnu sesiju
pushEvent(name, props)	Prijavljuje prilagođeni događaj za poruke s okidačem i automatizaciju
trackPageView(path?)	Prijavljuje prikaz stranice u aplikacijama s jednom stranicom
setLocale(code)	Mijenja jezik widgeta
showConsentPreferences()	Otvara centar postavki privole
on(event, handler) / off(event, handler)	Pretplata 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 i smjer teksta

Widget govori jezikom koji zadate u lang u window.rolchatConfig (na primjer "lang": "de"); bez toga jezikom preglednika posjetitelja, prema redoslijedu postavki preglednika, između 40 jezika koje RolChat podržava; ako nijedan ne odgovara, engleskim. Jezik postavljen na stranici ne koristi se: da bi widget govorio jezikom vaše stranice, postavite lang. Arapski i hebrejski prikazuju se zdesna nalijevo. Widget ne prevodi poruke agenata; na strani agenta umjesto toga može se koristiti AI prijevod uživo.

Kolačići i privola

Widget ne prati posjetitelje prije privole ondje gdje je traka privole obavezna. Ako koristite RolChat modul Privatnost, traka i widget dijele jedno stanje privole. Ako koristite drugi alat za privolu, analitički događaji widgeta čekaju signal koji konfigurirate u Postavke → Privatnost → Ugradnja.

Gdje se widget konfigurira

Što	Gdje
Boje, položaj, pozdrav, ulazne točke, isječak za instalaciju	Postavke → Widget
Koji se moduli prikazuju u widgetu	Postavke → Moduli (po stranici)
Radno vrijeme i poruka o nedostupnosti	Postavke → Stranice → Radno vrijeme
Poruke s okidačem na određenim stranicama	Marketing → Okidači