Skip to content

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.

Symptom / Error CodeCauseFix
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: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.

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

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:

  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.

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).
  • Delete Workspace section not visible: Only an OWNER can 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. Assign OWNER to another member first before leaving or changing your role.
  • 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.