Vai trò và quyền
Xem dạng Markdown
Quyền truy cập trong OmnyBot được quản lý theo mô hình RBAC (`tài_nguyên:hành_động`) thông qua **vai trò**. Mỗi thành viên giữ một hoặc nhiều vai trò; quyền hiệu lực là **hợp (union)** của tất cả vai trò mà họ đang giữ.
Xem thêm hướng dẫn thao tác tại [Tổng quan & Vai trò tùy chỉnh](/workspace-management/roles/) và [Ma trận phân quyền](/workspace-management/permission-matrix/).
## Bốn vai trò hệ thống
Mỗi Workspace được khởi tạo sẵn 4 vai trò hệ thống (không thể sửa tên hoặc xóa):
| Vai trò | Mã hệ thống | Phạm vi chính |
| --- | --- | --- |
| **Chủ Workspace** | `OWNER` | Toàn quyền (13/13 quyền), bao gồm cài đặt chung, vai trò, thanh toán và xóa Workspace. |
| **Quản lý** | `MANAGER` | Toàn quyền vận hành (10/13 quyền): thành viên, kênh kết nối, hộp thư, AI & tri thức, CRM và nhật ký hoạt động. |
| **Nhân viên** | `AGENT` | Trực chat (3/13 quyền): xem kênh, xem hộp thư và trả lời tin nhắn. |
| **Người xem** | `VIEWER` | Chỉ đọc (2/13 quyền): xem danh sách kênh và đọc hội thoại trong hộp thư. |
:::note[Bảo vệ vai trò Chủ (Owner)]
Mỗi Workspace luôn phải có ít nhất **1 Owner**. Owner duy nhất không thể tự rời Workspace hoặc bị hạ vai trò (lỗi `WORKSPACE_LAST_OWNER` / `WORKSPACE_OWNER_CANNOT_LEAVE`). Thao tác **Xóa Workspace** chỉ hiển thị với Owner.
:::
## Danh mục quyền & Ma trận vai trò hệ thống
Hệ thống chia 13 quyền thành **5 nhóm** tại **Cài đặt → Quản trị → Vai trò**:
| Nhóm | Mã quyền | Mô tả | Owner | Manager | Agent | Viewer |
| --- | --- | --- | :---: | :---: | :---: | :---: |
| **Không gian làm việc** | `workspace:manage` | Đổi tên, logo, cài đặt chung và xóa Workspace (xóa chỉ dành cho Owner). | ✓ | — | — | — |
| **Không gian làm việc** | `member:manage` | Mời, gỡ thành viên và gán/đổi vai trò. | ✓ | ✓ | — | — |
| **Không gian làm việc** | `role:manage` | Tạo, sửa, xóa vai trò tùy chỉnh. | ✓ | — | — | — |
| **Không gian làm việc** | `billing:manage` | Xem gói dịch vụ, mức sử dụng, hóa đơn và nâng cấp gói. | ✓ | — | — | — |
| **Không gian làm việc** | `audit:read` | Xem nhật ký hoạt động (yêu cầu gói **Tăng Trưởng** trở lên). | ✓ | ✓ | — | — |
| **Kênh kết nối** | `nick:read:all` | Xem tất cả kênh kết nối trong Workspace. | ✓ | ✓ | ✓ | ✓ |
| **Kênh kết nối** | `nick:operate` | Kết nối lại, ngắt kết nối, đổi proxy trên kênh hiện có. | ✓ | ✓ | — | — |
| **Kênh kết nối** | `nick:connect` | Thêm kênh kết nối mới (Zalo, Facebook Fanpage, WhatsApp, Webchat). | ✓ | ✓ | — | — |
| **Kênh kết nối** | `nick:delete` | Xóa kênh kết nối khỏi Workspace (hoặc xử lý trong Thùng rác). | ✓ | ✓ | — | — |
| **Hộp thư** | `inbox:read:all` | Xem tất cả hội thoại trong Workspace. | ✓ | ✓ | ✓ | ✓ |
| **Hộp thư** | `inbox:reply` | Gửi tin nhắn, thả cảm xúc, thu hồi tin trong hộp thư. | ✓ | ✓ | ✓ | — |
| **AI & Tri thức** | `ai:manage` | Cấu hình AI Bot, kết nối MCP, quản lý Kho tri thức và lỗ hổng AI. | ✓ | ✓ | — | — |
| **CRM & Vận hành** | `crm:manage` | Mã quyền kế thừa/nội bộ cho các API vận hành CRM phía hệ thống. | ✓ | ✓ | — | — |
## Vai trò tùy chỉnh & Đa vai trò
- **Vai trò tùy chỉnh** (từ gói **Tăng Trưởng**): Người có quyền `role:manage` có thể tạo vai trò mới với tập quyền bất kỳ từ 13 quyền trên tại **Cài đặt → Quản trị → Vai trò**. Không thể xóa vai trò đang có thành viên sử dụng (`WORKSPACE_ROLE_IN_USE`).
- **Nhiều vai trò cho một thành viên** (từ gói **Mở Rộng**): Gán đồng thời nhiều vai trò cho một thành viên; quyền thực tế là phép gộp (union) của tất cả vai trò đó. Xem [Gói và giới hạn](/reference/plans-limits/).
## Đổi vai trò của thành viên
1. Vào **Cài đặt → Quản trị → Thành viên** (yêu cầu quyền `member:manage`).
2. Chọn thành viên cần thay đổi và cập nhật vai trò mới (bạn không thể tự sửa vai trò của chính mình — `WORKSPACE_CANNOT_MODIFY_SELF`).
3. Quyền mới có hiệu lực ngay lập tức, không cần đăng xuất.
:::tip[Không thấy tính năng cần dùng?]
Nếu một menu hoặc nút bấm bị ẩn, rất có thể tài khoản của bạn thiếu quyền hoặc Workspace chưa đủ gói. Xem [Không thấy hoặc không dùng được tính năng](/troubleshooting/permissions-plan/).
:::
Quyền truy cập trong OmnyBot được quản lý theo mô hình RBAC (tài_nguyên:hành_động) thông qua vai trò. Mỗi thành viên giữ một hoặc nhiều vai trò; quyền hiệu lực là hợp (union) của tất cả vai trò mà họ đang giữ.
Xem thêm hướng dẫn thao tác tại Tổng quan & Vai trò tùy chỉnh và Ma trận phân quyền.
Bốn vai trò hệ thống
Phần tiêu đề “Bốn vai trò hệ thống”Mỗi Workspace được khởi tạo sẵn 4 vai trò hệ thống (không thể sửa tên hoặc xóa):
| Vai trò | Mã hệ thống | Phạm vi chính |
|---|---|---|
| Chủ Workspace | OWNER | Toàn quyền (13/13 quyền), bao gồm cài đặt chung, vai trò, thanh toán và xóa Workspace. |
| Quản lý | MANAGER | Toàn quyền vận hành (10/13 quyền): thành viên, kênh kết nối, hộp thư, AI & tri thức, CRM và nhật ký hoạt động. |
| Nhân viên | AGENT | Trực chat (3/13 quyền): xem kênh, xem hộp thư và trả lời tin nhắn. |
| Người xem | VIEWER | Chỉ đọc (2/13 quyền): xem danh sách kênh và đọc hội thoại trong hộp thư. |
Danh mục quyền & Ma trận vai trò hệ thống
Phần tiêu đề “Danh mục quyền & Ma trận vai trò hệ thống”Hệ thống chia 13 quyền thành 5 nhóm tại Cài đặt → Quản trị → Vai trò:
| Nhóm | Mã quyền | Mô tả | Owner | Manager | Agent | Viewer |
|---|---|---|---|---|---|---|
| Không gian làm việc | workspace:manage | Đổi tên, logo, cài đặt chung và xóa Workspace (xóa chỉ dành cho Owner). | ✓ | — | — | — |
| Không gian làm việc | member:manage | Mời, gỡ thành viên và gán/đổi vai trò. | ✓ | ✓ | — | — |
| Không gian làm việc | role:manage | Tạo, sửa, xóa vai trò tùy chỉnh. | ✓ | — | — | — |
| Không gian làm việc | billing:manage | Xem gói dịch vụ, mức sử dụng, hóa đơn và nâng cấp gói. | ✓ | — | — | — |
| Không gian làm việc | audit:read | Xem nhật ký hoạt động (yêu cầu gói Tăng Trưởng trở lên). | ✓ | ✓ | — | — |
| Kênh kết nối | nick:read:all | Xem tất cả kênh kết nối trong Workspace. | ✓ | ✓ | ✓ | ✓ |
| Kênh kết nối | nick:operate | Kết nối lại, ngắt kết nối, đổi proxy trên kênh hiện có. | ✓ | ✓ | — | — |
| Kênh kết nối | nick:connect | Thêm kênh kết nối mới (Zalo, Facebook Fanpage, WhatsApp, Webchat). | ✓ | ✓ | — | — |
| Kênh kết nối | nick:delete | Xóa kênh kết nối khỏi Workspace (hoặc xử lý trong Thùng rác). | ✓ | ✓ | — | — |
| Hộp thư | inbox:read:all | Xem tất cả hội thoại trong Workspace. | ✓ | ✓ | ✓ | ✓ |
| Hộp thư | inbox:reply | Gửi tin nhắn, thả cảm xúc, thu hồi tin trong hộp thư. | ✓ | ✓ | ✓ | — |
| AI & Tri thức | ai:manage | Cấu hình AI Bot, kết nối MCP, quản lý Kho tri thức và lỗ hổng AI. | ✓ | ✓ | — | — |
| CRM & Vận hành | crm:manage | Mã quyền kế thừa/nội bộ cho các API vận hành CRM phía hệ thống. | ✓ | ✓ | — | — |
Vai trò tùy chỉnh & Đa vai trò
Phần tiêu đề “Vai trò tùy chỉnh & Đa vai trò”- Vai trò tùy chỉnh (từ gói Tăng Trưởng): Người có quyền
role:managecó thể tạo vai trò mới với tập quyền bất kỳ từ 13 quyền trên tại Cài đặt → Quản trị → Vai trò. Không thể xóa vai trò đang có thành viên sử dụng (WORKSPACE_ROLE_IN_USE). - Nhiều vai trò cho một thành viên (từ gói Mở Rộng): Gán đồng thời nhiều vai trò cho một thành viên; quyền thực tế là phép gộp (union) của tất cả vai trò đó. Xem Gói và giới hạn.
Đổi vai trò của thành viên
Phần tiêu đề “Đổi vai trò của thành viên”- Vào Cài đặt → Quản trị → Thành viên (yêu cầu quyền
member:manage). - Chọn thành viên cần thay đổi và cập nhật vai trò mới (bạn không thể tự sửa vai trò của chính mình —
WORKSPACE_CANNOT_MODIFY_SELF). - Quyền mới có hiệu lực ngay lập tức, không cần đăng xuất.