# Không thấy hoặc không dùng được tính năng

Khi một menu bị ẩn hoặc thao tác bị chặn trong OmnyBot, nguyên nhân thường thuộc một trong ba nhóm: **thiếu quyền RBAC**, **tính năng thuộc gói cao hơn**, hoặc **chạm hạn mức gói**.

## Phân biệt nhanh nguyên nhân

| Dấu hiệu / Mã lỗi | Nguyên nhân | Cách xử lý |
| --- | --- | --- |
| Menu/nút bị ẩn chỉ với riêng bạn, hoặc lỗi `WORKSPACE_PERMISSION_DENIED` (403) | **Thiếu quyền RBAC** trong vai trò hiện tại. | Nhờ người có quyền `member:manage` đổi vai trò tại **Cài đặt → Quản trị → Thành viên** hoặc cấp thêm quyền vào vai trò tùy chỉnh. |
| Màn hình hiện khóa kèm nút nâng cấp cho **mọi thành viên**, hoặc lỗi `FEATURE_NOT_IN_PLAN` (403) | **Thiếu gói dịch vụ** — tính năng thuộc gói cao hơn. | Người có quyền `billing:manage` nâng cấp gói tại [Gói dịch vụ & Dùng thử](/vi/workspace-management/billing/). |
| Lỗi `PLAN_LIMIT_EXCEEDED` (403) hoặc `WORKSPACE_SEAT_LIMIT_EXCEEDED` (409) | **Chạm giới hạn số lượng** kênh (`maxNicks`) hoặc thành viên (`maxSeats`). | Gỡ bớt kênh/thành viên không dùng hoặc nâng cấp gói tại [Gói và giới hạn](/vi/reference/plans-limits/). |

## Không cấu hình được AI Bot hoặc Kho tri thức

**Nguyên nhân:**
- Bạn thiếu quyền **`ai:manage`** (chỉ `OWNER`, `MANAGER` hoặc vai trò tùy chỉnh được cấp `ai:manage` mới cấu hình được Bot AI, MCP và Kho tri thức).
- Lưu ý: Tính năng Trợ lý AI & Bot (`aiReply`) đã mở từ gói **Miễn Phí**, nên việc không mở được trang cấu hình AI là do **thiếu quyền**, không phải thiếu gói.

**Cách xử lý:**
1. Nhờ Owner hoặc Manager thực hiện cấu hình, hoặc cấp quyền **`ai:manage`** cho vai trò của bạn.
2. Nếu đã cấu hình nhưng Bot không trả lời khách, xem [AI không hoạt động](/vi/troubleshooting/ai-issues/).

## Không tạo hoặc chỉnh sửa được vai trò tùy chỉnh

**Nguyên nhân:**
- Vai trò tùy chỉnh chỉ mở từ gói **Tăng Trưởng (`GROWTH`)** trở lên (`FEATURE_NOT_IN_PLAN`).
- Cần quyền **`role:manage`** (mặc định chỉ `OWNER` có).
- Bạn đang cố sửa/xóa một trong 4 vai trò hệ thống (`OWNER`, `MANAGER`, `AGENT`, `VIEWER`) — hệ thống chặn bằng lỗi `WORKSPACE_ROLE_SYSTEM_IMMUTABLE`.
- Bạn đang cố xóa vai trò vẫn còn thành viên sử dụng (`WORKSPACE_ROLE_IN_USE`).

**Cách xử lý:**
1. Đảm bảo Workspace từ gói **Tăng Trưởng** trở lên và bạn có quyền `role:manage`.
2. Tạo một vai trò tùy chỉnh mới thay vì sửa 4 vai trò hệ thống.
3. Trước khi xóa vai trò tùy chỉnh, chuyển toàn bộ thành viên thuộc vai trò đó sang vai trò khác.

## Không gán được nhiều vai trò cho một thành viên

**Nguyên nhân:**
- Tính năng **đa vai trò (`multiRolePerMember`)** mở từ gói **Mở Rộng (`SCALE`)** trở lên.
- Cần quyền **`member:manage`**, và bạn không thể tự sửa vai trò của chính mình (`WORKSPACE_CANNOT_MODIFY_SELF`).

**Cách xử lý:**
1. Nâng cấp lên gói **Mở Rộng** trở lên nếu cần kết hợp nhiều vai trò cho cùng một nhân sự.
2. Ở gói thấp hơn, bạn có thể tạo một vai trò tùy chỉnh (từ gói **Tăng Trưởng**) gộp sẵn đúng các quyền cần thiết.

## Không xem được Nhật ký hoạt động (Audit Log)

**Nguyên nhân:**
- Cần quyền **`audit:read`** (mặc định `OWNER` và `MANAGER` có).
- Cần gói **Tăng Trưởng (`GROWTH`)** trở lên để mở khóa màn hình xem lịch sử (sự kiện vẫn được ghi ngầm ở mọi gói).

**Cách xử lý:**
1. Đảm bảo tài khoản có quyền `audit:read`.
2. Nếu thấy thông báo yêu cầu nâng cấp, nâng cấp lên gói **Tăng Trưởng** để xem toàn bộ lịch sử hoạt động (bao gồm dữ liệu trước đó).

## Không thể rời Workspace hoặc xóa Workspace

- **Không thấy khu vực Xóa Workspace:** Chỉ tài khoản giữ vai trò **`OWNER`** mới thấy và thực hiện xóa Workspace tại [Cài đặt chung](/vi/workspace-management/general-settings/).
- **Không thể rời Workspace hoặc hạ quyền Owner (`WORKSPACE_OWNER_CANNOT_LEAVE` / `WORKSPACE_LAST_OWNER`):** Mỗi Workspace bắt buộc phải có ít nhất **1 Owner**. Hãy gán vai trò `OWNER` cho một thành viên khác trước khi rời hoặc hạ vai trò của mình.

## Không kích hoạt được Dùng thử 14 ngày

- **`EMAIL_NOT_VERIFIED`:** Xác minh địa chỉ email tài khoản của bạn trước khi kích hoạt dùng thử.
- **`BILLING_TRIAL_ALREADY_CLAIMED`:** Workspace hoặc tài khoản này đã từng nhận dùng thử trước đó.
- **`BILLING_TRIAL_ZALO_ALREADY_USED`:** Tài khoản Zalo đang kết nối đã từng được dùng trong một đợt dùng thử khác.