Pasang widget

Widget RolChat adalah satu tombol mengambang yang menyesuaikan diri dengan modul yang Anda aktifkan: chat, formulir permintaan telepon balik, pemesanan pertemuan, formulir prospek, dan pencarian basis pengetahuan semuanya ada di dalamnya. Pasang sekali; apa yang ditampilkannya diatur di dasbor.

1. Salin cuplikan kode

Di Pengaturan → Widget, pilih situs dan salin cuplikan pemasangan. Bentuknya seperti ini:

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

Kunci widget bersifat publik dan aman disertakan di halaman. Kunci ini menyebut situs Anda dan ditandatangani, sehingga tidak ada yang bisa mengarahkan salinan widget ke akun Anda. Dasbor menambahkan kunci lain ke objek tersebut (sapaan, judul header, tema, jam kerja, tata letak per ukuran layar) saat Anda mengubah pengaturan widget; salin ulang cuplikan setelah mengubahnya, atau biarkan objek tetap minimal dan biarkan widget mengambil sisanya.

stub.js hanya beberapa kilobyte dan memuat sisanya hanya saat pengunjung membutuhkannya: tampilan chat saat pertama dibuka, pelacakan setelah persetujuan, dan banner persetujuan jika diwajibkan.

2. Tempel sebelum </body>

Tambahkan cuplikan ke setiap halaman tempat Anda menginginkan widget, idealnya melalui template situs atau tag manager agar muncul di semua halaman sekaligus. Script dimuat secara asinkron dan tidak memblokir rendering; bundel pemuatan pertama sengaja dibuat kecil agar tidak memengaruhi Core Web Vitals Anda.

3. Periksa apakah berfungsi

Buka situs Anda di jendela privat. Tombol muncul di sudut yang Anda pilih. Di dasbor, Pengunjung menampilkan sesi anonim baru secara real time, dan pesan yang dikirim dari widget muncul di Kotak masuk sebagai percakapan baru.

Identifikasi pengguna yang login

Jika pengunjung Anda login ke produk Anda, beri tahu RolChat siapa mereka agar percakapan terhubung ke kontak yang tepat:

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

Atribut yang diterima adalah email, phone, first_name, last_name, external_id, dan objek datar custom_fields; selain itu diabaikan. RolChat mencari email di CRM. Jika kontak sudah ada, sesi ditautkan ke kontak itu dan agen melihat profilnya; jika belum, detailnya disimpan dan prospek dibuat saat pengunjung pertama kali menulis.

Untuk tingkat kepercayaan lebih tinggi, backend Anda dapat menandatangani identitas: kirim tanda tangan yang diterbitkan RolChat untuk pengguna bersama atributnya, dan sesi dinaikkan tingkatnya hanya jika tanda tangan terverifikasi. Panggil window.rolchat.reset() saat pengguna logout, jika tidak, orang berikutnya di browser tersebut akan melihat percakapan sebelumnya.

JavaScript API

window.rolchat tersedia begitu stub berjalan; panggilan yang dilakukan sebelum bundel dimuat akan diantrekan dan dijalankan secara berurutan.

Metode	Fungsinya
show() / hide()	Menampilkan atau menyembunyikan launcher
open() / close()	Membuka atau menutup panel chat
identify(traits)	Menautkan sesi ke seseorang (lihat di atas)
reset()	Melupakan identitas dan memulai sesi anonim baru
pushEvent(name, props)	Melaporkan event kustom untuk pesan pemicu dan otomatisasi
trackPageView(path?)	Melaporkan tampilan halaman di aplikasi satu halaman
setLocale(code)	Mengganti bahasa widget
showConsentPreferences()	Membuka pusat preferensi persetujuan
on(event, handler) / off(event, handler)	Berlangganan ke 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());

Bahasa dan arah teks

Widget menggunakan bahasa yang Anda tetapkan dengan lang di window.rolchatConfig (misalnya "lang": "de"); tanpa itu, bahasa browser pengunjung, diambil sesuai urutan preferensi browser dari 40 bahasa yang didukung RolChat; jika tidak ada yang cocok, bahasa Inggris. Pengaturan bahasa situs itu sendiri tidak dipakai: agar widget berbicara dalam bahasa situs Anda, atur lang. Bahasa Arab dan Ibrani ditampilkan dari kanan ke kiri. Pesan agen tidak diterjemahkan oleh widget; sisi agen dapat menggunakan terjemahan langsung AI sebagai gantinya.

Cookie dan persetujuan

Widget tidak melacak pengunjung sebelum ada persetujuan di tempat yang mewajibkan banner persetujuan. Jika Anda menggunakan modul Privasi RolChat, banner dan widget berbagi satu status persetujuan. Jika Anda menggunakan alat persetujuan lain, event analitik widget menunggu sinyal yang Anda konfigurasi di Pengaturan → Privasi → Sematkan.

Tempat widget dikonfigurasi

Apa	Di mana
Warna, posisi, sapaan, titik masuk, cuplikan pemasangan	Pengaturan → Widget
Modul mana yang muncul di dalam widget	Pengaturan → Modul (per situs)
Jam kerja dan pesan offline	Pengaturan → Situs → Jam kerja
Pesan pemicu yang ditampilkan di halaman tertentu	Pemasaran → Pemicu