> For the complete documentation index, see [llms.txt](https://docs.antbuddy.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.antbuddy.com/tai-lieu-antbuddy-huong-dan-su-dung-antbuddy-docs-user-guide/huong-dan-su-dung-quan-tri-khach-hang-antcrm-antcrm-customer-management/cai-dat-settings/cau-hinh-muc-tran-nhan-lead-lead-cap.md).

# Cấu hình mức trần nhận Lead (Lead cap)

Tính năng Lead cap giới hạn số Lead mỗi nhân viên kinh doanh (NVKD) được nhận tự động trong một tháng.

### 1. Giới thiệu <a href="#id-1-gioi-thieu" id="id-1-gioi-thieu"></a>

**Đối tượng sử dụng:** Admin hoặc người dùng có quyền cấu hình. Người phân công Lead thủ công sẽ gặp cảnh báo khi chọn NVKD đã đạt trần (mục 7).

**Khái niệm cần nắm:**

<table data-header-hidden><thead><tr><th width="246"></th><th></th></tr></thead><tbody><tr><td><strong>Khái niệm</strong></td><td><strong>Ý nghĩa</strong></td></tr><tr><td>Nhóm mức trần</td><td>Tập hợp NVKD dùng chung một mức trần. Mỗi NVKD thuộc tối đa một nhóm.</td></tr><tr><td>Cap (leads/month)</td><td>Số Lead tối đa mỗi thành viên trong nhóm được nhận tự động trong một tháng dương lịch. Là số nguyên lớn hơn 0.</td></tr><tr><td>Unique Lead</td><td>Lead được đếm theo Mã Lead; một Lead được phân nhiều lần cho cùng NVKD chỉ tính 1.</td></tr><tr><td>Unassigned</td><td>Dòng hệ thống gom các NVKD chưa thuộc nhóm nào. Mức trần luôn là Unlimited (không giới hạn), không sửa hoặc xoá được.</td></tr><tr><td>Leads received (X/Y)</td><td>X = số Unique Lead NVKD đã nhận trong tháng, Y = mức trần của nhóm.</td></tr><tr><td></td><td></td></tr></tbody></table>

**Lưu ý:** Bộ đếm Lead của mọi NVKD tự động reset về 0 vào đầu mỗi tháng dương lịch.

### 2. Truy cập và xem danh sách nhóm <a href="#id-2-truy-cap-va-xem-danh-sach-nhom" id="id-2-truy-cap-va-xem-danh-sach-nhom"></a>

Vào **Hồ sơ cá nhân → Thiết lập → Quản lý người dùng → Mức trần lead** để cấu hình danh sách nhóm mức trần.

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2FErxtUifNm0gbEwUpUv74%2Fimage.png?alt=media&amp;token=5393e5f3-63df-4d05-a71b-c7c5b975be7b" alt=""><figcaption></figcaption></figure>

Giao diện quản lý Mức trần lead

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2FdoJuWvosnZd3lesynaVM%2Fimage.png?alt=media&amp;token=c5c0acfc-a06d-43f1-81e7-fa1cbdbb5802" alt=""><figcaption></figcaption></figure>

Các thành phần trên màn hình:

<table data-header-hidden><thead><tr><th width="245"></th><th></th></tr></thead><tbody><tr><td><strong>Thành phần</strong></td><td><strong>Mô tả</strong></td></tr><tr><td>Tìm kiếm nhóm</td><td>Tìm nhóm theo tên.</td></tr><tr><td>Nhập từ file</td><td>Nhập nhóm và thành viên hàng loạt từ file Excel (mục 6).</td></tr><tr><td>Thêm nhóm</td><td>Tạo nhóm mức trần mới (mục 3).</td></tr><tr><td>STT / Nhóm</td><td>Số thứ tự và tên nhóm.</td></tr><tr><td>Nhân viên</td><td>Ảnh đại diện các thành viên; quá nhiều người sẽ hiện dạng "9+".</td></tr><tr><td>Mức trần(lead/tháng)</td><td>Mức trần Lead/tháng của nhóm.</td></tr><tr><td>Hành động</td><td>Biểu tượng bút chì để sửa nhóm (mục 4), thùng rác để xoá nhóm (mục 5).</td></tr></tbody></table>

Dòng **Chưa gán nhóm** luôn nằm trong danh sách, gồm các NVKD chưa thuộc nhóm nào với mức trần **Không giới hạn**. Dòng này không có nút sửa hoặc xoá.

### 3. Tạo nhóm mức trần mới <a href="#id-3-tao-nhom-muc-tran-moi" id="id-3-tao-nhom-muc-tran-moi"></a>

1. Tại màn Lead cap, bấm **Thêm nhóm**.<br>

   <figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2FJsklgHbTbF0Lpv1Ksaxh%2Fimage.png?alt=media&amp;token=e91879e4-dacf-48dd-b282-1f69bcb0aade" alt=""><figcaption></figcaption></figure>
2. Nhập **Tên nhóm** (bắt buộc, không trùng tên nhóm đã có).
3. Nhập **Mức trần** – số Lead tối đa mỗi thành viên nhận trong tháng. Giá trị phải là số nguyên lớn hơn 0.
4. Tại **Nhân viên trong nhóm**, gõ tên hoặc email NVKD để tìm và chọn thành viên. Có thể chọn nhiều người.
5. Bấm **Tạo** để lưu, hoặc **Hủy** để huỷ.

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2FfvcT7ANNypwXHPxRjLPo%2Fimage.png?alt=media&amp;token=91135aca-5068-4b97-a8dc-c2e7ede868f2" alt=""><figcaption></figcaption></figure>

**Lưu ý:**

* Nút **Tạo mới** chỉ kích hoạt khi đã nhập đủ thông tin trường bắt buộc.
* Nếu chọn NVKD đang thuộc nhóm mức trần khác, hệ thống cảnh báo và chuyển NVKD đó sang nhóm đang tạo.

Giao diện sau khi tạo 1 nhóm&#x20;

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2FQWi7cqvK57B5xeknUKZ5%2Fimage.png?alt=media&amp;token=4b981579-60dc-4016-b9c5-18e3f23685b7" alt=""><figcaption></figcaption></figure>

### 4. Chỉnh sửa nhóm và quản lý thành viên <a href="#id-4-chinh-sua-nhom-va-quan-ly-thanh-vien" id="id-4-chinh-sua-nhom-va-quan-ly-thanh-vien"></a>

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2F0uJ0wEeyR5i08dzn3R0c%2Fimage.png?alt=media&amp;token=47b06369-0bba-4123-8378-481ed22643ef" alt=""><figcaption></figcaption></figure>

1. Tại màn Mức trần lead, bấm biểu tượng **bút chì** ở cột Hành động của nhóm cần sửa.
2. Sửa **Tên nhóm** hoặc **Mức trần** nếu cần.
3. Thêm thành viên: gõ tên hoặc email vào ô **Nhân viên trong nhóm** và chọn NVKD.<br>

   <figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2FtJ1MGzriSM1avtCfsIW1%2Fimage.png?alt=media&amp;token=9b15bbe9-a60e-4a5d-91e6-55c4bc4645ea" alt=""><figcaption></figcaption></figure>
4. Xoá thành viên: bấm biểu tượng **thùng rác** trên dòng của NVKD trong bảng thành viên. NVKD bị xoá sẽ về nhóm Chưa gán nhóm (không giới hạn).

   <figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2FU5jfIscZ8P3mBR00tW4n%2Fimage.png?alt=media&amp;token=7e558f96-b9a0-4fac-95f2-e0a1c473d6a1" alt=""><figcaption></figcaption></figure>
5. Bấm **Lưu** để lưu thay đổi.

Cột **Lead đã nhận** hiển thị dạng X/Y cho từng thành viên, ví dụ **0/1** nghĩa là NVKD đã nhận **0 Lead** trong tháng trên **mức trần 1**. Dùng cột này để theo dõi nhân viên nào sắp chạm trần.

**Lưu ý:**

* Thay đổi mức trần có hiệu lực ngay cho mọi thành viên, kể cả trong tháng đang chạy. Ví dụ: NVKD đã nhận 80 Lead, hạ Cap từ 100 xuống 70 thì NVKD dừng nhận Lead tự động ngay.
* Group name rỗng hoặc trùng nhóm khác → hệ thống báo lỗi và không lưu.

Cột **Leads received** hiển thị dạng X/Y cho từng thành viên, ví dụ **0/123** nghĩa là NVKD đã nhận 0 Unique Lead trong tháng trên mức trần 123. Dùng cột này để theo dõi ai sắp chạm trần.

**Lưu ý:**

* Thay đổi mức trần có hiệu lực ngay cho mọi thành viên, kể cả trong tháng đang chạy. Ví dụ: NVKD đã nhận 80 Lead, hạ Cap từ 100 xuống 70 thì NVKD dừng nhận Lead tự động ngay.
* Group name rỗng hoặc trùng nhóm khác → hệ thống báo lỗi và không lưu.

### 5. Xoá nhóm <a href="#id-5-xoa-nhom" id="id-5-xoa-nhom"></a>

1. Tại màn Mức trần lead, bấm biểu tượng **thùng rác** ở cột Hành động của nhóm cần xoá.<br>

   <figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2FM66XJOBOSK5VDd2ttQaT%2Fimage.png?alt=media&amp;token=7cdafdb1-19a5-49c3-9fc4-74805271d3da" alt=""><figcaption></figcaption></figure>
2. Nếu nhóm còn thành viên, hệ thống hiện hộp thoại xác nhận. Bấm xác nhận để xoá.<br>

   <figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2FBnI7zJg7tgnrrXjS0wCr%2Fimage.png?alt=media&amp;token=54aa840c-3403-475a-a4ab-432314b34f60" alt=""><figcaption></figcaption></figure>

Sau khi xoá, toàn bộ thành viên của nhóm chuyển về **Chưa gán nhóm** và nhận Lead không giới hạn. Nếu vẫn muốn giới hạn, hãy gán họ vào nhóm khác trước khi xoá.

### 6. Import nhóm và thành viên từ file Excel <a href="#id-6-import-nhom-va-thanh-vien-tu-file-excel" id="id-6-import-nhom-va-thanh-vien-tu-file-excel"></a>

Dùng khi cần gán nhiều NVKD vào nhóm cùng lúc. Import chỉ tạo nhóm và gán thành viên; **mức trần không nhập qua file** mà thiết lập sau ở màn sửa nhóm (mục 4). Bấm **Import from file** trên màn Lead cap để mở trình 4 bước.

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2FMmJwqGagFyFFUvJPwOIU%2Fimage.png?alt=media&amp;token=21074b3d-4458-46cb-b1b9-de7f7d01342f" alt=""><figcaption></figcaption></figure>

#### Bước 1 – Tải file mẫu (có thể bỏ qua bước này và nhấn tiếp tục) <a href="#buoc-1-download-template" id="buoc-1-download-template"></a>

Bấm Tải file mẫu để tải file mẫu, điền dữ liệu vào file tải về theo mẫu rồi bấm **Tiếp tục**.

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2Fap5cmJqkLukE1W7TVbNq%2Fimage.png?alt=media&amp;token=04339955-c2ea-454a-8b90-ba4125e5eac7" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="235"></th><th></th></tr></thead><tbody><tr><td><strong>Email</strong></td><td><strong>Group name</strong></td></tr><tr><td>nva@congty.vn</td><td>Team HCM</td></tr><tr><td>ttb@congty.vn</td><td>Team HCM</td></tr><tr><td>lvc@congty.vn</td><td>Team HN</td></tr></tbody></table>

Cách điền từng cột:

* **Email:** email của NVKD đã có tài khoản trên CRM. Email không tồn tại trong tổ chức sẽ bị báo lỗi và bỏ qua ở Bước 4.
* **Group name:** tên nhóm mức trần đã tạo ở mục 3 (Tạo nhóm mức trần mới), ghi đúng như tên hiển đã tạo ở màn hình mức trần Lead.

#### Bước 2 – Upload data <a href="#buoc-2-upload-data" id="buoc-2-upload-data"></a>

1. Bấm vào vùng tải file (hoặc kéo thả) để chọn file Excel đã điền.
2. Tải file lên và Chọn sheet chứa dữ liệu.
3. Bấm **Tiếp tục**.

Mỗi lần tải tối đa **10.000 dòng**. File lớn hơn cần chia nhỏ.

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2FZKaujE8gwtW5QEnLLiUC%2Fimage.png?alt=media&amp;token=c384ed70-ff69-405a-bd5b-d3c5b5656c61" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2FXpBhibGASrx0lTdhnEEG%2Fimage.png?alt=media&amp;token=65ff8364-b4aa-4133-a142-fe83f80f9686" alt=""><figcaption></figcaption></figure>

#### Bước 3 – Mapping <a href="#buoc-3-mapping" id="buoc-3-mapping"></a>

Chọn cột trong file tương ứng với từng trường: **Email nhân viên** → cột Email, **Nhóm** → cột Tên nhóm. Cả hai trường là bắt buộc; chưa ánh xạ đủ thì không bấm Tiếp tục được.

#### Bước 4 – Xem lại <a href="#buoc-4-review" id="buoc-4-review"></a>

Kiểm tra dữ liệu trước khi nhập, rồi bấm **Upload**.

* **Thông tin:** tên file, sheet, dung lượng và tuỳ chọn **Cách tải lên khi có nhân viên đã gán nhóm** (mặc định **Chuyển sang nhóm mới** hoặc **Bỏ qua** – chuyển NVKD sang nhóm ghi trong file).
* **Cảnh báo dòng lỗi (nền cam):** số dòng sẽ bị bỏ qua và lý do, ví dụ email không thuộc tổ chức.
* **Danh sách nhân viên đã gán nhóm:** NVKD đang ở nhóm khác, kèm Old group và New group.
* **Danh sách nhân viên sẽ được gán nhóm sau khi tải lên:** NVKD sẽ được gán, kèm nhóm đích.

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2FShqv7U3FvJM9Dr5U5Lyz%2Fimage.png?alt=media&amp;token=29d4517e-d9a9-44b4-bc63-4aaf95ea88d2" alt=""><figcaption></figcaption></figure>

Sau khi Upload, hệ thống hiển thị kết quả: số nhóm, số NVKD được gán và danh sách dòng lỗi kèm lý do. Các dòng hợp lệ vẫn được nhập dù file có dòng lỗi.

Ở các bước 2–4, bấm **Quay lại** để quay lại bước trước (dữ liệu đã nhập được giữ), hoặc **Hủy** để thoát mà không nhập.

Sau khi Upload, hệ thống hiển thị kết quả: số nhóm, số NVKD được gán và danh sách dòng lỗi kèm lý do. Các dòng hợp lệ vẫn được nhập dù file có dòng lỗi.

Ở các bước 2–4, bấm **Back** để quay lại bước trước (dữ liệu đã nhập được giữ), hoặc **Cancel** để thoát mà không nhập.

### 7. Cách hệ thống áp dụng mức trần <a href="#id-7-cach-he-thong-ap-dung-muc-tran" id="id-7-cach-he-thong-ap-dung-muc-tran"></a>

Phân Lead tự động bị chặn cứng khi NVKD đạt trần; phân công thủ công chỉ cảnh báo và vẫn cho phép vượt trần.

| Tình huống                         | NVKD chưa đạt trần               | NVKD đã đạt hoặc vượt trần                 | NVKD thuộc nhóm chưa chỉ định |
| ---------------------------------- | -------------------------------- | ------------------------------------------ | ----------------------------- |
| Phân Lead tự động (AntBot routing) | Nhận Lead, bộ đếm +1             | Bị loại khỏi danh sách nhận đến hết tháng  | Nhận không giới hạn           |
| Phân công thủ công                 | Phân bình thường, không cảnh báo | Hiện popup cảnh báo, người dùng quyết định | Phân bình thường              |

#### Popup cảnh báo khi phân công thủ công <a href="#popup-canh-bao-khi-phan-cong-thu-cong" id="popup-canh-bao-khi-phan-cong-thu-cong"></a>

Khi chọn NVKD đã đạt trần, hệ thống hiện: *"Nhân viên đã đạt mức trần {xxx} lead/tháng. Tiếp tục phân công?"*

* Bấm **Xác nhận** → Lead được phân, bộ đếm của NVKD tăng và có thể vượt mức trần.
* Bấm **Hủy** → không phân công, đóng popup.
* Tick **Không hiển thị thông báo này nữa** → các lần sau hệ thống phân công thẳng, không hỏi lại.

Lead phân thủ công vẫn được tính vào bộ đếm, nên NVKD đó cũng sẽ không nhận thêm Lead tự động trong tháng.

### 8. Lỗi thường gặp và cách xử lý <a href="#id-8-loi-thuong-gap-va-cach-xu-ly" id="id-8-loi-thuong-gap-va-cach-xu-ly"></a>

| **Thông báo / hiện tượng**                        | **Nguyên nhân**                                     | **Cách xử lý**                                                      |
| ------------------------------------------------- | --------------------------------------------------- | ------------------------------------------------------------------- |
| Không lưu được nhóm, báo lỗi ở Cap                | Cap để trống, bằng 0 hoặc số âm                     | Nhập số nguyên lớn hơn 0.                                           |
| Không lưu được, báo lỗi ở Group name              | Tên nhóm trống hoặc trùng nhóm đã có                | Đặt tên khác.                                                       |
| Cảnh báo khi thêm thành viên                      | NVKD đang thuộc nhóm mức trần khác                  | Xác nhận nếu muốn chuyển NVKD sang nhóm hiện tại.                   |
| Bước 2 Import báo lỗi file                        | File sai định dạng, không đọc được hoặc sheet trống | Dùng file mẫu tải ở Bước 1, kiểm tra sheet đã chọn.                 |
| Bước 2 Import báo vượt giới hạn                   | File quá 10.000 dòng                                | Chia thành nhiều file nhỏ hơn.                                      |
| Không bấm được Next ở Bước 3                      | Chưa ánh xạ đủ User email và Group                  | Chọn cột cho cả hai trường.                                         |
| Dòng bị bỏ qua ở Bước 4                           | Group name trống hoặc email không thuộc tổ chức     | Sửa dòng trong file và import lại các dòng đó.                      |
| Nhóm trong file trùng tên nhóm có sẵn             | Không phải lỗi                                      | Thành viên được thêm vào nhóm có sẵn, giữ nguyên mức trần hiện tại. |
| NVKD không nhận Lead tự động dù còn Lead mới      | NVKD đã đạt trần tháng                              | Xem cột Leads received; tăng Cap hoặc phân thủ công nếu cần.        |
| Sau khi xoá nhóm, NVKD nhận Lead nhiều bất thường | Thành viên đã về Unassigned (không giới hạn)        | Gán lại NVKD vào nhóm có mức trần.                                  |