> 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/chat-da-kenh-conversation/cau-hinh-tu-dong-phan-cong-chat.md).

# Cấu hình tự động phân công chat

Tính năng Tự động phân công Chat theo Kỹ năng giúp hội thoại mới từ các kênh chat đã tích hợp được tự động phân công đúng nhân viên/nhóm theo cấu hình skill

Tính năng gồm hai phần, thực hiện theo đúng thứ tự:

* **Phần A — Cấu hình Bot (AntBot):** tạo danh mục Kỹ năng, xây dựng dữ liệu huấn luyện (câu mẫu → ý định → kỹ năng) và Huấn luyện để Bot hiểu tin nhắn của khách.
* **Phần B — Cấu hình Hội thoại đa kênh (AntCrm):** bật quy luật phân công, chọn Kỹ năng mặc định cho từng trang và Gán nhân viên vào từng kỹ năng.

## Cách hệ thống chia tin

1. Khách nhắn tin vào trang và chưa có phiên chat đang mở → hệ thống tạo phiên mới.
2. AntBot đọc tin nhắn, dự đoán ý định và suy ra kỹ năng tương ứng.
3. Hệ thống lấy danh sách nhân viên có kỹ năng đó (gán trực tiếp + qua nhóm).
4. Hội thoại được chia cho một nhân viên theo phương thức phân công đã chọn (Ít session nhất hoặc Tuần tự (Round Robin)).
5. Nếu Bot không xác định được kỹ năng, hội thoại được chuyển về kỹ năng mặc định của trang, trong khung chat hiển thị tin nhắn hệ thống nội bộ **“Không xác định được kỹ năng, chuyển về kỹ năng mặc định”** .

**Ví dụ:** Khách nhắn “Giá vàng hôm nay bao nhiêu?” → Bot nhận diện ý định hoi\_gia\_vang → kỹ năng Tư vấn bán vàng → hội thoại được chia cho một trong các nhân viên đã gán kỹ năng Tư vấn bán vàng.

## Điều kiện sử dụng

* Tài khoản admin có quyền quản trị AntBot&#x20;
* Tài khoản admin có quyền quản trị kênh trong Hội thoại đa kênh (Thiết lập → Chat đa kênh).
* Các trang/kênh chat đã được tích hợp và đang hoạt động.
* Đã có danh sách Nhân viên / Nhóm để gán vào kỹ năng.
* Bot phải được huấn luyện thành công ít nhất một lần thì mới phân loại được tin nhắn, trước đó mọi hội thoại đều đi về kỹ năng mặc định của trang.
* Nên cấu hình [Thiết lập giờ làm việc](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/chat-da-kenh-conversation/thiet-lap-gio-lam-viec.md) để hàng đợi P1/P2 vận hành đúng.

## Hướng dẫn sử dụng

**Thứ tự bắt buộc:** Thực hiện Phần A (AntBot) trước, sau đó mới sang Phần B (AntCrm). Kỹ năng chưa được tạo ở AntBot sẽ không xuất hiện ở AntCrm.

### **Phần A — Cấu hình Bot (AntBot)**

#### **Bước 1: Thêm kỹ năng**

Truy cập vào AntBot bằng cách đăng nhập vào AntCrm sau đó click vào ảnh đại diện → Sản phẩm → AntBot Chat&#x20;

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2FqxzilswgIeMpacXtkJ7R%2Fimage.png?alt=media&amp;token=7fda10b1-c509-46e1-8987-fba6ff8ae26e" alt=""><figcaption></figcaption></figure>

Giao diện chuyển hướng sang trang AntBot

Truy cập module HUẤN LUYỆN BOT để tạo các kỹ năng tương ứng với các nhóm chuyên môn của nhân viên (ví dụ: Tư vấn bán vàng, Tư vấn bán thuốc).

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2F8s2bWX9ABZRh6BIr9TX1%2Fimage.png?alt=media&amp;token=a1cddad7-6bb4-49a5-a091-e7b719d6b0b7" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="276"></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</td><td>Tìm kỹ năng theo tên.</td></tr><tr><td>Sửa đổi</td><td>Chỉnh sửa kỹ năng trong danh sách.</td></tr><tr><td>Thêm kỹ năng</td><td>Mở form tạo kỹ năng mới.</td></tr><tr><td>STT / Tên kỹ năng</td><td>Số thứ tự và tên kỹ năng.</td></tr><tr><td>Số agent được gán kỹ năng</td><td>Số nhân viên đang được gán kỹ năng <strong>(cấu hình ở CRM, Bước 6)</strong>.</td></tr><tr><td>Trạng thái</td><td>Đang hoạt động hoặc Vô hiệu hóa.</td></tr></tbody></table>

**Thao tác:**

1. Vào HUẤN LUYỆN BOT → Kỹ năng → Quản lý kỹ năng.
2. Nhấn Thêm kỹ năng ở góc trên bên phải.

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2F7LThy5Al3VHPELsU33AI%2Fimage.png?alt=media&amp;token=ad573a82-f9b0-4332-98e3-bbd0ef2513fe" alt=""><figcaption></figcaption></figure>

3. Nhập Tên kỹ năng

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2F8g6AStUbkx3N34vTieZk%2Fimage.png?alt=media&amp;token=6c813943-7a6a-4963-b288-41dbada991ab" alt=""><figcaption></figcaption></figure>

4. Nhấn xác nhận để lưu.

**Kết quả:** Kỹ năng mới sẽ xuất hiện trong danh sách với trạng thái Đang hoạt động kèm thông báo **"Thêm kỹ năng thành công"**

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2Fwxcpba6uz0uoLDKnvGGY%2Fimage.png?alt=media&amp;token=1c0a294f-a04f-4ad4-b0d4-657d06a4940e" alt=""><figcaption></figcaption></figure>

#### **Bước 2:** Huấn luyện kỹ năng

Xây dựng dữ liệu để Bot biết tin nhắn khi khách hàng nhắn mới vào page thuộc ý định nào, ý định đó thuộc kỹ năng nào, sau đó huấn luyện để đưa vào sử dụng.

**Thao tác thêm thủ công từng ý định – Thêm ý định**

1. Vào HUẤN LUYỆN BOT → Kỹ năng → Huấn luyện kỹ năng → Nhấn Thêm ý định.

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2FTTgGUb9J0o4OVJbfueZx%2Fimage.png?alt=media&amp;token=350cb28e-a556-4f7d-b039-08fdd506bb8f" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="169"></th><th></th></tr></thead><tbody><tr><td><strong>Thành phần</strong></td><td><strong>Mô tả</strong></td></tr><tr><td>Sửa đổi</td><td>Sửa câu mẫu, đổi ý định, xóa dòng dữ liệu.</td></tr><tr><td>Tải lên</td><td>Nhập dữ liệu hàng loạt từ file .xlsx/.csv theo file mẫu.</td></tr><tr><td>Thêm ý định</td><td>Thêm câu mẫu mới, chọn/tạo ý định và chọn kỹ năng.</td></tr><tr><td>Huấn luyện</td><td>Huấn luyện mô hình. Trạng thái: Huấn luyện / Đang huấn luyện / Đã huấn luyện.</td></tr><tr><td>Dữ liệu mẫu</td><td>Câu ví dụ thực tế của khách hàng.</td></tr><tr><td>Ý định</td><td>Nhãn mục đích của câu (ví dụ: mua_vang, hoi_gia_vang).</td></tr><tr><td>Kỹ năng</td><td>Kỹ năng mà ý định thuộc về.</td></tr></tbody></table>

2. Nhập câu mẫu tin nhắn khách thường hỏi (ví dụ: “Mình muốn mua vàng”) → Chọn ý định có sẵn hoặc tạo ý định mới (ví dụ: mua\_vang) → Chọn Kỹ năng đã tạo ở bước 1 mà ý định thuộc về (ví dụ kỹ năng: Tư vấn bán vàng).

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2FjAKS4wEOzzM8xO3M61yD%2Fimage.png?alt=media&amp;token=aae321df-5825-4554-9dcc-d3880f36963b" alt=""><figcaption></figcaption></figure>

3. Nhấn icon "+" thêm các ý định khác

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2FUblTo6XTLHdWaemFgOVE%2Fimage.png?alt=media&amp;token=006c4255-4095-4d75-8bb3-c59540023daa" alt=""><figcaption></figcaption></figure>

4. Nhấn Thêm để lưu tất cả các ý định đã thêm.

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2FbMWpYuuViUaW5GFyWIuq%2Fimage.png?alt=media&amp;token=051aadae-21fa-47f9-a6ef-ef4b26daa4f2" alt=""><figcaption></figcaption></figure>

**Hoặc có thể Thao tác thêm dữ liệu hàng loạt – Tải lên**

1. Nhấn Tải lên, tải file mẫu (cột Câu mẫu – Ý định – Kỹ năng).
2. Chọn sheet → Nhấn Tiếp tục

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2FnugRlBGQfI7ps6Hq8Rir%2Fimage.png?alt=media&amp;token=3c89f334-b075-4e4d-810b-0f3109b86c2c" alt=""><figcaption></figcaption></figure>

3. Hệ thống tự động kiểm tra và ánh xạ với file tải lên (Có thể click vào từng trường để thay đổi ánh xạ) → Nhấn Tiếp tục

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2FkrHOTOfvKQbqu3YzOs2o%2Fimage.png?alt=media&amp;token=ecc7b451-e131-4254-b692-3a69dc4d14de" alt=""><figcaption></figcaption></figure>

4. Xem lại trước khi Tải file lên

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2FoRJKVbK9ydNQDDfnJYwO%2Fimage.png?alt=media&amp;token=ec9be3ee-0eef-4876-8179-9af4f2377e1a" alt=""><figcaption></figcaption></figure>

#### **Bước 3: Sau khi thêm/sửa/tải lên dữ liệu, nhấn Huấn luyện ở góc phải.**

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2FNdQQDOFY36eaxH8tY9O8%2Fimage.png?alt=media&amp;token=6ce3c4fc-5da0-4020-9c33-8a4800e605f7" alt=""><figcaption></figcaption></figure>

Nút chuyển sang trạng thái Đang huấn luyện và tạm khóa; bạn vẫn xem/thêm/sửa dữ liệu bình thường. Khi hoàn tất, hệ thống hiển thị “Huấn luyện thành công. Bot đã được huấn luyện thành công.” và nút chuyển thành Đã huấn luyện.

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2FqcwgoXxj31Lz8V8OCGw6%2Fimage.png?alt=media&amp;token=d8010625-3cbc-4f83-b5fb-45461ed285e3" alt=""><figcaption></figcaption></figure>

**Kết quả:** Mô hình mới được áp dụng để phân loại tin nhắn, kỹ năng được đẩy sang CRM để cấu hình phân công.

### Phần B – Cấu hình trên Hội thoại đa kênh (CRM)

Truy cập lại Tab AntCrm, click vào ảnh đại diện → Thiết lập → Chat đa kênh → Tự động phân công Chat → tab Quy luật phân công Chat.

#### Bước 4: Cấu hình tab Quy luật phân công Chat

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2FmTFFdKBwGmvidXSO4uNH%2Fimage.png?alt=media&amp;token=73a3f332-fec0-4bd3-9cea-06b8a99f48cd" alt=""><figcaption></figcaption></figure>

**Thao tác:**

1. Bật toggle Phân công tự động.
2. Bật toggle Phân loại Chat để Bot đọc và phân loại tin nhắn theo kỹ năng.
3. Nhập Khoảng đợi phân công đến nhân viên (giây, tối thiểu 1).
4. Nhập Số phiên chat tối đa mỗi lần phân công (số nguyên dương).
5. Chọn Phương thức phân công chat tự động: Ít session nhất hoặc Tuần tự (Round Robin).
6. Nhấn Lưu.

<table><thead><tr><th width="186">Thao tác / Trường</th><th width="327">Ý nghĩa</th><th>Ràng buộc / Lưu ý</th></tr></thead><tbody><tr><td><strong>Phân công tự động</strong></td><td>Công tắc tổng, bật để kích hoạt các quy luật phân công chat tự động cho toàn hệ thống.</td><td>Cần bật trước khi cấu hình các mục bên dưới.</td></tr><tr><td><strong>Phân loại Chat</strong></td><td>Tin nhắn đi vào sẽ được Bot đọc và phân loại theo kỹ năng, sau đó đưa đến nhân viên có kỹ năng phù hợp. Chat trong giờ vào hàng đợi <strong>P1</strong>, chat ngoài giờ vào <strong>P2</strong>.</td><td>Tin P1 được ưu tiên phân công cho nhân viên trước P2.</td></tr><tr><td><strong>Khoảng đợi phân công đến nhân viên</strong></td><td>Tất cả Chat trong hàng đợi sẽ được phân đến nhân viên mỗi <em>n</em> giây.</td><td>Tối thiểu là <strong>1</strong> giây. Giá trị nhỏ thì phân nhanh hơn, giá trị lớn thì phân thưa hơn.</td></tr><tr><td><strong>Số phiên chat tối đa mỗi lần phân công</strong></td><td>Giới hạn số lượng phiên Chat được phân mỗi lần, nhằm giảm tải cho hệ thống.</td><td>Phải là <strong>số nguyên dương</strong> (ví dụ trong ảnh: 10).</td></tr><tr><td><strong>Phương thức phân công chat tự động</strong></td><td>Quy định cách hệ thống chọn nhân viên nhận chat (xem bảng bên dưới).</td><td>Chỉ chọn được 1 phương thức.</td></tr></tbody></table>

**So sánh 2 phương thức phân công**

<table data-header-hidden><thead><tr><th width="164"></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Tiêu chí</strong></td><td><strong>Ít session nhất</strong></td><td><strong>Tuần tự (Round Robin)</strong></td></tr><tr><td>Cách hoạt động</td><td>Chat được phân cho nhân viên đang có ít phiên hội thoại nhất tại thời điểm phân công.</td><td>Chat được phân lần lượt cho từng nhân viên theo thứ tự cố định, xoay vòng liên tục.</td></tr><tr><td>Tiêu chí chọn nhân viên</td><td>Dựa trên <strong>tải hiện tại</strong> của nhân viên.</td><td>Dựa trên <strong>thứ tự</strong> xoay vòng, không xét tải.</td></tr><tr><td>Phù hợp khi</td><td>Muốn cân bằng khối lượng công việc thực tế giữa các nhân viên.</td><td>Muốn chia đều số lượt nhận chat một cách đơn giản, công bằng theo lượt.</td></tr></tbody></table>

**Kết quả:** Cấu hình được lưu và áp dụng cho các phiên chat mới; phiên đang mở không bị ảnh hưởng.\
**Lưu ý khi bật Phân loại Chat:** mỗi Trang bắt buộc phải có Kỹ năng mặc định. Nếu còn trang chưa chọn, hệ thống chặn lưu và dẫn sang sub-tab Kỹ năng mặc định (Bước 5).

#### Bước 5: Chọn kỹ năng mặc định áp dụng cho trang

**Thao tác**

1. Chọn tab Quản lý kỹ năng → sub-tab Kỹ năng mặc định.

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2F9HKqsWof77P5uPST1xzx%2Fimage.png?alt=media&amp;token=b0ade16d-8611-4a0f-95b6-347b31da8267" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="204"></th><th></th></tr></thead><tbody><tr><td><strong>Thành phần</strong></td><td><strong>Mô tả</strong></td></tr><tr><td>Kỹ năng mặc định</td><td>Sub-tab chọn kỹ năng mặc định cho từng trang.</td></tr><tr><td>Trang</td><td>Tên trang và kênh (Facebook, GOOGLE_MAPS, APP_STORE…).</td></tr><tr><td>Chọn kỹ năng mặc định</td><td>Dropdown chọn đúng một kỹ năng Đang hoạt động.</td></tr><tr><td>Gán kỹ năng</td><td>Sub-tab gán nhân viên vào kỹ năng.</td></tr><tr><td>Tìm kiếm</td><td>Tìm kỹ năng theo tên.</td></tr><tr><td>Thêm kỹ năng với AntBot</td><td>Chuyển sang AntBot để tạo kỹ năng.</td></tr><tr><td>Số lượng nhân viên</td><td>Số nhân viên của kỹ năng (đã loại trùng), hoặc “Chưa có nhân viên”.</td></tr><tr><td>Gán nhân viên</td><td>Mở cửa sổ chọn nhân viên theo tab Nhân viên / Nhóm.</td></tr></tbody></table>

2. Tại cột Trang, xác định trang đã tích hợp cần cấu hình&#x20;
3. Tại cột Chọn kỹ năng mặc định, chọn đúng một kỹ năng đã tạo ở bước trên từ dropdown cho từng trang.
4. Nhấn Lưu

**Kết quả:** Mỗi trang gắn với một kỹ năng mặc định, thay đổi được áp dụng cho phiên chat mới.

#### Bước 6: Gán nhân viên nhận tin cho từng kỹ năng

**Thao tác**

1. Chọn sub-tab Gán kỹ năng. Bảng hiển thị Kỹ năng, Số lượng nhân viên và Thao tác.

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2FPCTekp3npkykbceh0GSb%2Fimage.png?alt=media&amp;token=a0bb595a-e9ae-4e82-9e69-a8fd3493a0fc" alt=""><figcaption></figcaption></figure>

2. Dùng ô Tìm kiếm để tìm kỹ năng theo tên (nếu cần).
3. Nhấn Gán nhân viên tại dòng kỹ năng cần cấu hình.
4. Trong cửa sổ “Gán nhân viên vào kỹ năng”: tại tab Nhân viên, tick chọn từng nhân viên; hoặc chuyển sang tab Nhóm để chọn nhanh toàn bộ thành viên của nhóm.

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2FcaBSzn7cPIgSq7hK9r7a%2Fimage.png?alt=media&amp;token=cbf4abde-33d0-4586-bb66-b4d77f764126" alt=""><figcaption></figcaption></figure>

5. Kiểm tra bộ đếm “Đã chọn và nhấn Lưu.

**Kết quả:** Cột Số lượng nhân viên cập nhật (ví dụ: “11 nhân viên”); dòng chưa gán hiển thị “Chưa có nhân viên”. Thay đổi áp dụng cho phiên chat mới.

<figure><img src="https://2303854476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeTpJl0u63dzYBMNgXKfR%2Fuploads%2F29SSWuhuCWaOcr8ESNo6%2Fimage.png?alt=media&amp;token=a97c0bb4-246e-48fd-8924-162a1d243ab5" alt=""><figcaption></figcaption></figure>
