Paigalda vidin

RolChati vidin on üks hõljuv nupp, mis kohandub sinu sisse lülitatud moodulitega: vestlus, tagasihelistamise taotluse vorm, kohtumiste broneerimine, müügivihje vorm ja teadmusbaasi otsing asuvad kõik selle sees. Paigalda see üks kord; mida see kuvab, otsustatakse töölaual.

1. Kopeeri koodilõik

Vali jaotises Seaded → Vidin sait ja kopeeri paigalduskood. See näeb välja selline:

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

Vidina võti on avalik ja seda võib lehele lisada ohutult. See nimetab sinu saidi ja on allkirjastatud, nii et keegi ei saa vidina koopiat sinu konto poole suunata. Kui muudad vidina seadeid, lisab töölaud objekti täiendavaid võtmeid (tervitus, päise pealkiri, teema, tööaeg, vaateava põhine paigutus); kopeeri koodilõik pärast muutmist uuesti või jäta objekt minimaalseks ja lase vidinal ülejäänu ise laadida.

stub.js on mõne kilobaidi suurune ja laadib ülejäänu alles siis, kui külastaja seda vajab: vestlusliidese esimesel avamisel, jälgimise pärast nõusolekut, nõusolekuriba seal, kus see on nõutav.

2. Kleebi see enne `</body>`

Lisa koodilõik igale lehele, kus soovid vidinat näha, soovitatavalt saidi malli või sildihalduri kaudu, et see ilmuks korraga kõikjale. Skript laaditakse asünkroonselt ega blokeeri renderdamist; esimese laadimise pakett on meelega väike, et see ei mõjutaks sinu Core Web Vitalsi näitajaid.

3. Kontrolli, et see töötab

Ava oma sait privaatses aknas. Nupp ilmub sinu valitud nurka. Töölaual näitab Külastajad uut anonüümset seanssi reaalajas ja vidinast saadetud sõnum ilmub postkasti uue vestlusena.

Sisselogitud kasutajate tuvastamine

Kui sinu külastajad logivad sinu tootesse sisse, ütle RolChatile, kes nad on, et vestlused seotaks õige kontaktiga:

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

Aktsepteeritud tunnused on email, phone, first_name, last_name, external_id ja lame objekt custom_fields; kõike muud eiratakse. RolChat otsib e-posti aadressi CRM-ist. Kui kontakt on olemas, seotakse seanss sellega ja agent näeb profiili; kui ei ole, säilitatakse andmed ja müügivihje luuakse siis, kui külastaja esimest korda kirjutab.

Suurema usaldusväärsuse saavutamiseks võib sinu taustasüsteem identiteedi allkirjastada: edasta tunnuste kõrval allkiri, mille RolChat kasutajale väljastab, ja seanss tõstetakse kõrgemale tasemele ainult siis, kui allkiri on kehtiv. Kutsu välja window.rolchat.reset(), kui kasutaja välja logib, muidu näeb järgmine inimene samas brauseris eelmist vestlust.

JavaScripti API

window.rolchat on kättesaadav kohe, kui stub käivitub; enne paketi laadimist tehtud väljakutsed pannakse järjekorda ja täidetakse järjekorras.

Meetod	Mida see teeb
`show()` / `hide()`	Kuvab või peidab käivitusnupu
`open()` / `close()`	Avab või sulgeb vestluspaneeli
`identify(traits)`	Seob seansi isikuga (vt eespool)
`reset()`	Unustab identiteedi ja alustab uut anonüümset seanssi
`pushEvent(name, props)`	Teatab kohandatud sündmusest päästikusõnumite ja automatiseerimise jaoks
`trackPageView(path?)`	Teatab lehe vaatamisest üheleheküljelistes rakendustes
`setLocale(code)`	Vahetab vidina keelt
`showConsentPreferences()`	Avab nõusolekueelistuste keskuse
`on(event, handler)` / `off(event, handler)`	Tellib sündmused `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());

Keel ja kirjasuund

Vidin räägib keelt, mille määrad väärtusega lang objektis window.rolchatConfig (näiteks "lang": "de"); ilma selleta külastaja brauseri keelt, valituna brauseri eelistuste järjekorras RolChati toetatud 40 keele hulgast; kui ükski ei sobi, inglise keelt. Saidi enda keeleseadet ei kasutata: et vidin räägiks sinu saidi keelt, määra lang. Araabia ja heebrea keel kuvatakse paremalt vasakule. Vidin ei tõlgi agendi sõnumeid; agendi poolel saab selle asemel kasutada AI reaalajas tõlget.

Küpsised ja nõusolek

Vidin ei jälgi külastajaid enne nõusolekut seal, kus nõusolekuriba on nõutav. Kui kasutad RolChati privaatsusmoodulit, jagavad riba ja vidin üht nõusoleku olekut. Kui kasutad muud nõusolekutööriista, ootavad vidina analüütikasündmused signaali, mille seadistad jaotises Seaded → Privaatsus → Manustamine.

Kus vidinat seadistatakse

Mida	Kus
Värvid, asukoht, tervitus, sisenemispunktid, paigalduskood	Seaded → Vidin
Millised moodulid vidina sees kuvatakse	Seaded → Moodulid (saidi kaupa)
Tööaeg ja võrguühenduseta sõnum	Seaded → Saidid → Tööaeg
Kindlatel lehtedel kuvatavad päästikusõnumid	Turundus → Päästikud