# Chat nhóm Zalo

Team Inbox hỗ trợ hiển thị và tương tác trực tiếp với các hội thoại **Nhóm** và **Cộng đồng** trên kênh **Zalo**, giúp đội ngũ quản lý nhóm khách hàng song song với hội thoại 1-1.

:::note[Phạm vi nền tảng & Quyền truy cập]
- Tính năng chat nhóm hiện chỉ áp dụng cho kênh **Zalo** (Facebook, WhatsApp và Webchat chỉ hỗ trợ hội thoại 1-1).
- Yêu cầu quyền **`inbox:read:all`** để xem tin nhắn nhóm và **`inbox:reply`** để gửi tin nhắn hoặc thao tác trong nhóm.
:::

## Nhận diện nhóm và cộng đồng

Trong danh sách hội thoại của tài khoản Zalo:

- **Ảnh đại diện nhóm**: hiển thị ảnh đại diện của nhóm, hoặc tự động ghép tối đa **4 ảnh đại diện thành viên** nếu nhóm chưa đặt ảnh riêng.
- **Nhãn Cộng đồng**: các nhóm thuộc loại Cộng đồng Zalo (`isCommunity`) hiển thị huy hiệu **Cộng đồng** cả trong danh sách lẫn thanh tiêu đề hội thoại.
- **Số lượng thành viên**: thanh tiêu đề hiển thị tổng số thành viên hiện có (`N thành viên`).

## Nhắn tin và nhắc tên (`@mention`)

Trong luồng chat nhóm, mỗi tin nhắn đến đều hiển thị **tên và ảnh đại diện người gửi**, đồng thời thanh trạng thái gõ tin hiển thị rõ thành viên nào đang soạn.

Để nhắc tên thành viên trong nhóm:

1. Gõ ký tự **`@`** trong khung soạn thảo để mở danh sách thành viên.
2. Tiếp tục gõ tên để lọc nhanh (danh sách hiển thị kèm nhãn **Trưởng nhóm** / **Phó nhóm** nếu có).
3. Chọn thành viên cụ thể, hoặc chọn **`@Tất cả`** để nhắc toàn bộ thành viên trong nhóm.

Các tiện ích khác như trả lời trích dẫn, thả cảm xúc, thu hồi, chuyển tiếp, gửi ảnh/video/tài liệu, nhãn dán, danh thiếp, vị trí, mẫu tin nhanh, ghim tin nhắn (tối đa 3 tin), tìm kiếm trong hội thoại và khóa **Tiếp quản** giữa các nhân sự đều hoạt động tương tự [hội thoại 1-1](/vi/inbox/conversations/).

## Các trạng thái khóa khung soạn thảo

Khung nhập tin nhắn trong nhóm có thể tự động khóa trong 3 trường hợp sau:

| Trạng thái | Nguyên nhân | Cách xử lý |
| :--- | :--- | :--- |
| **Chờ duyệt tham gia** | Yêu cầu tham gia nhóm của tài khoản Zalo đang ở trạng thái chờ quản trị viên phê duyệt. | Chờ quản trị nhóm duyệt yêu cầu; khung chat sẽ tự mở khi trạng thái chuyển sang đã tham gia. |
| **Nhóm giới hạn người nhắn** | Nhóm bật chế độ chỉ Trưởng/Phó nhóm được phép nhắn tin và tài khoản Zalo hiện tại chỉ là thành viên thường. | Chỉ Trưởng/Phó nhóm mới có thể gửi tin nhắn trong nhóm này. |
| **Đồng đội đang xử lý** | Một thành viên khác trong Workspace đã nhấn **Tiếp quản** hội thoại nhóm này. | Chờ đồng đội nhấn **Nhả**, hoặc nhấn **Tiếp quản** nếu bạn cần trực tiếp nhận lại quyền nhắn tin. |

## Khác biệt so với hội thoại 1-1

- **Không kích hoạt AI tự động**: hệ thống tự động bỏ qua các luồng chat nhóm đối với tính năng tự động trả lời, thanh gợi ý AI (`Gợi ý từ AI`) và trợ lý Copilot.
- **Không hiển thị trạng thái "Đã xem"**: dấu tick **Đã xem** chỉ áp dụng cho hội thoại 1-1.

:::note[Quản trị nhóm nâng cao]
Hệ thống nền đã có sẵn các API quản trị nhóm Zalo (tạo nhóm, tham gia qua link mời, đổi tên/ảnh nhóm, thêm hoặc xóa thành viên, quản lý phó nhóm, quản lý link mời, quét thành viên ẩn, rời nhóm), nhưng bảng thông tin và thao tác quản trị nhóm bên cột phải hiện chưa được mở trên giao diện Team Inbox.
:::