# Gói và giới hạn

OmnyBot áp dụng mô hình **"làm việc thì miễn phí, quản lý thì trả phí"** kết hợp **Ví AI Bot Token** theo mức dùng thực tế. Các công cụ vận hành cốt lõi (hộp thư đa kênh, Trợ lý AI & Bot) có sẵn từ gói **Miễn Phí**; các bề mặt quản trị đội ngũ mở dần theo từng gói.

Xem hướng dẫn thao tác tại [Gói dịch vụ & Dùng thử](/vi/workspace-management/billing/) và [Mức sử dụng & Hạn mức](/vi/workspace-management/usage/).

## Bảng gói dịch vụ & Giới hạn số lượng

| Gói | Mã gói | Giá niêm yết / tháng | Kênh kết nối (`maxNicks`) | Thành viên (`maxSeats`) |
| --- | --- | --- | :---: | :---: |
| **Miễn Phí** | `FREE` | 0₫ | 1 | 1 |
| **Khởi Động** | `STARTER` | 299.000₫ | 3 | 3 |
| **Tăng Trưởng** *(Phổ biến)* | `GROWTH` | 599.000₫ | 7 | 7 |
| **Mở Rộng** | `SCALE` | 799.000₫ | 20 | 20 |
| **Tùy Chỉnh** | `CUSTOM` | Liên hệ | Không giới hạn | Không giới hạn |

:::note[Hạn mức thực tế & Gói cũ]
Số liệu trên là cấu hình mặc định của hệ thống; giá và hạn mức hiện hành (kể cả mức điều chỉnh riêng cho Workspace) luôn hiển thị tại **Cài đặt → Thanh toán → Gói**. Số thành viên (`maxSeats`) bao gồm cả **Owner**. Gói `PRO` cũ đã ngừng bán mới nhưng vẫn được duy trì cho các Workspace đang sử dụng trước đó.
:::

## Tính năng mở khóa theo gói (`PlanCapabilities`)

| Tính năng | Miễn Phí | Khởi Động | Tăng Trưởng | Mở Rộng | Tùy Chỉnh |
| --- | :---: | :---: | :---: | :---: | :---: |
| Hộp thư đa kênh, thẻ, mẫu tin nhắn | ✓ | ✓ | ✓ | ✓ | ✓ |
| Trợ lý AI & Bot trả lời khách (`aiReply`) | ✓ | ✓ | ✓ | ✓ | ✓ |
| Trợ lý trong app Mina (hỏi đáp) | ✓ | ✓ | ✓ | ✓ | ✓ |
| Cộng tác nhóm & phân công (`teamCollaboration`) | — | ✓ | ✓ | ✓ | ✓ |
| Vai trò tùy chỉnh (`customRoles`) | — | — | ✓ | ✓ | ✓ |
| Xem Nhật ký hoạt động (`auditLog`) | — | — | ✓ | ✓ | ✓ |
| Đa vai trò cho 1 thành viên (`multiRolePerMember`) | — | — | — | ✓ | ✓ |

- **Nhật ký hoạt động (`auditLog`)**: Sự kiện vẫn được **ghi ở mọi gói**; từ gói **Tăng Trưởng** trở lên mở khóa màn hình **xem** toàn bộ lịch sử (bao gồm lịch sử đã ghi trước khi nâng cấp).

## Dùng thử 14 ngày (Trial)

Workspace đủ điều kiện có thể kích hoạt dùng thử **14 ngày** gói **Tăng Trưởng (`GROWTH`)** trực tiếp tại **Cài đặt → Thanh toán → Gói**:

- Hệ thống gửi email nhắc trước khi hết hạn **3 ngày** và **1 ngày**.
- Mỗi Workspace/tài khoản Zalo chỉ được nhận dùng thử một lần (nếu đã dùng trước đó, hệ thống trả lỗi `BILLING_TRIAL_ALREADY_CLAIMED` hoặc `BILLING_TRIAL_ZALO_ALREADY_USED`).
- Khi chuyển sang gói trả phí cùng hạng (`GROWTH`), thời gian dùng thử còn lại được cộng dồn; khi chọn gói khác hạng trong lúc đang dùng thử, thời gian dùng thử không quy đổi cộng dồn.

## Ví AI Bot Token & Các gói nạp thêm

Các lượt phản hồi của **AI Bot** tiêu thụ token từ **Ví AI** của Workspace:

- **Quà khởi đầu**: Mỗi Workspace mới được tặng **50.000 token** trải nghiệm miễn phí.
- **Cơ chế giữ chỗ & hoàn trả**: Trước mỗi lượt phản hồi, hệ thống tạm giữ **2.500 token**, sau đó quyết toán theo lượng token thực dùng và hoàn lại phần dư (hoặc hoàn toàn bộ nếu kết nối mô hình lỗi).
- **Cảnh báo số dư**: Hệ thống gửi thông báo khi số dư xuống dưới **15.000 token** (`WALLET_LOW_TOKENS`) và khi hết token (`WALLET_OUT_OF_TOKENS`).

| Gói nạp Token | Giá | Số lượng Token | Ước tính lượt phản hồi | Thời hạn |
| --- | --- | --- | --- | --- |
| **Khởi Đầu** *(Phổ biến)* | 49.000₫ | 10.000.000 | ~2.000 – 3.000 lượt | Không giới hạn |
| **Tăng Tốc** | 199.000₫ | 60.000.000 | ~15.000 – 20.000 lượt | Không giới hạn |
| **Bứt Phá** | 499.000₫ | 180.000.000 | ~50.000+ lượt | Không giới hạn |
| **Doanh Nghiệp** | 999.000₫ | 400.000.000 | ~120.000+ lượt | Không giới hạn |
| **Tùy Chỉnh** | Liên hệ | Từ 1 tỷ Token | Không giới hạn | Không giới hạn |

## Chu kỳ thanh toán & Giảm giá trả trước

Khi nâng cấp gói tại **Cài đặt → Thanh toán → Gói** (yêu cầu quyền `billing:manage`), bạn có thể chọn 4 chu kỳ thanh toán bằng chuyển khoản **VietQR** (tự động kích hoạt qua SePay hoặc admin xác nhận):

| Chu kỳ | Giảm giá trả trước |
| --- | :---: |
| **1 tháng** | 0% |
| **3 tháng** | -4% |
| **6 tháng** | -10% |
| **12 tháng** | -22% |

Bạn có thể áp dụng mã giảm giá (nếu có; giá trị thanh toán tối thiểu sau giảm giá là **2.000₫**).

## Khi chạm giới hạn

| Tình huống | Mã lỗi hệ thống | Hành vi hệ thống |
| --- | --- | --- |
| Đủ số kênh kết nối theo gói | `PLAN_LIMIT_EXCEEDED` | Chặn thêm kênh mới và hiển thị gợi ý nâng cấp. |
| Đủ số thành viên theo gói | `WORKSPACE_SEAT_LIMIT_EXCEEDED` | Chặn gửi lời mời thành viên mới. |
| Dùng tính năng thuộc gói cao hơn | `FEATURE_NOT_IN_PLAN` | Hiển thị màn hình khóa kèm nút nâng cấp gói. |
| Hết số dư Ví AI Token | `AI_WALLET_INSUFFICIENT_TOKENS` | AI Bot ngừng tự trả lời/tạo nháp cho đến khi nạp thêm token. |
| Gói hết hạn / vượt hạn mức kênh | — | Các kênh vượt hạn mức bị tạm khóa (`lockedNicks`) cho đến khi gia hạn hoặc nâng cấp. |