Không thấy hoặc không dùng được tính năng
Xem dạng Markdown
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ử](/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](/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](/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](/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.
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
Phần tiêu đề “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ử. |
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. |
Không cấu hình được AI Bot hoặc Kho tri thức
Phần tiêu đề “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,MANAGERhoặc vai trò tùy chỉnh được cấpai:managemớ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ý:
- Nhờ Owner hoặc Manager thực hiện cấu hình, hoặc cấp quyền
ai:managecho vai trò của bạn. - Nếu đã cấu hình nhưng Bot không trả lời khách, xem AI không hoạt động.
Không tạo hoặc chỉnh sửa được vai trò tùy chỉnh
Phần tiêu đề “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ỉOWNERcó). - 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ỗiWORKSPACE_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ý:
- Đảm bảo Workspace từ gói Tăng Trưởng trở lên và bạn có quyền
role:manage. - Tạo một vai trò tùy chỉnh mới thay vì sửa 4 vai trò hệ thống.
- 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
Phần tiêu đề “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ý:
- 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ự.
- Ở 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)
Phần tiêu đề “Không xem được Nhật ký hoạt động (Audit Log)”Nguyên nhân:
- Cần quyền
audit:read(mặc địnhOWNERvàMANAGERcó). - 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ý:
- Đảm bảo tài khoản có quyền
audit:read. - 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
Phần tiêu đề “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ò
OWNERmới thấy và thực hiện xóa Workspace tại Cài đặt chung. - 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òOWNERcho 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
Phần tiêu đề “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.