Missing Features & Access
View as Markdown
When a menu is hidden or an action is blocked in OmnyBot, the cause falls into one of three categories: a **missing RBAC permission**, a **plan-gated feature**, or a **numeric quota limit**.
## Quick Diagnosis
| Symptom / Error Code | Cause | Fix |
| --- | --- | --- |
| Menu/button hidden only for you, or `WORKSPACE_PERMISSION_DENIED` (403) | **Missing RBAC permission** on your current role. | Ask someone with `member:manage` to update your role under **Settings → Admin → Members** or grant the permission to your custom role. |
| Locked screen with upgrade prompt for **everyone**, or `FEATURE_NOT_IN_PLAN` (403) | **Plan gate** — feature requires a higher tier. | A member with `billing:manage` must upgrade under [Plans & Trials](/workspace-management/billing/). |
| `PLAN_LIMIT_EXCEEDED` (403) or `WORKSPACE_SEAT_LIMIT_EXCEEDED` (409) | **Numeric quota reached** (`maxNicks` or `maxSeats`). | Remove unused channels/members or upgrade your plan — see [Plans & Limits](/reference/plans-limits/). |
## Can't Configure AI Bots or Knowledge Base
**Cause:**
- Your account lacks the **`ai:manage`** permission (only `OWNER`, `MANAGER`, or a custom role with `ai:manage` can configure AI Bots, MCP, and Knowledge Base).
- Note: AI Reply & Bots (`aiReply`) are enabled starting on the **Free** plan, so inability to open AI configuration is a **permission issue**, not a plan gate.
**Fix:**
1. Ask an Owner or Manager to configure it, or grant **`ai:manage`** to your role.
2. If configured but the Bot is not replying, see [AI Not Working](/troubleshooting/ai-issues/).
## Can't Create or Edit Custom Roles
**Cause:**
- Custom roles require the **Growth (`GROWTH`)** plan or higher (`FEATURE_NOT_IN_PLAN`).
- Requires the **`role:manage`** permission (granted only to `OWNER` by default).
- Attempting to edit/delete one of the 4 system roles (`OWNER`, `MANAGER`, `AGENT`, `VIEWER`) returns `WORKSPACE_ROLE_SYSTEM_IMMUTABLE`.
- Attempting to delete a custom role still assigned to members returns `WORKSPACE_ROLE_IN_USE`.
**Fix:**
1. Confirm the workspace is on **Growth** or higher and your account has `role:manage`.
2. Create a new custom role rather than editing system roles.
3. Reassign all members off a custom role before deleting it.
## Can't Assign Multiple Roles to One Member
**Cause:**
- **Multi-role per member (`multiRolePerMember`)** requires the **Scale (`SCALE`)** plan or higher.
- Requires `member:manage`, and you cannot edit your own role (`WORKSPACE_CANNOT_MODIFY_SELF`).
**Fix:**
1. Upgrade to **Scale** or higher to combine multiple roles on a single member.
2. On **Growth**, create a custom role bundling the exact permissions needed.
## Can't View the Audit Log
**Cause:**
- Requires the **`audit:read`** permission (default on `OWNER` and `MANAGER`).
- Requires the **Growth (`GROWTH`)** plan or higher to view the log UI (events are still recorded on all plans).
**Fix:**
1. Ensure your role includes `audit:read`.
2. Upgrade to **Growth** or higher to view the full event history (including events recorded prior to upgrading).
## Can't Leave or Delete Workspace
- **Delete Workspace section not visible:** Only an **`OWNER`** can see and trigger workspace deletion under [General Settings](/workspace-management/general-settings/).
- **Can't leave or demote yourself (`WORKSPACE_OWNER_CANNOT_LEAVE` / `WORKSPACE_LAST_OWNER`):** Every workspace requires at least **1 Owner**. Assign `OWNER` to another member first before leaving or changing your role.
## Can't Start the 14-Day Free Trial
- **`EMAIL_NOT_VERIFIED`:** Verify your account email address before starting a trial.
- **`BILLING_TRIAL_ALREADY_CLAIMED`:** This workspace or account has already used a trial.
- **`BILLING_TRIAL_ZALO_ALREADY_USED`:** A connected Zalo account was already used in a previous trial.
When a menu is hidden or an action is blocked in OmnyBot, the cause falls into one of three categories: a missing RBAC permission, a plan-gated feature, or a numeric quota limit.
Quick Diagnosis
Section titled “Quick Diagnosis”| Symptom / Error Code | Cause | Fix |
|---|---|---|
Menu/button hidden only for you, or WORKSPACE_PERMISSION_DENIED (403) | Missing RBAC permission on your current role. | Ask someone with member:manage to update your role under Settings → Admin → Members or grant the permission to your custom role. |
Locked screen with upgrade prompt for everyone, or FEATURE_NOT_IN_PLAN (403) | Plan gate — feature requires a higher tier. | A member with billing:manage must upgrade under Plans & Trials. |
PLAN_LIMIT_EXCEEDED (403) or WORKSPACE_SEAT_LIMIT_EXCEEDED (409) | Numeric quota reached (maxNicks or maxSeats). | Remove unused channels/members or upgrade your plan — see Plans & Limits. |
Can’t Configure AI Bots or Knowledge Base
Section titled “Can’t Configure AI Bots or Knowledge Base”Cause:
- Your account lacks the
ai:managepermission (onlyOWNER,MANAGER, or a custom role withai:managecan configure AI Bots, MCP, and Knowledge Base). - Note: AI Reply & Bots (
aiReply) are enabled starting on the Free plan, so inability to open AI configuration is a permission issue, not a plan gate.
Fix:
- Ask an Owner or Manager to configure it, or grant
ai:manageto your role. - If configured but the Bot is not replying, see AI Not Working.
Can’t Create or Edit Custom Roles
Section titled “Can’t Create or Edit Custom Roles”Cause:
- Custom roles require the Growth (
GROWTH) plan or higher (FEATURE_NOT_IN_PLAN). - Requires the
role:managepermission (granted only toOWNERby default). - Attempting to edit/delete one of the 4 system roles (
OWNER,MANAGER,AGENT,VIEWER) returnsWORKSPACE_ROLE_SYSTEM_IMMUTABLE. - Attempting to delete a custom role still assigned to members returns
WORKSPACE_ROLE_IN_USE.
Fix:
- Confirm the workspace is on Growth or higher and your account has
role:manage. - Create a new custom role rather than editing system roles.
- Reassign all members off a custom role before deleting it.
Can’t Assign Multiple Roles to One Member
Section titled “Can’t Assign Multiple Roles to One Member”Cause:
- Multi-role per member (
multiRolePerMember) requires the Scale (SCALE) plan or higher. - Requires
member:manage, and you cannot edit your own role (WORKSPACE_CANNOT_MODIFY_SELF).
Fix:
- Upgrade to Scale or higher to combine multiple roles on a single member.
- On Growth, create a custom role bundling the exact permissions needed.
Can’t View the Audit Log
Section titled “Can’t View the Audit Log”Cause:
- Requires the
audit:readpermission (default onOWNERandMANAGER). - Requires the Growth (
GROWTH) plan or higher to view the log UI (events are still recorded on all plans).
Fix:
- Ensure your role includes
audit:read. - Upgrade to Growth or higher to view the full event history (including events recorded prior to upgrading).
Can’t Leave or Delete Workspace
Section titled “Can’t Leave or Delete Workspace”- Delete Workspace section not visible: Only an
OWNERcan see and trigger workspace deletion under General Settings. - Can’t leave or demote yourself (
WORKSPACE_OWNER_CANNOT_LEAVE/WORKSPACE_LAST_OWNER): Every workspace requires at least 1 Owner. AssignOWNERto another member first before leaving or changing your role.
Can’t Start the 14-Day Free Trial
Section titled “Can’t Start the 14-Day Free Trial”EMAIL_NOT_VERIFIED: Verify your account email address before starting a trial.BILLING_TRIAL_ALREADY_CLAIMED: This workspace or account has already used a trial.BILLING_TRIAL_ZALO_ALREADY_USED: A connected Zalo account was already used in a previous trial.