Cài đặt widget

Widget RolChat là một nút nổi thích ứng với các module bạn đã bật: chat, biểu mẫu yêu cầu gọi lại, đặt lịch hẹn, biểu mẫu khách hàng tiềm năng và tìm kiếm cơ sở tri thức đều nằm bên trong nó. Bạn chỉ cài một lần; nội dung hiển thị được quyết định trong bảng điều khiển.

1. Sao chép đoạn mã

Trong Cài đặt → Widget, chọn site và sao chép đoạn mã cài đặt. Nó trông như sau:

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

Khóa widget là công khai và an toàn khi đặt trong trang. Nó xác định site của bạn và được ký, nên không ai có thể trỏ một bản sao của widget vào tài khoản của bạn. Bảng điều khiển sẽ thêm các khóa khác vào đối tượng (lời chào, tiêu đề, giao diện, giờ làm việc, bố cục theo kích thước màn hình) khi bạn thay đổi cài đặt widget; hãy sao chép lại đoạn mã sau khi thay đổi, hoặc giữ đối tượng ở mức tối thiểu và để widget tự tải phần còn lại.

stub.js chỉ vài kilobyte và chỉ tải phần còn lại khi khách truy cập cần: giao diện chat khi mở lần đầu, theo dõi sau khi có sự đồng ý, banner đồng ý ở nơi bắt buộc.

2. Dán trước </body>

Thêm đoạn mã vào mọi trang bạn muốn hiển thị widget, tốt nhất là qua template của trang hoặc trình quản lý thẻ để nó xuất hiện ở mọi nơi cùng lúc. Script tải bất đồng bộ và không chặn việc hiển thị; gói tải đầu tiên được giữ nhỏ có chủ đích để không ảnh hưởng đến Core Web Vitals của bạn.

3. Kiểm tra hoạt động

Mở trang web của bạn trong cửa sổ ẩn danh. Nút xuất hiện ở góc bạn đã chọn. Trong bảng điều khiển, mục Khách truy cập hiển thị phiên ẩn danh mới theo thời gian thực, và tin nhắn gửi từ widget xuất hiện trong Hộp thư như một cuộc trò chuyện mới.

Nhận diện người dùng đã đăng nhập

Nếu khách truy cập đăng nhập vào sản phẩm của bạn, hãy cho RolChat biết họ là ai để các cuộc trò chuyện gắn với đúng liên hệ:

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

Các thuộc tính được chấp nhận là email, phone, first_name, last_name, external_id và một đối tượng phẳng custom_fields; mọi thứ khác bị bỏ qua. RolChat tra cứu email trong CRM. Nếu liên hệ đã tồn tại, phiên được liên kết với liên hệ đó và nhân viên thấy hồ sơ; nếu chưa, thông tin được giữ lại và một khách hàng tiềm năng được tạo khi khách truy cập viết tin đầu tiên.

Để tăng độ tin cậy, backend của bạn có thể ký danh tính: truyền chữ ký mà RolChat cấp cho người dùng cùng với các thuộc tính, và phiên chỉ được nâng cấp khi chữ ký được xác minh. Gọi window.rolchat.reset() khi người dùng đăng xuất, nếu không người tiếp theo trên trình duyệt đó sẽ thấy cuộc trò chuyện trước.

JavaScript API

window.rolchat có sẵn ngay khi stub chạy; các lệnh gọi trước khi gói được tải sẽ được xếp hàng và thực thi theo thứ tự.

Phương thức	Chức năng
show() / hide()	Hiện hoặc ẩn nút khởi chạy
open() / close()	Mở hoặc đóng bảng chat
identify(traits)	Liên kết phiên với một người (ở trên)
reset()	Xóa danh tính và bắt đầu một phiên ẩn danh mới
pushEvent(name, props)	Gửi sự kiện tùy chỉnh cho tin nhắn kích hoạt và tự động hóa
trackPageView(path?)	Ghi nhận lượt xem trang trong ứng dụng một trang
setLocale(code)	Đổi ngôn ngữ widget
showConsentPreferences()	Mở trung tâm tùy chọn đồng ý
on(event, handler) / off(event, handler)	Đăng ký 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());

Ngôn ngữ và hướng văn bản

Widget dùng ngôn ngữ bạn cố định bằng lang trong window.rolchatConfig (ví dụ "lang": "de"); nếu không có, dùng ngôn ngữ trình duyệt của khách truy cập, theo thứ tự ưu tiên của trình duyệt, trong 40 ngôn ngữ RolChat hỗ trợ; nếu không khớp ngôn ngữ nào thì dùng tiếng Anh. Cài đặt ngôn ngữ riêng của site không được dùng: để widget nói ngôn ngữ của site, hãy đặt lang. Tiếng Ả Rập và tiếng Do Thái hiển thị từ phải sang trái. Tin nhắn của nhân viên không được widget dịch; thay vào đó phía nhân viên có thể dùng tính năng dịch trực tiếp bằng AI.

Cookie và sự đồng ý

Widget không theo dõi khách truy cập trước khi có sự đồng ý ở những nơi bắt buộc có banner đồng ý. Nếu bạn dùng module Quyền riêng tư của RolChat, banner và widget chia sẻ cùng một trạng thái đồng ý. Nếu bạn dùng công cụ quản lý đồng ý khác, các sự kiện phân tích của widget sẽ chờ tín hiệu bạn cấu hình trong Cài đặt → Quyền riêng tư → Nhúng.

Widget được cấu hình ở đâu

Nội dung	Vị trí
Màu sắc, vị trí, lời chào, điểm truy cập, đoạn mã cài đặt	Cài đặt → Widget
Module nào xuất hiện bên trong widget	Cài đặt → Module (theo site)
Giờ làm việc và tin nhắn ngoài giờ	Cài đặt → Site → Giờ làm việc
Tin nhắn kích hoạt hiển thị trên các trang cụ thể	Marketing → Trình kích hoạt