# Nhúng ticket form

Ticket form là biểu mẫu đăng ký thông tin thường dùng để khách hàng khai báo thông tin trên website. 

Caresoft cung cấp tiện ích này giúp thông tin phản hồi từ khách hàng tới nhân viên chăm sóc khách hàng nhanh nhất và được điền trực tiếp vào các trường thông tin trên phiếu ghi  

### Autofill dữ liệu qua Url Query string

**Mục đích:**\
Hệ thống Caresoft hỗ trợ nhúng form khai báo thông tin khách hàng trực tiếp trên website. Thông tin người dùng nhập sẽ được gửi về hệ thống chăm sóc khách hàng nhanh chóng và chính xác.

#### 1. Tính năng Autofill qua URL

Sau khi tạo form thành công, bạn có thể khởi tạo link nhúng chứa các thông tin cần autofill bằng cách:

1. Truy cập giao diện “Gen link”.
2. Tick chọn các trường muốn thêm vào URL.
3. Hệ thống sẽ tự động generate link kèm theo các query string tương ứng.

<figure><img src="/files/v9NTKmfoo0o4fKTcLWI5" alt=""><figcaption></figcaption></figure>

#### 2. Cấu trúc URL được sinh ra

**Base URL:**

```
https://caresoft.vn/vi2/ticketForm/{form_id}
```

**Query Parameters (tùy theo checkbox được chọn):**

| Trường dữ liệu   | Query string sinh ra       | Ghi chú                               |
| ---------------- | -------------------------- | ------------------------------------- |
| Họ tên           | `username={{USERNAME}}`    | `{{USERNAME}}` là biến cần truyền     |
| Số điện thoại    | `userphone={{USER_PHONE}}` | `{{USER_PHONE}}` là biến cần truyền   |
| Email *(nếu có)* | `email={{USER_EMAIL}}`     | (có thể mở rộng nếu checkbox có thêm) |

**Ví dụ URL sau khi chọn 2 trường "Họ tên" và "Số điện thoại":**

```
https://caresoft.vn/vi2/ticketForm/1?username={{USERNAME}}&userphone={{USER_PHONE}}
```

👉 Bạn cần lập trình phía frontend để thay thế các placeholder `{{USERNAME}}`, `{{USER_PHONE}}` bằng dữ liệu thực tế từ hệ thống hoặc người dùng.

#### Gợi ý triển khai

* Nên sử dụng `encodeURIComponent()` để tránh lỗi khi giá trị chứa dấu cách hoặc ký tự đặc biệt.
* Chỉ truyền những trường thực sự cần autofill để tránh dư thừa dữ liệu trên URL.
* Có thể gắn link này vào button hoặc QR code để khách hàng tự động điền form.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.caresoft.vn/danh-muc/nhung-live-chat-ticket-form/nhung-ticket-form.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.