> 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/welcome

# Chào thành viên mới

Clanzy gửi thẻ chào mừng cho mỗi thành viên mới vào kênh bạn chọn, kèm nút Bắt đầu để chọn game và nhận role. Cài bằng /setup welcome.

Clanzy gửi một thẻ chào mừng vào kênh bạn chọn mỗi khi có thành viên mới vào server, nhắc tên họ và kèm nút **Bắt đầu** để họ chọn game và nhận role ngay.

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

- Clanzy đã có trong server ([thêm bot](https://clanzy.app/docs/getting-started/invite)).
- Bạn là chủ server hoặc có quyền **Quản lý máy chủ**. Thiếu quyền này thì lệnh `/setup` không hiện trong menu `/`.
- Ở kênh chào mừng, Clanzy cần **Xem kênh**, **Gửi tin nhắn** và **Nhúng liên kết**. Xem thêm [quyền của Clanzy](https://clanzy.app/docs/getting-started/permissions).

## Cài nhanh

### Bằng lệnh

Gõ `/setup welcome` trong server. Clanzy sẽ:

1. Dùng kênh chào mừng đã chọn trước đó, hoặc tìm kênh tên `chào-mừng`, chưa có thì tạo mới ở đầu danh sách kênh.
2. Khoá chat cho @everyone ở kênh mới tạo, chỉ bot được gửi.
3. Bật lời chào.

Sau đó gõ `/setup welcome-test` để xem thẻ chào thật, gửi cho chính bạn. Muốn dựng luôn cả câu hỏi làm quen 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 Chào mừng](https://app.clanzy.app/?open=welcome), chọn **Kênh chào mừng**, bật **Gửi lời chào** rồi bấm **Lưu thay đổi**. Ở đây bạn viết lời chào riêng, xem trước thẻ và bấm **Gửi thử lời chào**.

## Cách hoạt động

- Thành viên vào server → Clanzy gửi thẻ vào kênh chào mừng: nhắc tên người đó (để họ có thông báo), tiêu đề **Chào mừng thành viên mới**, ảnh đại diện, chân thẻ ghi tên server và số thành viên.
- Mỗi người chỉ được chào **một lần duy nhất**. Rời server rồi vào lại thì không có thẻ mới.
- Server bật sàng lọc thành viên (membership screening) của Discord: Clanzy chờ người đó đồng ý luật rồi mới chào.
- Bot không được chào. Thẻ dùng ngôn ngữ của bot (xem [ngôn ngữ](https://clanzy.app/docs/language)).
- Nút **Bắt đầu** mở [câu hỏi làm quen](https://clanzy.app/docs/onboarding). Nút chỉ hiện khi phần làm quen đang bật.

Lời chào mặc định:

> Chào mừng {user} đến với **{server}**! Bạn là thành viên thứ **{memberCount}**.
> Bấm **Bắt đầu** để chọn game bạn chơi và nhận role nhé.

### Biến trong lời chào

| Biến | Hiện ra |
| --- | --- |
| `{user}` | Nhắc tên thành viên (@tên) |
| `{username}` | Tên thành viên, không nhắc |
| `{server}` | Tên server |
| `{memberCount}` | Số thành viên hiện tại |

Lời chào hỗ trợ **in đậm** và xuống dòng, tối đa 1500 ký tự. Gõ sai tên biến thì bảng điều khiển báo lỗi khi lưu.

## Cài đặt

| Cài đặt | Mặc định | Tuỳ chọn | Chỉnh ở đâu |
| --- | --- | --- | --- |
| Gửi lời chào | Bật (nhưng chưa có kênh thì chưa gửi) | Bật / Tắt | [Bảng điều khiển](https://app.clanzy.app/?open=welcome), `/setup welcome` |
| Kênh chào mừng | Chưa chọn | Một kênh chat | [Bảng điều khiển](https://app.clanzy.app/?open=welcome), `/setup welcome` |
| Nội dung lời chào | Lời chào mặc định theo ngôn ngữ bot | Lời chào riêng, tối đa 1500 ký tự | [Bảng điều khiển](https://app.clanzy.app/?open=welcome) |
| Nút Bắt đầu | Hiện | Hiện / Ẩn | [Bảng điều khiển](https://app.clanzy.app/?open=welcome) |

## Lệnh

| Lệnh | Việc làm | Ai dùng được |
| --- | --- | --- |
| [`/setup welcome`](https://clanzy.app/docs/commands/setup-welcome) | Tìm hoặc tạo kênh chào mừng, bật lời chào | Quản lý máy chủ |
| [`/setup welcome-test`](https://clanzy.app/docs/commands/setup-welcome-test) | Gửi thẻ chào thử cho chính bạn | Quản lý máy chủ |
| [`/config view`](https://clanzy.app/docs/commands/config-view) | Xem cấu hình hiện tại | Quản lý máy chủ |

Thẻ thử có dòng **🧪 Tin nhắn thử của quản trị viên** ở chân thẻ và không tính là lần chào thật của bạn. Mỗi server gửi thử được một lần mỗi 10 giây (dùng chung với nút trên bảng điều khiển).

> [!NOTE]
> Lời chào miễn phí và không giới hạn số thành viên. Xem [giới hạn](https://clanzy.app/docs/limits) và [bảng giá](https://clanzy.app/pricing).

## Xử lý sự cố

- **Thành viên mới vào mà không thấy thẻ chào**: kiểm tra đã chọn kênh và đang bật lời chào, rồi kiểm tra quyền của bot ở kênh đó. Xem [Không gửi lời chào](https://clanzy.app/docs/troubleshooting/welcome-not-sent).
- **`/setup welcome-test` báo "Chưa có kênh chào mừng"**: chạy `/setup welcome` hoặc chọn kênh trên bảng điều khiển trước.
- **Gửi thử báo "Lời chào đang tắt"**: thẻ thử vẫn gửi, nhưng thành viên mới chưa nhận. Bật **Gửi lời chào** trên bảng điều khiển.
- **Không thấy nút Bắt đầu trên thẻ**: phần làm quen đang tắt, hoặc bạn đã ẩn nút. Xem [Câu hỏi làm quen](https://clanzy.app/docs/onboarding).
- **Không thấy lệnh `/setup`**: bạn thiếu quyền **Quản lý máy chủ**. Xem [Lệnh không hiện](https://clanzy.app/docs/troubleshooting/slash-commands-not-showing).

## Xem thêm

- [Câu hỏi làm quen và role game](https://clanzy.app/docs/onboarding)
- [Thiết lập tất cả bằng /setup all](https://clanzy.app/docs/getting-started/setup-all)
- [Hướng dẫn tạo kênh chào mừng Discord](https://clanzy.app/huong-dan/tao-kenh-chao-mung-discord)

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