Įdiekite valdiklį

RolChat valdiklis yra vienas plaukiojantis mygtukas, kuris prisitaiko prie jūsų įjungtų modulių: pokalbis, atgalinio skambučio užsakymo forma, susitikimų rezervavimas, potencialių klientų forma ir žinių bazės paieška yra jo viduje. Įdiekite jį vieną kartą; ką jis rodo, sprendžiama skydelyje.

1. Nukopijuokite fragmentą

Skiltyje Nustatymai → Valdiklis pasirinkite svetainę ir nukopijuokite diegimo fragmentą. Jis atrodo taip:

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

Valdiklio raktas yra viešas, jį saugu dėti į puslapį. Jis nurodo jūsų svetainę ir yra pasirašytas, todėl niekas negali nukreipti valdiklio kopijos į jūsų paskyrą. Keičiant valdiklio nustatymus, skydelis prideda į objektą daugiau raktų (pasisveikinimą, antraštės pavadinimą, temą, darbo valandas, išdėstymą pagal ekrano dydį); pakeitę juos, nukopijuokite fragmentą iš naujo arba palikite objektą minimalų ir leiskite valdikliui gauti likusią dalį.

stub.js sveria kelis kilobaitus ir likusią dalį įkelia tik tada, kai jos prireikia lankytojui: pokalbio sąsają pirmą kartą atidarius, sekimą po sutikimo, sutikimo juostą ten, kur ji privaloma.

2. Įklijuokite jį prieš `</body>`

Pridėkite fragmentą į kiekvieną puslapį, kuriame norite valdiklio, geriausia per svetainės šabloną ar žymių tvarkyklę, kad jis iškart atsirastų visur. Scenarijus įkeliamas asinchroniškai ir neblokuoja atvaizdavimo; pirmo įkėlimo paketas sąmoningai laikomas mažas, kad nepaveiktų jūsų Core Web Vitals.

3. Patikrinkite, ar veikia

Atidarykite savo svetainę privačiame lange. Mygtukas atsiranda pasirinktame kampe. Skydelio skiltyje Lankytojai realiu laiku matoma nauja anoniminė sesija, o iš valdiklio išsiųsta žinutė gautųjų dėžutėje atsiranda kaip naujas pokalbis.

Atpažinkite prisijungusius naudotojus

Jei jūsų lankytojai prisijungia prie jūsų produkto, praneškite RolChat, kas jie yra, kad pokalbiai būtų susieti su tinkamu kontaktu:

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

Priimami požymiai yra email, phone, first_name, last_name, external_id ir plokščias custom_fields objektas; visa kita ignoruojama. RolChat ieško el. pašto adreso CRM sistemoje. Jei kontaktas yra, sesija susiejama su juo ir agentas mato profilį; jei ne, duomenys išsaugomi, o potencialus klientas sukuriamas, kai lankytojas parašo pirmą kartą.

Didesniam patikimumui jūsų serveris gali pasirašyti tapatybę: kartu su požymiais perduokite RolChat išduotą naudotojo parašą, ir sesija bus paaukštinta tik tada, kai parašas patikrinamas. Kai naudotojas atsijungia, iškvieskite window.rolchat.reset(), kitaip kitas tos naršyklės naudotojas matys ankstesnį pokalbį.

JavaScript API

window.rolchat pasiekiamas vos tik paleidžiamas stub; iškvietimai, atlikti prieš įkeliant paketą, įrašomi į eilę ir vykdomi iš eilės.

Metodas	Ką daro
`show()` / `hide()`	Rodo arba slepia paleidimo mygtuką
`open()` / `close()`	Atidaro arba uždaro pokalbio skydelį
`identify(traits)`	Susieja sesiją su asmeniu (žr. aukščiau)
`reset()`	Pamiršta tapatybę ir pradeda naują anoniminę sesiją
`pushEvent(name, props)`	Praneša pasirinktinį įvykį paleidžiamoms žinutėms ir automatizavimui
`trackPageView(path?)`	Praneša puslapio peržiūrą vieno puslapio programose
`setLocale(code)`	Perjungia valdiklio kalbą
`showConsentPreferences()`	Atidaro sutikimų nuostatų centrą
`on(event, handler)` / `off(event, handler)`	Užsiprenumeruoja `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());

Kalba ir teksto kryptis

Valdiklis kalba kalba, kurią nustatote lang lauke window.rolchatConfig (pavyzdžiui, "lang": "de"); jei nenustatyta, lankytojo naršyklės kalba pagal naršyklės nuostatų eilę iš 40 RolChat palaikomų kalbų; jei nė viena netinka, anglų kalba. Svetainės kalbos nustatymas nenaudojamas: kad valdiklis kalbėtų jūsų svetainės kalba, nustatykite lang. Arabų ir hebrajų kalbos rodomos iš dešinės į kairę. Valdiklis agentų žinučių neverčia; agentų pusėje galima naudoti AI tiesioginį vertimą.

Slapukai ir sutikimas

Ten, kur privaloma sutikimo juosta, valdiklis nesiseka lankytojų iki sutikimo. Jei naudojate RolChat Privatumo modulį, juosta ir valdiklis dalijasi viena sutikimo būsena. Jei naudojate kitą sutikimų įrankį, valdiklio analitikos įvykiai laukia signalo, kurį sukonfigūruojate skiltyje Nustatymai → Privatumas → Įterpimas.

Kur konfigūruojamas valdiklis

Kas	Kur
Spalvos, padėtis, pasisveikinimas, įėjimo taškai, diegimo fragmentas	Nustatymai → Valdiklis
Kurie moduliai rodomi valdiklyje	Nustatymai → Moduliai (kiekvienai svetainei)
Darbo valandos ir neprisijungus pranešimas	Nustatymai → Svetainės → Darbo valandos
Paleidžiamos žinutės, rodomos konkrečiuose puslapiuose	Rinkodara → Paleidimo sąlygos