# Vai trò và quyền

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](/vi/workspace-management/roles/) và [Ma trận phân quyền](/vi/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](/vi/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](/vi/troubleshooting/permissions-plan/).
:::