Logrīka instalēšana

RolChat logrīks ir viena peldoša poga, kas pielāgojas jūsu ieslēgtajiem moduļiem: čats, atzvanīšanas pieprasījuma veidlapa, tikšanos rezervēšana, potenciālo klientu veidlapa un zināšanu bāzes meklēšana atrodas tajā. Instalējiet to vienreiz; to, ko tas rāda, nosaka informācijas panelī.

1. Nokopējiet fragmentu

Sadaļā Iestatījumi → Logrīks izvēlieties vietni un nokopējiet instalēšanas fragmentu. Tas izskatās šādi:

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

Logrīka atslēga ir publiska, un to ir droši ievietot lapā. Tā nosauc jūsu vietni un ir parakstīta, tāpēc neviens nevar novirzīt logrīka kopiju uz jūsu kontu. Mainot logrīka iestatījumus, informācijas panelis objektam pievieno papildu atslēgas (sveiciens, galvenes virsraksts, motīvs, darba laiks, izkārtojums katram skata logam); pēc izmaiņām nokopējiet fragmentu vēlreiz vai atstājiet objektu minimālu un ļaujiet logrīkam pašam ielādēt pārējo.

stub.js ir dažus kilobaitus liels un ielādē pārējo tikai tad, kad apmeklētājam tas vajadzīgs: čata saskarni pirmajā atvēršanas reizē, izsekošanu pēc piekrišanas, piekrišanas joslu tur, kur tā ir obligāta.

2. Ielīmējiet to pirms `</body>`

Pievienojiet fragmentu katrai lapai, kurā vēlaties logrīku, ideālā gadījumā caur vietnes veidni vai tagu pārvaldnieku, lai tas parādītos visur uzreiz. Skripts ielādējas asinhroni un nebloķē attēlošanu; pirmās ielādes pakotne apzināti ir maza, lai neietekmētu jūsu Core Web Vitals.

3. Pārbaudiet, vai tas darbojas

Atveriet savu vietni privātā logā. Poga parādās jūsu izvēlētajā stūrī. Informācijas paneļa sadaļā Apmeklētāji reāllaikā redzama jaunā anonīmā sesija, un no logrīka nosūtīts ziņojums iesūtnē parādās kā jauna saruna.

Pieteikušos lietotāju identificēšana

Ja jūsu apmeklētāji piesakās jūsu produktā, pasakiet RolChat, kas viņi ir, lai sarunas tiktu piesaistītas pareizajam kontaktam:

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

Pieņemtās pazīmes ir email, phone, first_name, last_name, external_id un plakans objekts custom_fields; viss pārējais tiek ignorēts. RolChat meklē e-pastu CRM. Ja kontakts pastāv, sesija tiek ar to sasaistīta un aģents redz profilu; ja nē, dati tiek saglabāti un potenciālais klients tiek izveidots, kad apmeklētājs uzraksta pirmo reizi.

Lielākai uzticamībai jūsu serveris var parakstīt identitāti: kopā ar pazīmēm nododiet parakstu, ko RolChat izsniedz lietotājam, un sesija tiek paaugstināta tikai tad, ja paraksts ir derīgs. Izsauciet window.rolchat.reset(), kad lietotājs izrakstās, citādi nākamais cilvēks šajā pārlūkā redzēs iepriekšējo sarunu.

JavaScript API

window.rolchat ir pieejams, tiklīdz izpildās stub; izsaukumi, kas veikti pirms pakotnes ielādes, tiek ievietoti rindā un izpildīti secīgi.

Metode	Ko tā dara
`show()` / `hide()`	Parāda vai paslēpj palaišanas pogu
`open()` / `close()`	Atver vai aizver čata paneli
`identify(traits)`	Sasaista sesiju ar cilvēku (skatīt augstāk)
`reset()`	Aizmirst identitāti un sāk jaunu anonīmu sesiju
`pushEvent(name, props)`	Ziņo pielāgotu notikumu trigeru ziņojumiem un automatizācijai
`trackPageView(path?)`	Ziņo lapas skatījumu vienas lapas lietotnēs
`setLocale(code)`	Pārslēdz logrīka valodu
`showConsentPreferences()`	Atver piekrišanas preferenču centru
`on(event, handler)` / `off(event, handler)`	Abonē `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());

Valoda un rakstības virziens

Logrīks runā valodā, ko norādāt lang laukā window.rolchatConfig (piemēram, "lang": "de"); bez tā apmeklētāja pārlūka valodā pēc pārlūka preferenču secības no 40 valodām, ko atbalsta RolChat; ja neviena neder, angliski. Vietnes valodas iestatījums netiek izmantots: lai logrīks runātu jūsu vietnes valodā, iestatiet lang. Arābu un ivrita valoda tiek attēlotas no labās uz kreiso. Logrīks netulko aģentu ziņojumus; aģenta pusē tā vietā var izmantot AI tulkošanu reāllaikā.

Sīkfaili un piekrišana

Logrīks neizseko apmeklētājus pirms piekrišanas tur, kur ir obligāta piekrišanas josla. Ja izmantojat RolChat Privātuma moduli, joslai un logrīkam ir viens kopīgs piekrišanas stāvoklis. Ja izmantojat citu piekrišanas rīku, logrīka analītikas notikumi gaida signālu, ko konfigurējat sadaļā Iestatījumi → Privātums → Iegulšana.

Kur konfigurē logrīku

Kas	Kur
Krāsas, novietojums, sveiciens, ieejas punkti, instalēšanas fragments	Iestatījumi → Logrīks
Kuri moduļi parādās logrīkā	Iestatījumi → Moduļi (katrai vietnei)
Darba laiks un bezsaistes ziņojums	Iestatījumi → Vietnes → Darba laiks
Trigeru ziņojumi, kas tiek rādīti konkrētās lapās	Mārketings → Trigeri