CareSoft Live Chat SDK – API Hỗ Trợ Tương Tác Widget

CareSoft cung cấp các hàm JavaScript để tương tác trực tiếp với widget Live Chat, cho phép bạn điều khiển các hành vi trong box chat theo yêu cầu lập trình.

Cách sử dụng

Sau khi đã nhúng thành công widget Live Chat vào website, bạn có thể tương tác với box chat thông qua hàm toàn cục:

cslw(action, params)

• action (string): Tên hành động muốn thực hiện.

• params (object): Tham số tùy chọn, chứa dữ liệu bổ sung phục vụ cho action.

⚠️ Lưu ý: Mọi action chỉ hoạt động sau khi box chat đã được khởi tạo thành công.

Danh sách các action hỗ trợ

Tên Action	Mô tả	Ví dụ sử dụng
open-widget	Mở widget chat lên (trạng thái hiển thị).	cslw('open-widget')
reload-widget	Tải lại (re-initialize) widget chat.	cslw('reload-widget')
change-chat-service	Thay đổi dịch vụ chat hiện tại theo service_id.	cslw('change-chat-service', { service_id: 123 })
compose-message	Gửi sẵn nội dung vào ô nhập tin nhắn trong box chat.	cslw('compose-message', { message: 'Xin chào, tôi cần hỗ trợ!' })

Ví dụ thực tế

<!-- Mở widget khi người dùng click nút -->
<button onclick="cslw('open-widget')">Chat với CSKH</button>

<!-- Chuyển sang dịch vụ hỗ trợ kỹ thuật -->
<button onclick="cslw('change-chat-service', { service_id: 456 })">Liên hệ bộ phận kỹ thuật</button>

---

📍 Ghi chú quan trọng

• Chỉ nên gọi cslw(...) sau khi widget đã được khởi tạo hoàn tất.