> 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/branded-bot

# Bot riêng mang tên server

Hướng dẫn từng bước có hình: tạo ứng dụng Discord, đặt tên và ảnh, bật quyền đặc biệt, dán token vào bảng điều khiển, mời bot. Clanzy chạy dưới tên bot của bạn.

Với gói **Bot riêng**, server của bạn có một con bot mang **tên, ảnh đại diện và trạng thái do bạn đặt**. Bot đó chạy mọi tính năng của Clanzy với đúng cài đặt bạn đang có: lời chào, câu hỏi làm quen, phòng voice tạm, Lá chắn, báo cáo tuần. Gói Bot riêng đã gồm mọi thứ của Pro. Xem [Bảng giá](https://clanzy.app/pricing).

Bạn cần: quyền **Quản lý máy chủ** trong server, gói Bot riêng đang chạy, và khoảng 10 phút.

## Bước 1: Tạo ứng dụng trên Discord

1. Mở Discord Developer Portal (discord.com/developers/applications) và đăng nhập bằng tài khoản Discord của bạn.
2. Bấm **New Application**.
3. Đặt tên, ví dụ tên server của bạn. Tick đồng ý điều khoản rồi bấm **Create**.

![Trang Applications của Discord Developer Portal: bấm New Application, nhập tên ứng dụng, tick đồng ý điều khoản rồi bấm Create](https://clanzy.app/docs/branded/01-new-application.svg)

## Bước 2: Đặt tên và ảnh đại diện cho bot

1. Mở thẻ **Bot** ở cột bên trái.
2. Tải ảnh đại diện lên (logo server là đẹp nhất) và đặt **Username** cho bot.
3. Nên tắt **Public Bot** để người khác không thêm được bot của bạn vào server của họ. Discord có thể yêu cầu đặt **Install Link** ở thẻ **Installation** thành **None** trước.
4. Bấm **Save Changes**.

![Thẻ Bot: đặt ảnh đại diện, tên bot, tắt Public Bot rồi lưu](https://clanzy.app/docs/branded/02-bot-profile.svg)

Tên và ảnh đổi lại sau được, ngay trên bảng điều khiển Clanzy.

## Bước 3: Bật quyền đặc biệt

Vẫn ở thẻ **Bot**, kéo xuống **Privileged Gateway Intents**:

| Công tắc | Cần không | Để làm gì |
| --- | --- | --- |
| **Server Members Intent** | Bắt buộc | Chào người mới, câu hỏi làm quen, báo cáo tuần |
| **Message Content Intent** | Bắt buộc | Lá chắn tìm link và câu lừa đảo |
| **Presence Intent** | Không bắt buộc | Chỉ khi tên phòng voice dùng `{game}` |

Bật hai công tắc bắt buộc rồi bấm **Save Changes**.

![Mục Privileged Gateway Intents: bật Server Members Intent và Message Content Intent, Presence Intent không bắt buộc, rồi bấm Save Changes](https://clanzy.app/docs/branded/03-intents.svg)

> [!NOTE]
> Bot dưới 100 server chỉ cần bật công tắc, không phải gửi đơn cho Discord. Bot riêng của bạn chỉ ở một server.

## Bước 4: Lấy token

1. Vẫn ở thẻ **Bot**, bấm **Reset Token** và xác nhận.
2. Bấm **Copy** để chép token. Discord chỉ hiện token một lần.

![Thẻ Bot: bấm Reset Token rồi Copy để chép token mới](https://clanzy.app/docs/branded/04-token.svg)

> [!WARNING]
> Token như mật khẩu của bot. Chỉ dán vào bảng điều khiển Clanzy, không gửi vào kênh chat hay cho ai khác. Lỡ lộ thì bấm **Reset Token** lần nữa và dán token mới.

## Bước 5: Dán token vào bảng điều khiển

1. Mở [mục Bot riêng](https://app.clanzy.app/?open=branded) trên bảng điều khiển và chọn server.
2. Dán token. Bảng điều khiển kiểm tra ngay khi bạn dán: token đúng định dạng chưa, là bot nào, bot đó có đang chạy cho server khác không, đã bật hai quyền đặc biệt chưa (Clanzy thử tự bật giúp, chưa được thì có nút mở đúng tab Bot của bot đó). Bấm lưu: token được lưu **đã mã hoá**. Sau đó không ai xem lại được token, kể cả bạn.
3. Đặt **tên bot**, **giới thiệu** (phần About me, tối đa 400 ký tự) và **trạng thái** (tối đa 128 ký tự). Clanzy cập nhật chúng cho bot của bạn.

![Bảng điều khiển Clanzy, mục Bot riêng: dán token, kiểm tra, đặt tên, giới thiệu, trạng thái, rồi mời bot vào server](https://clanzy.app/docs/branded/05-dashboard-vi.svg)

Thiếu quyền đặc biệt hoặc token sai, bảng điều khiển báo ngay. Xem [Bot riêng gặp sự cố](https://clanzy.app/docs/troubleshooting/branded-bot).

## Bước 6: Mời bot vào server

Bấm nút mời bot trên bảng điều khiển. Discord mở màn hình thêm bot với đủ quyền Clanzy cần, gồm cả quyền cho Lá chắn. Chọn server rồi bấm **Cấp quyền**.

Sau đó, kéo role của bot mới lên trên các role game, giới tính và Thành viên trong **Cài đặt máy chủ → Vai trò**, giống như đã làm với Clanzy. Xem [Xếp role cho Clanzy](https://clanzy.app/docs/getting-started/role-order).

## Bước 7: Kiểm tra bot đã nhận việc

Khi bot riêng vào server, nó **nhận toàn bộ việc** trong vài giây, với đúng cài đặt cũ:

- Bot riêng hiện trực tuyến trong danh sách thành viên.
- Gõ `/setup welcome-test`: thẻ chào được gửi bằng tên và ảnh của bot riêng.
- Vào kênh tạo phòng: phòng voice tạm và bảng điều khiển phòng do bot riêng gửi.
- Bảng điều khiển ghi bot riêng **đang hoạt động**.

![Sau khi bot riêng vào server: bot của bạn trực tuyến và gửi thẻ chào, Clanzy chính im lặng](https://clanzy.app/docs/branded/06-handoff-vi.svg)

Clanzy chính **im lặng** trong server đó: không chào trùng, không tạo phòng trùng. Ai gõ lệnh của Clanzy chính sẽ được nhắc dùng lệnh của bot riêng.

## Khi có chuyện

| Chuyện gì | Clanzy làm gì |
| --- | --- |
| Token bị đổi, bị xoá hoặc bot bị xoá | Clanzy chính tự phục vụ server lại ngay, và nhắn chủ server để dán token mới |
| Chuyển từ Bot riêng về Pro | Bot riêng chạy đến hết tháng đã trả, rồi tạm nghỉ |
| Gói Bot riêng kết thúc (đã huỷ hoặc thẻ không thanh toán được) | Bot riêng tạm nghỉ, Clanzy chính phục vụ lại, cài đặt giữ nguyên. Token được giữ 30 ngày rồi bị xoá |
| Mua lại gói Bot riêng trong 30 ngày đó | Bot riêng nhận việc lại như cũ, không cần dán lại token |
| Đổi token (lộ token, đổi bot) | Bấm **Đổi token** trên bảng điều khiển và dán token mới |
| Bạn gỡ Bot riêng trên bảng điều khiển | Token bị xoá, Clanzy chính phục vụ lại, cài đặt giữ nguyên |

Chi tiết từng lỗi: [Bot riêng gặp sự cố](https://clanzy.app/docs/troubleshooting/branded-bot). Thanh toán, huỷ gói và hoàn tiền: [Gói và thanh toán](https://clanzy.app/docs/pro).

## Câu hỏi thường gặp

### Có cần biết lập trình không?

Không. Bạn chỉ bấm vài nút trên trang dành cho nhà phát triển của Discord và dán một đoạn token vào bảng điều khiển Clanzy. Mất khoảng 10 phút.

### Message Content là quyền đặc biệt, có phải xin Discord duyệt không?

Không. Bot ở dưới 100 server chỉ cần bật công tắc. Bot riêng của bạn chỉ ở một server nên không cần xét duyệt.

### Có gỡ Clanzy chính ra được không?

Được, bảng điều khiển vẫn chạy bình thường. Nhưng nên giữ lại: nếu token bot riêng bị đổi hoặc hỏng, Clanzy chính tự vào thay ngay, còn khi đã gỡ thì server sẽ không có bot nào chạy cho tới khi bạn sửa.

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