# Plans & Limits

OmnyBot follows a **"free to work, pay to manage"** model paired with a pay-as-you-go **AI Bot Token Wallet**. Core operational tools (omnichannel inbox, AI Reply Assistant & Bots) are available starting on the **Free** plan, while team management and governance surfaces unlock at higher tiers.

See [Plans & Trials](/workspace-management/billing/) and [Usage & Quotas](/workspace-management/usage/) for billing workflows.

## Plans & Numeric Limits

| Plan | Tier Code | List Price / Month | Connected Channels (`maxNicks`) | Members (`maxSeats`) |
| --- | --- | --- | :---: | :---: |
| **Free** | `FREE` | 0₫ | 1 | 1 |
| **Starter** | `STARTER` | 299,000₫ | 3 | 3 |
| **Growth** *(Popular)* | `GROWTH` | 599,000₫ | 7 | 7 |
| **Scale** | `SCALE` | 799,000₫ | 20 | 20 |
| **Custom** | `CUSTOM` | Contact us | Unlimited | Unlimited |

:::note[Live limits & legacy tier]
Values above are the code-shipped defaults; current pricing and any custom workspace overrides are always displayed under **Settings → Billing → Plans**. Seat limits (`maxSeats`) include the workspace **Owner**. The legacy `PRO` tier is hidden from new purchases but remains supported for grandfathered workspaces.
:::

## Capabilities by Plan (`PlanCapabilities`)

| Capability | Free | Starter | Growth | Scale | Custom |
| --- | :---: | :---: | :---: | :---: | :---: |
| Omnichannel inbox, tags, message templates | ✓ | ✓ | ✓ | ✓ | ✓ |
| AI Reply Assistant & Bots (`aiReply`) | ✓ | ✓ | ✓ | ✓ | ✓ |
| Mina in-app assistant (Q&A) | ✓ | ✓ | ✓ | ✓ | ✓ |
| Team collaboration & assignment (`teamCollaboration`) | — | ✓ | ✓ | ✓ | ✓ |
| Custom roles (`customRoles`) | — | — | ✓ | ✓ | ✓ |
| View Audit Log (`auditLog`) | — | — | ✓ | ✓ | ✓ |
| Multi-role per member (`multiRolePerMember`) | — | — | — | ✓ | ✓ |

- **Audit Log (`auditLog`)**: Events are **recorded on every plan**; upgrading to **Growth** or higher unlocks the read view for all historical events, including those recorded prior to upgrading.

## 14-Day Free Trial

Eligible workspaces can activate a **14-day trial** of the **Growth (`GROWTH`)** plan directly from **Settings → Billing → Plans**:

- Renewal reminders are emailed **3 days** and **1 day** before expiration.
- Trials are limited to one per workspace/Zalo account (`BILLING_TRIAL_ALREADY_CLAIMED` or `BILLING_TRIAL_ZALO_ALREADY_USED`).
- Upgrading to a paid **Growth** plan during a trial carries over remaining trial days; switching to a different tier during a trial does not carry over trial time.

## AI Bot Token Wallet & Top-Up Packages

**AI Bot** replies consume tokens from the workspace **AI Wallet**:

- **Starter gift**: Every new workspace receives **50,000 free tokens** to get started.
- **Reserve & settle**: Each AI turn reserves **2,500 tokens** upfront, settles actual usage, and refunds the unused remainder (or refunds in full if the AI provider errors).
- **Balance alerts**: Notifications trigger below **15,000 tokens** (`WALLET_LOW_TOKENS`) and when depleted (`WALLET_OUT_OF_TOKENS`).

| Token Pack | Price | Tokens | Est. Replies | Expiration |
| --- | --- | --- | --- | --- |
| **Starter** *(Popular)* | 49,000₫ | 10,000,000 | ~2,000 – 3,000 | Never expires |
| **Boost** | 199,000₫ | 60,000,000 | ~15,000 – 20,000 | Never expires |
| **Breakthrough** | 499,000₫ | 180,000,000 | ~50,000+ | Never expires |
| **Enterprise** | 999,000₫ | 400,000,000 | ~120,000+ | Never expires |
| **Custom** | Contact us | 1B+ Tokens | Unlimited | Never expires |

## Billing Periods & Prepay Discounts

Upgrades under **Settings → Billing → Plans** (requires `billing:manage`) support 4 prepay periods via **VietQR** bank transfer (auto-activated via SePay or confirmed by an admin):

| Period | Prepay Discount |
| --- | :---: |
| **1 month** | 0% |
| **3 months** | -4% |
| **6 months** | -10% |
| **12 months** | -22% |

Valid coupon codes can be applied at checkout (minimum payable amount after discount is **2,000₫**).

## When You Hit a Limit

| Scenario | Error Code | System Behavior |
| --- | --- | --- |
| Connected channel cap reached | `PLAN_LIMIT_EXCEEDED` | Blocks adding new channels and prompts an upgrade. |
| Member seat cap reached | `WORKSPACE_SEAT_LIMIT_EXCEEDED` | Blocks sending new member invitations. |
| Feature requires a higher plan | `FEATURE_NOT_IN_PLAN` | Displays a plan lock with an upgrade prompt. |
| AI Wallet out of tokens | `AI_WALLET_INSUFFICIENT_TOKENS` | AI Bot pauses replies/drafts until tokens are topped up. |
| Plan expired / over channel cap | — | Excess channels are suspended (`lockedNicks`) until renewed or upgraded. |