Installeer die widget

Die RolChat-widget is een swewende knoppie wat aanpas by die modules wat jy aangeskakel het: klets, ’n vorm om ’n terugbel te versoek, vergaderingsbespreking, ’n leadvorm en kennisbasis-soektog is almal daarin. Installeer dit een keer; wat dit wys, word op die kontroleskerm besluit.

1. Kopieer die brokkie

Kies die webwerf in Instellings → Widget en kopieer die installeringsbrokkie. Dit lyk so:

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

Die widgetsleutel is publiek en veilig om in ’n bladsy te plaas. Dit benoem jou webwerf en is onderteken, sodat niemand ’n kopie van die widget na jou rekening kan laat wys nie. Die kontroleskerm voeg verdere sleutels by die objek (groet, opskrif, tema, werksure, uitleg per skermgrootte) soos jy die widget-instellings verander; kopieer die brokkie weer ná die veranderinge, of hou die objek minimaal en laat die widget die res gaan haal.

stub.js is ’n paar kilogrepe en laai die res eers wanneer die besoeker dit nodig het: die kletsvlak met die eerste oopmaak, opsporing ná toestemming, en die toestemmingsbanier waar een vereis word.

2. Plak dit voor </body>

Voeg die brokkie by elke bladsy waar jy die widget wil hê, verkieslik deur jou webwerfsjabloon of merkerbestuurder sodat dit oral gelyktydig verskyn. Die skrip laai asinchronies en blokkeer nie die weergawe nie; die bondel vir die eerste laai word doelbewus klein gehou sodat dit nie jou Core Web Vitals beïnvloed nie.

3. Kontroleer dat dit werk

Maak jou webwerf in ’n privaat venster oop. Die knoppie verskyn in die hoek wat jy gekies het. Op die kontroleskerm wys Besoekers die nuwe anonieme sessie intyds, en ’n boodskap wat vanuit die widget gestuur word, verskyn in die Inboks as ’n nuwe gesprek.

Identifiseer aangemelde gebruikers

As jou besoekers by jou produk aanmeld, vertel RolChat wie hulle is sodat gesprekke aan die regte kontak gekoppel word:

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

Aanvaarde eienskappe is email, phone, first_name, last_name, external_id en ’n plat custom_fields-objek; enigiets anders word geïgnoreer. RolChat soek die e-posadres in die CRM op. As ’n kontak bestaan, word die sessie daaraan gekoppel en die agent sien die profiel; indien nie, word die besonderhede bewaar en ’n lead geskep wanneer die besoeker die eerste keer skryf.

Vir groter vertroue kan jou agterkant die identiteit onderteken: gee die handtekening wat RolChat vir die gebruiker uitreik saam met die eienskappe deur, en die sessie word slegs bevorder wanneer die handtekening geverifieer word. Roep window.rolchat.reset() wanneer die gebruiker afmeld, anders sien die volgende persoon op daardie blaaier die vorige gesprek.

Die JavaScript-API

window.rolchat is beskikbaar sodra die stub loop; oproepe wat gemaak word voordat die bondel gelaai is, word in ’n tou geplaas en in volgorde uitgevoer.

Metode	Wat dit doen
show() / hide()	Wys of versteek die lanseerder
open() / close()	Maak die kletspaneel oop of toe
identify(traits)	Koppel die sessie aan ’n persoon (hierbo)
reset()	Vergeet die identiteit en begin ’n nuwe anonieme sessie
pushEvent(name, props)	Rapporteer ’n pasgemaakte gebeurtenis vir snellerboodskappe en outomatisering
trackPageView(path?)	Rapporteer ’n bladsybesigtiging in enkelbladsy-programme
setLocale(code)	Verander die widget se taal
showConsentPreferences()	Maak die toestemmingsvoorkeursentrum oop
on(event, handler) / off(event, handler)	Teken in op 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());

Taal en rigting

Die widget praat die taal wat jy met lang in window.rolchatConfig vasmaak (byvoorbeeld "lang": "de"); sonder dit die besoeker se blaaiertaal, in die volgorde van die blaaier se voorkeure, gekies uit die 40 tale wat RolChat ondersteun; as geen een pas nie, Engels. Die webwerf se eie taalinstelling word nie gebruik nie: om die widget jou webwerf se taal te laat praat, stel lang. Arabies en Hebreeus word van regs na links weergegee. Agentboodskappe word nie deur die widget vertaal nie; die agentkant kan eerder KI-regstreekse vertaling gebruik.

Koekies en toestemming

Die widget spoor nie besoekers voor toestemming op waar ’n toestemmingsbanier vereis word nie. As jy die RolChat-privaatheidsmodule gebruik, deel die banier en die widget een toestemmingstoestand. As jy ’n ander toestemmingshulpmiddel gebruik, wag die widget se analitiese gebeurtenisse vir die sein wat jy in Instellings → Privaatheid → Inbed opstel.

Waar die widget opgestel word

Wat	Waar
Kleure, posisie, groet, toegangspunte, installeringsbrokkie	Instellings → Widget
Watter modules binne die widget verskyn	Instellings → Modules (per webwerf)
Werksure en die vanlyn-boodskap	Instellings → Webwerwe → Werksure
Snellerboodskappe wat op spesifieke bladsye gewys word	Bemarking → Snellers