> Chỉ mục toàn bộ tài liệu Clanzy (cho AI agent): https://clanzy.app/llms.txt · Trang HTML: https://clanzy.app/docs/onboarding

# Câu hỏi làm quen và role game

Thành viên mới chọn giới tính và game đang chơi, Clanzy tự gán role tương ứng. Đổi lại lúc nào cũng được bằng /roles. Cài bằng /setup onboarding.

Câu hỏi làm quen hỏi thành viên giới tính và những game họ chơi, rồi Clanzy tự gán role tương ứng, để mỗi game có nhóm riêng và người mới tìm được đồng đội ngay.

## Trước khi bắt đầu

- Clanzy có quyền **Quản lý vai trò** (có sẵn khi [thêm bot](https://clanzy.app/docs/getting-started/invite)).
- Role **Clanzy** phải nằm **trên** các role game, role giới tính và role thành viên. Đây là lỗi hay gặp nhất, xem [thứ tự role](https://clanzy.app/docs/getting-started/role-order).
- Bạn cần quyền **Quản lý máy chủ** để cài đặt.

## Cài nhanh

### Bằng lệnh

Gõ `/setup onboarding`. Clanzy sẽ:

1. Nếu server chưa có game nào, thêm sẵn: Valorant, Liên Minh Huyền Thoại, Teamfight Tactics, Delta Force, Naraka: Bladepoint, PUBG.
2. Gắn mỗi game với role cùng tên đang có, chưa có thì tạo role mới ngay dưới role của bot.
3. Làm tương tự với lựa chọn giới tính **Nam** và **Nữ**, và tạo role **Thành viên** cho người trả lời xong.
4. Bật câu hỏi làm quen và báo lại role nào còn nằm trên bot.

Chạy lại bao nhiêu lần cũng được: role đã gắn được giữ nguyên, không tạo trùng. Muốn dựng luôn kênh chào và phòng voice thì dùng [`/setup all`](https://clanzy.app/docs/getting-started/setup-all).

### Bằng bảng điều khiển

[Mở mục Làm quen](https://app.clanzy.app/?open=onboarding) để thêm game (gõ tên hoặc **Thêm nhanh** từ danh sách gợi ý), chọn emoji và role cho từng game, đổi thứ tự, tuỳ chỉnh lựa chọn giới tính và chọn **Role thành viên**. Game chưa có role thì để đó rồi chạy `/setup onboarding`, Clanzy tạo role cho chúng.

## Cách hoạt động

Thành viên mở câu hỏi bằng nút **Bắt đầu** trên [thẻ chào mừng](https://clanzy.app/docs/welcome) hoặc gõ `/roles`. Một khung **Giới thiệu nhanh** hiện ra với:

- **Giới tính**: chọn một trong **Nam**, **Nữ**, **Khác**, **Không muốn nói** (bắt buộc khi câu hỏi đang bật).
- **Bạn chơi game nào?**: chọn bao nhiêu game cũng được, hoặc không chọn.

Bấm gửi, Clanzy sẽ:

- Thêm role của các game đã chọn, gỡ role của game bỏ chọn.
- Gán role của lựa chọn giới tính, gỡ role giới tính khác. **Khác** và **Không muốn nói** mặc định không có role.
- Thêm role thành viên (không bao giờ gỡ).
- Bỏ qua role nằm trên bot và báo rõ trong tin trả lời.

Tin trả lời **Xong rồi!** chỉ người đó thấy, liệt kê role đã thêm, đã gỡ và dặn: "Muốn đổi lại thì gõ `/roles` bất cứ lúc nào." Khi mở lại, câu trả lời cũ đã được chọn sẵn. Clanzy chỉ đụng tới role nó quản lý, role khác của thành viên giữ nguyên.

## Cài đặt

| Cài đặt | Mặc định | Tuỳ chọn | Chỉnh ở đâu |
| --- | --- | --- | --- |
| Câu hỏi làm quen | Bật | Bật / Tắt | [Bảng điều khiển](https://app.clanzy.app/?open=onboarding) |
| Hỏi giới tính | Bật | Bật / Tắt | [Bảng điều khiển](https://app.clanzy.app/?open=onboarding) |
| Lựa chọn giới tính | Nam, Nữ, Khác, Không muốn nói | 2 đến 10 lựa chọn, mỗi lựa chọn một role hoặc không | [Bảng điều khiển](https://app.clanzy.app/?open=onboarding) |
| Game và role | Trống (`/setup onboarding` thêm 6 game) | Tối đa 25 game, mỗi game tên, emoji, role | [Bảng điều khiển](https://app.clanzy.app/?open=onboarding), `/setup onboarding` |
| Role thành viên | Chưa có (`/setup onboarding` tạo **Thành viên**) | Một role bất kỳ | [Bảng điều khiển](https://app.clanzy.app/?open=onboarding), `/setup onboarding` |

Tắt câu hỏi giới tính thì role giới tính của thành viên được giữ nguyên, Clanzy không gỡ.

## Lệnh

| Lệnh | Việc làm | Ai dùng được |
| --- | --- | --- |
| [`/roles`](https://clanzy.app/docs/commands/roles) | Mở lại câu hỏi làm quen để đổi role | Mọi người |
| [`/setup onboarding`](https://clanzy.app/docs/commands/setup-onboarding) | Thêm game mẫu, tạo role còn thiếu | Quản lý máy chủ |
| [`/setup welcome-test`](https://clanzy.app/docs/commands/setup-welcome-test) | Gửi thẻ chào thử để bấm **Bắt đầu** như người mới | Quản lý máy chủ |

> [!NOTE]
> Gói Miễn phí có tối đa 25 game, vì một menu chọn trên Discord chỉ chứa được 25 mục. Gói Pro chia thành hai menu để có 50 game và 25 lựa chọn giới tính. Xem [giới hạn](https://clanzy.app/docs/limits).

## Xử lý sự cố

- **"Không gán được: … Role của Clanzy cần nằm trên các role này"**: kéo role **Clanzy** lên trên trong **Cài đặt máy chủ → Vai trò**. Xem [Role nằm trên bot](https://clanzy.app/docs/troubleshooting/role-too-low).
- **Trả lời xong mà không có role**: game chưa gắn role, hoặc bot thiếu quyền **Quản lý vai trò**. Xem [Không nhận được role](https://clanzy.app/docs/troubleshooting/onboarding-roles-not-given).
- **"Máy chủ này chưa bật phần câu hỏi làm quen."**: bật **Câu hỏi làm quen** trên bảng điều khiển.
- **"Máy chủ chưa cài game hay câu hỏi nào."**: câu hỏi giới tính đang tắt và chưa có game. Chạy `/setup onboarding` hoặc thêm game trên bảng điều khiển.
- **Bot báo thiếu quyền**: xem [Thiếu quyền](https://clanzy.app/docs/troubleshooting/missing-permissions).

## Xem thêm

- [Chào thành viên mới](https://clanzy.app/docs/welcome)
- [Dọn role game hằng tháng](https://clanzy.app/docs/game-roles) (gói Pro): gỡ role game của người không còn chơi
- [Thứ tự role và vì sao quan trọng](https://clanzy.app/docs/getting-started/role-order)
- [Cách tạo role và gán role tự động](https://clanzy.app/huong-dan/cach-tao-role-va-gan-role-tu-dong-discord)

Cập nhật: 2026-11-19
