> For the complete documentation index, see [llms.txt](https://docs.caresoft.vn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.caresoft.vn/danh-muc/nhung-live-chat-ticket-form/nhung-live-chat-vao-website/caresoft-live-chat-sdk-api-ho-tro-tuong-tac-widget.md).

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

#### **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:

```javascript
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ế**

```html
<!-- 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**.