I-install ang widget

Ang widget ng RolChat ay isang floating button na umaangkop sa mga module na in-on mo: chat, form para humiling ng callback, pag-book ng meeting, lead form at paghahanap sa base ng kaalaman, lahat nasa loob nito. I-install ito nang isang beses; sa dashboard itinatakda kung ano ang ipapakita nito.

1. Kopyahin ang snippet

Sa Mga Setting → Widget, piliin ang site at kopyahin ang install snippet. Ganito ang itsura nito:

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

Pampubliko ang widget key at ligtas itong ilagay sa pahina. Pinapangalanan nito ang site mo at naka-sign ito, kaya walang makapagtuturo ng kopya ng widget sa account mo. Nagdadagdag ang dashboard ng iba pang key sa object (pagbati, pamagat ng header, theme, oras ng trabaho, layout kada laki ng screen) habang binabago mo ang mga setting ng widget; kopyahin ulit ang snippet pagkatapos baguhin ang mga ito, o panatilihing minimal ang object at hayaang ang widget ang kumuha ng iba pa.

Ilang kilobyte lang ang stub.js at nilo-load lang nito ang iba kapag kailangan ng bisita: ang chat interface sa unang pagbukas, tracking pagkatapos ng pahintulot, at ang consent banner kung saan ito kinakailangan.

2. I-paste ito bago ang </body>

Idagdag ang snippet sa bawat pahinang gusto mong may widget, mas mainam sa pamamagitan ng template ng site o ng tag manager para lumabas ito kahit saan nang sabay-sabay. Asynchronous ang pag-load ng script at hindi nito hinaharangan ang pag-render; sadyang maliit ang first-load bundle para hindi maapektuhan ang Core Web Vitals mo.

3. Tiyaking gumagana ito

Buksan ang site mo sa private window. Lalabas ang button sa sulok na pinili mo. Sa dashboard, ipinapakita ng Mga Bisita ang bagong anonymous na session nang real-time, at lumalabas sa Inbox bilang bagong usapan ang mensaheng ipinadala mula sa widget.

Kilalanin ang mga naka-log in na user

Kung nagsa-sign in sa produkto mo ang mga bisita mo, sabihin sa RolChat kung sino sila para maikabit ang mga usapan sa tamang contact:

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

Ang mga tinatanggap na trait ay email, phone, first_name, last_name, external_id at isang flat na object na custom_fields; binabalewala ang iba pa. Hinahanap ng RolChat ang email sa CRM. Kung may contact na, ikinakabit ang session dito at nakikita ng agent ang profile; kung wala, itinatabi ang mga detalye at gagawa ng lead kapag unang sumulat ang bisita.

Para sa mas mataas na tiwala, puwedeng i-sign ng backend mo ang pagkakakilanlan: ipasa ang signature na inilalabas ng RolChat para sa user kasama ng mga trait, at ipo-promote lang ang session kapag na-verify ang signature. Tawagin ang window.rolchat.reset() kapag nag-sign out ang user, kung hindi ay makikita ng susunod na tao sa browser na iyon ang naunang usapan.

Ang JavaScript API

Available ang window.rolchat sa sandaling tumakbo ang stub; ang mga tawag na ginawa bago mag-load ang bundle ay pumipila at pinapatakbo nang sunud-sunod.

Method	Ginagawa nito
show() / hide()	Ipakita o itago ang launcher
open() / close()	Buksan o isara ang chat panel
identify(traits)	Ikabit ang session sa isang tao (sa itaas)
reset()	Kalimutan ang pagkakakilanlan at magsimula ng bagong anonymous na session
pushEvent(name, props)	Mag-ulat ng custom event para sa mga trigger message at automation
trackPageView(path?)	Mag-ulat ng page view sa mga single-page app
setLocale(code)	Palitan ang wika ng widget
showConsentPreferences()	Buksan ang preference center ng pahintulot
on(event, handler) / off(event, handler)	Mag-subscribe sa 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());

Wika at direksyon

Ginagamit ng widget ang wikang itinakda mo gamit ang lang sa window.rolchatConfig (halimbawa "lang": "de"); kung wala nito, ang wika ng browser ng bisita, kinukuha ayon sa pagkakasunod-sunod ng mga kagustuhan ng browser mula sa 40 wikang sinusuportahan ng RolChat; kung walang tumugma, English. Hindi ginagamit ang sariling setting ng wika ng site: para magsalita ang widget ng wika ng site mo, itakda ang lang. Mula kanan pakaliwa ang pagpapakita ng Arabic at Hebrew. Hindi isinasalin ng widget ang mga mensahe ng agent; puwedeng gamitin ng agent ang live na pagsasalin gamit ang AI sa halip.

Cookies at pahintulot

Hindi sinusubaybayan ng widget ang mga bisita bago ang pahintulot kung saan kailangan ang consent banner. Kung ginagamit mo ang Privacy module ng RolChat, iisang consent state ang pinagsasaluhan ng banner at ng widget. Kung ibang consent tool ang gamit mo, hinihintay ng mga analytics event ng widget ang signal na itinakda mo sa Mga Setting → Privacy → Embed.

Saan kino-configure ang widget

Ano	Saan
Mga kulay, posisyon, pagbati, mga entry point, install snippet	Mga Setting → Widget
Aling mga module ang lalabas sa loob ng widget	Mga Setting → Mga Module (kada site)
Oras ng trabaho at ang offline message	Mga Setting → Mga Site → Oras ng trabaho
Mga trigger message na ipinapakita sa partikular na mga pahina	Marketing → Mga Trigger