Docs
Every command, every option, in one page.
The reference for server admins and support staff. 9 cogs, 52 commands. Permissions, plan gates, cooldowns, and the error states you might hit, listed up front.
Recording soon
Placeholder until the walkthrough is published. No external requests are made.
Get the bot running in under 2 minutes
Invite → /panel create → publish → first ticket opened.
Recording soon
Placeholder until the walkthrough is published. No external requests are made.
Teaching the AI brain
/ai train walkthrough with 2-3 real entries, then a ticket where the brain answers using the trained facts.
Cog
Setup
One-command onboarding to make a brand-new server ready for tickets.
/setup
All plansSet up everything a fresh server needs to take tickets: creates or reuses a staff role, a private Tickets category, a public panel channel, and a published default panel.
Who can run it
- guild_admin:manage_guild
- guild_only
Manage Server only; the bot also needs Manage Channels + Manage Roles. Refuses to run if the guild already has any panel (use /panel create after onboarding).
Cooldown
2 per guild / 300s
What you see
Ephemeral summary embed: the staff role used/created, the live panel channel, and next-step tips.
Error states
- Guild already has panels (already_set_up)
- Bot missing Manage Channels / Manage Roles (missing_bot_perms)
- Channel or panel creation failed (channel_failed / role_failed)
Cog
Tickets
Open, claim, transfer, close, and manage tickets. The day-to-day surface for both members and support staff.
/ticket open
All plansOpen a new ticket from a panel, or open one on a member's behalf (staff).
Param Type Req Description panel string yes Which ticket panel to open fromautocomplete: published panels in this server category string yes Category within that panelautocomplete: categories of the chosen panel open_for user no Staff only: open the ticket on behalf of this member Who can run it
- everyone
- guild_only
Self-open requires the panel to be published and the member not to be blacklisted. `open_for` requires manage_guild OR a staff role with can_claim/can_close.
Cooldown
5 per user / 60s
What you see
Ephemeral confirmation embed with a jump button to the new ticket channel.
Error states
- User on blacklist
- Panel not published
- Per-panel ticket limit reached (plan gate)
- Guild-wide ticket limit reached
- Category at Discord's 50-channel cap (Premium: clone-category-on-limit)
- Bot missing Manage Channels in the panel category
/ticket close
All plansClose the current ticket and generate a transcript.
Param Type Req Description reason string no Optional close reason recorded on the transcript Who can run it
- inside_ticket_only
- guild_only
Opener can close their own ticket if `users_can_close_tickets` is enabled (default on). Staff with can_close or manage_guild can always close.
Cooldown
5 per user / 60s
What you see
Public 'closing…' progress embed, then transcript DM to the opener, then channel deletion.
Error states
- Not in a ticket channel
- Already closed
- Users-can-close disabled (opener tried to close)
/ticket claim
All plansClaim the current ticket (toggle: claims if open, unclaims if you already claimed it).
Who can run it
- inside_ticket_only
- panel_staff:can_claim
- guild_only
Unclaiming someone else's claim requires top_role.position >= the claimer's, OR manage_guild.
Cooldown
5 per user / 60s
What you see
Channel moves to the claimed category; welcome message buttons swap to the Unclaim view; in-channel notice posted.
Error states
- Already claimed by someone else
- Not in a ticket channel
- Cannot unclaim — outranked by the original claimer
- Claim not supported on thread-mode panels
/ticket transfer
All plansMove this ticket to a different category on the same panel.
Param Type Req Description category_name string yes Pick a destination categoryautocomplete: categories of the current panel Who can run it
- inside_ticket_only
- panel_staff:can_transfer
- guild_only
Cooldown
5 per user / 60s
What you see
Channel renames + moves; lifecycle embed posted in-channel; audit row written.
Error states
- Category at 50-channel cap
- Already in this category
- Not in a ticket channel
/ticket add
All plansAdd a user to this ticket so they can see / message in it.
Param Type Req Description user user yes The user to grant access to this ticket Who can run it
- inside_ticket_only
- panel_staff:can_claim_or_can_close
- guild_only
Cooldown
5 per user / 60s
What you see
Channel permission overwrite added; in-channel confirmation; target gets a DM with a jump button.
Error states
- Target is the opener (already has access)
- Target is a bot
- Not in a ticket
/ticket remove
All plansRemove a previously-added user from this ticket.
Param Type Req Description user user yes The user to remove from this ticket Who can run it
- inside_ticket_only
- panel_staff:can_claim_or_can_close
- guild_only
Cooldown
5 per user / 60s
What you see
Channel permission overwrite cleared; target gets a DM that they were removed.
Error states
- Target is the opener
- Not in a ticket
/ticket ping
All plansDM the ticket opener a jump-back button (with an optional note).
Param Type Req Description note string no Optional short message that appears in the DM Who can run it
- inside_ticket_only
- panel_staff:can_claim_or_can_close
- guild_only
Cooldown
1 per channel / 60s
What you see
Ephemeral confirm to staff; the opener receives a DM (or a notice if their DMs are closed).
Error states
- Opener has DMs disabled
- Not in a ticket
/ticket priority
All plansSet this ticket's priority level (low / normal / high).
Param Type Req Description level choice yes Priority levelchoices: Low, Normal, High Who can run it
- inside_ticket_only
- panel_staff:can_claim_or_can_close
- guild_only
Cooldown
5 per user / 60s
What you see
Ephemeral confirm; priority badge added to ticket lifecycle embeds.
Error states
- Not in a ticket
/ticket settings
allConfigure server-wide ticket settings (auto-close on leave, max active per user, etc.).
Who can run it
- guild_admin
- guild_only
Cooldown
5 per user / 60s
What you see
Opens a modal with Yes/No selects + a numeric cap input.
Error states
- Manage Server permission missing
/ticket stats
All plans*Server-wide ticket statistics for a chosen window.
Param Type Req Description period choice no Time window (Free plans only see Last 7 days)choices: Today, Last 7 days, Last 30 days, Last year, All time panel string no Restrict stats to one panelautocomplete: panel names Who can run it
- guild_admin
- guild_only
Cooldown
10 per user / 60s
What you see
Ephemeral stats embed with counts, timing, AI metrics block (Premium+).
Error states
- Period requires Premium
/ticket search
All plansSearch tickets in this server (filter by status, priority, opener, panel, etc.).
Param Type Req Description period choice no Time windowchoices: Today, Last 7 days, Last 30 days, Last year, All time status choice no Filter by current statuschoices: Open, Claimed, Closed priority choice no Filter by prioritychoices: Low, Normal, High panel string no Filter by panel nameautocomplete: panel names user user no Tickets opened by this user claimed_by user no Tickets claimed by this user closed_by user no Tickets closed by this user has_transcript boolean no Only show tickets with / without a transcript text string no Search text in the close reason Who can run it
- panel_staff:can_claim_or_can_close OR guild_admin
- guild_only
Searching is a core 'do my job' staff feature on every tier — gate is on aggregate analytics, not listing.
Cooldown
10 per user / 60s
What you see
Paginated results embed with select-menu to drill into a single ticket.
/ticket feedbacks
All plansBrowse the satisfaction ratings (CSAT) openers left on closed tickets, with a summary header and pagination.
Param Type Req Description rating choice no Only show ratings with this many starschoices: ⭐ 1 star, ⭐⭐ 2 stars, ⭐⭐⭐ 3 stars, ⭐⭐⭐⭐ 4 stars, ⭐⭐⭐⭐⭐ 5 stars Who can run it
- guild_admin:manage_guild
- guild_only
Manage Server only. Viewing is admin-gated because feedback can be candid; capturing a rating is free for all plans.
Cooldown
10 per user / 60s
What you see
Ephemeral, author-scoped paginated embed (5 per page, prev/next). Header shows total ratings + average; each entry shows stars, ticket channel name, opener, note, and date.
/ticket inactivity pause
Premium+Pause this ticket's inactivity auto-close timer.
Param Type Req Description reason string no Why you're pausing the timer Who can run it
- inside_ticket_only
- panel_staff:can_claim_or_can_close
- guild_only
Cooldown
5 per user / 60s
What you see
Ephemeral confirm; in-channel notice; the reaper skips this ticket until resumed.
Error states
- Plan does not include inactivity close
- Not in a ticket
/ticket inactivity resume
Premium+Resume this ticket's inactivity auto-close timer.
Who can run it
- inside_ticket_only
- panel_staff:can_claim_or_can_close
- guild_only
Cooldown
5 per user / 60s
What you see
Ephemeral confirm; in-channel notice; reaper re-includes the ticket.
Error states
- Not in a ticket
/ticket inactivity status
Premium+Show this ticket's inactivity timer (paused state, time until warn / close).
Who can run it
- inside_ticket_only
- guild_only
Cooldown
10 per user / 60s
What you see
Ephemeral embed with the live timer + Discord-native timestamps for warn / close.
Error states
- Not in a ticket
/ticket ai enable
All plansRe-enable the AI on this ticket after a previous disable (staff only).
Who can run it
- inside_ticket_only
- panel_staff:can_claim_or_can_close
- guild_only
Cooldown
5 per user / 60s
What you see
In-channel notice; AI engages on the user's next message.
Error states
- AI already enabled
- Not in a ticket
- Guild AI token budget exhausted
/ticket ai disable
All plansDisable the AI on this ticket (staff only).
Who can run it
- inside_ticket_only
- panel_staff:can_claim_or_can_close
- guild_only
Cooldown
5 per user / 60s
What you see
In-channel notice; AI stops responding.
Error states
- AI already disabled
- Not in a ticket
Cog
Panels
Create, edit, publish, and delete ticket panels (the embedded message with category buttons users click to open a ticket).
/panel create
All plans*Create a new ticket panel via a guided modal + setup view.
Who can run it
- guild_admin
- guild_only
Cooldown
3 per user / 60s
What you see
Opens a modal; on submit, a setup view appears; auto-publishes with a default 'General Support' category.
Error states
- Panel limit reached for this plan
/panel list
All plansList every panel in this server with its publish state.
Who can run it
- guild_admin
- guild_only
Cooldown
5 per user / 60s
What you see
Ephemeral embed listing panels (name, title, published / draft).
/panel edit
allOpen the multi-section edit menu for one panel (categories, working hours, messages, webhooks, etc.).
Param Type Req Description name string yes Pick a panelautocomplete: existing panel names Who can run it
- guild_admin
- guild_only
Cooldown
5 per user / 60s
What you see
Ephemeral config view with buttons for each sub-section.
Error states
- Panel not found
/panel publish
All plansPublish the panel post to its configured channel (users start clicking the buttons to open tickets).
Param Type Req Description name string yes Pick a panelautocomplete: existing panel names Who can run it
- guild_admin
- guild_only
Cooldown
3 per user / 60s
What you see
Ephemeral success embed with a Jump-to-panel link button.
Error states
- Panel has no categories yet
- Configured channel was deleted
- Bot missing Send Messages / Embed Links in the channel
/panel unpublish
All plansDelete the panel post from Discord (panel config stays in the database).
Param Type Req Description name string yes Pick a panelautocomplete: existing panel names Who can run it
- guild_admin
- guild_only
Cooldown
3 per user / 60s
What you see
Ephemeral confirmation.
Error states
- Panel was never published
- Original message already gone
/panel delete
All plansDelete the panel itself (with a confirm modal asking what to do with open tickets).
Param Type Req Description name string yes Pick a panelautocomplete: existing panel names Who can run it
- guild_admin
- guild_only
Cooldown
3 per user / 60s
What you see
Opens a confirm modal with a 'refuse / keep_open / close_all' choice for any active tickets on the panel.
Error states
- Panel not found
Cog
Staff
Configure which Discord roles are 'staff' and what they're allowed to do (claim, close, train AI, view-all-claimed, transfer).
/staff role add
All plans*Add a Discord role as a staff role with default permissions.
Param Type Req Description role role yes The role to add Who can run it
- guild_admin
- guild_only
Cooldown
5 per user / 60s
What you see
Opens a modal to set the role's can_* permission bitmap; if the role is already configured, the edit modal opens instead.
Error states
- Staff role limit reached for this plan
/staff role edit
All plansEdit an existing staff role's permission bitmap.
Param Type Req Description role string yes Pick a configured staff roleautocomplete: configured staff role names Who can run it
- guild_admin
- guild_only
Cooldown
5 per user / 60s
What you see
Opens the permission-bitmap modal pre-filled with current values.
Error states
- Role no longer exists in Discord
- Not pickable from autocomplete
/staff role remove
All plansStop treating a role as staff (the role itself is untouched).
Param Type Req Description role string yes Pick a configured staff roleautocomplete: configured staff role names Who can run it
- guild_admin
- guild_only
Cooldown
5 per user / 60s
What you see
Opens an ephemeral confirmation view.
/staff role list
All plansShow every configured staff role with their permission bitmap.
Who can run it
- guild_admin
- guild_only
Cooldown
10 per user / 60s
What you see
Ephemeral list embed.
/staff stats
Premium+Per-staff leaderboard (handled count, response time, solve time).
Param Type Req Description period choice no Time windowchoices: Today, Last 7 days, Last 30 days, Last year, All time Who can run it
- guild_admin
- guild_only
Cooldown
10 per user / 60s
What you see
Ephemeral leaderboard embed; top 3 of page 1 get featured fields, rest are compact rows.
Error states
- Plan does not include advanced analytics
Cog
Quick Responses
Saved staff replies. Manage from /qr add|list|edit|delete; staff use them in a ticket via /qr use.
/qr add
All plans*Add a new saved quick-response template.
Who can run it
- guild_admin
- guild_only
Cooldown
5 per user / 60s
What you see
Opens a modal with Name + Response text fields.
Error states
- Quick-response limit reached
/qr list
All plansList every saved quick-response.
Who can run it
- guild_admin
- guild_only
Cooldown
5 per user / 60s
What you see
Ephemeral embed listing each name + a short preview.
/qr edit
All plansEdit the body of an existing quick-response.
Param Type Req Description name string yes Pick a quick responseautocomplete: quick-response names Who can run it
- guild_admin
- guild_only
Cooldown
5 per user / 60s
What you see
Opens a modal pre-filled with the current body.
Error states
- Quick-response not found
/qr delete
All plansDelete a quick-response.
Param Type Req Description name string yes Pick a quick responseautocomplete: quick-response names Who can run it
- guild_admin
- guild_only
Cooldown
5 per user / 60s
What you see
Ephemeral confirm.
Error states
- Quick-response not found
/qr use
All plansSend a saved quick-response into the current ticket.
Param Type Req Description name string yes Pick a quick responseautocomplete: quick-response names Who can run it
- inside_ticket_only
- panel_staff:can_claim_or_can_close OR guild_admin
- guild_only
Cooldown
10 per user / 60s
What you see
Posts the rendered response into the ticket channel + pings the opener.
Error states
- Not in a ticket
- Quick-response not found
Cog
AI
Chat with the server's AI brain, teach it (staff), browse memory, configure usage. Backed by per-server Nexus brains.
/ai ask
allAsk the AI a question in the current channel (anyone can run).
Param Type Req Description message string yes What do you want to ask? attachment_1 attachment no Optional file (image / .txt / .md / .csv) attachment_2 attachment no Optional additional file attachment_3 attachment no Optional additional file Who can run it
- everyone
- guild_only
Cooldown
5 per user / 60s
What you see
Public chat reply in the same channel (so other members see the answer).
Error states
- Guild AI brain not yet provisioned (transient)
- AI token budget exhausted
- Another AI turn in flight for this user
/ai train
allTeach the AI a fact / paste docs / URL (staff only).
Param Type Req Description message string yes What should the AI remember? Paste text, URLs are auto-ingested. attachment_1 attachment no Optional file attachment_2 attachment no Optional file attachment_3 attachment no Optional file Who can run it
- guild_admin OR panel_staff:can_train_ai
- guild_only
Server-authoritative — the handler re-checks the permission even if invoked via the FastAPI dashboard.
Cooldown
5 per user / 60s
What you see
Public reply. Long URLs/paragraphs auto-route to an async training job — the AI confirms what it ingested.
Error states
- Not allowed to train (no can_train_ai)
- AI budget exhausted
- Another train turn in flight
/ai settings
All plansPer-guild AI settings (disable-AI-on-staff-message, show-token-usage).
Who can run it
- guild_admin
- guild_only
Cooldown
5 per user / 60s
What you see
Opens a modal with Yes/No selects for each toggle.
/ai usage
All plansShow the server's current AI token usage (daily + monthly used / limit, extra-token credits).
Who can run it
- guild_admin
- guild_only
Cooldown
5 per user / 60s
What you see
Ephemeral embed with usage gauge + reset timestamps.
Error states
- Brain not yet provisioned
/ai memory
All plansBrowse the AI's memory (brain card + neurons). Lets you delete neurons or suggest updates.
Who can run it
- guild_admin
- guild_only
Cooldown
5 per user / 60s
What you see
Ephemeral embed + paginated neuron browser with per-row delete + suggest-update buttons.
Error states
- No brain provisioned yet
/ai info
All plansHigh-level public AI status for this server (anyone can run).
Who can run it
- everyone
- guild_only
Cooldown
10 per user / 60s
What you see
Public-friendly embed: AI ready / starting up.
/ai reset
All plansWipe every neuron + training job for this server's brain. Two-step confirm.
Who can run it
- guild_admin
- guild_only
Cooldown
3 per user / 60s
What you see
Ephemeral confirm view; only proceeds on second-step button click.
Error states
- No brain provisioned
/ai channel set
Premium+Designate a public channel where the AI answers questions outside the ticket flow.
Param Type Req Description target_channel channel yes Channel where the AI will answer questions mode choice yes When the AI should respondchoices: Only when @mentioned, On every message Who can run it
- guild_admin
- guild_only
Cooldown
5 per user / 60s
What you see
Ephemeral confirm; also bumps the channel's slowmode to 10s if it's currently 0.
Error states
- Plan does not include the public AI channel feature
/ai channel clear
Premium+Stop the AI from responding in any public channel.
Who can run it
- guild_admin
- guild_only
Cooldown
5 per user / 60s
What you see
Ephemeral confirm.
/ai channel status
All plansShow the current AI public-channel configuration.
Who can run it
- guild_admin
- guild_only
Cooldown
10 per user / 60s
What you see
Ephemeral embed with the active channel + mode, or 'not set'.
Cog
Subscription
Customer-facing checkout — generate a Stripe or NOWPayments payment URL for the server's premium subscription.
/subscription buy
All plansGenerate a checkout link to subscribe this server to Premium or Pro.
Param Type Req Description provider choice yes How you want to paychoices: Card (Stripe), Crypto (NOWPayments) plan choice yes Which plan to subscribe tochoices: Premium, Pro cycle choice yes Billing cycle (annual ≈ 17% off)choices: Monthly, Annual Who can run it
- guild_admin
- guild_only
Cooldown
5 per user / 60s
What you see
Ephemeral premium embed with three link buttons: Continue to checkout, Privacy Policy, Terms of Service.
Error states
- Brain not yet provisioned (transient)
- Server already has an active subscription
- Selected plan not configured for sale (missing Stripe price ID)
- Crypto + Monthly combination (NOWPayments only supports one-shot — pick Annual or switch to Stripe)
/subscription info
All plansShow this server's subscription status, AI usage, and unlocked features.
Who can run it
- everyone
- guild_only
Public read — any member can check the server's plan / usage gauge. Action buttons (Upgrade / Manage subscription) link to the dashboard, which authenticates the click with Discord OAuth.
Cooldown
10 per user / 60s
What you see
Ephemeral premium embed with the current plan, status (Active / Past due / Canceled / Free), renewal/expiry timestamps, AI usage gauge (when the brain is provisioned), feature highlights, and contextual link buttons: Upgrade (Free), Manage subscription (Stripe sub), Privacy, Terms.
Error states
- Server not registered (rare — first-touch race; re-invite the bot)
Cog
Server Settings
Server-wide bot configuration: language and whitelabel.
/language
All plansChange the bot's display language for this server.
Who can run it
- guild_admin
- guild_only
Cooldown
5 per user / 60s
What you see
Ephemeral select menu with the available locales.
/whitelabel
Premium+Customize the bot's nickname, avatar, banner, and bio for this server (Premium).
Who can run it
- guild_admin
- guild_only
Cooldown
3 per user / 60s
What you see
Opens a 4-field modal; on submit, saves AND auto-applies to Discord in the same flow.
Error states
- Plan does not include whitelabel
- Image URL download failed (partial save)
Cog
Public / Info
Public utility commands available to every member.
/help
All plansBrowse every available command + their usage. Optional `command` zooms in.
Param Type Req Description command string no Optional: zoom in on one commandautocomplete: every available command Who can run it
- everyone
Cooldown
5 per user / 60s
What you see
Ephemeral grouped overview, or a detail card when a command is specified.
Error states
- Command name not found
/invite
All plansShow the bot invite link + support server + dashboard links.
Who can run it
- everyone
Cooldown
5 per user / 60s
What you see
Ephemeral embed with three link buttons.
/about
All plansBot info, live global stats (servers, lifetime tickets, AI resolved, avg response), version.
Who can run it
- everyone
Cooldown
5 per user / 60s
What you see
Ephemeral embed with cached global stats + Nexus probe.
Error states
- Stats snapshot not yet warmed up (~30s after boot)
/ping
All plansCheck Discord, Database, and Nexus AI latency.
Who can run it
- everyone
Cooldown
5 per user / 60s
What you see
Ephemeral embed with three latency rows; color reflects the worst component.
Reference
Glossary
Short codes used in the permission and plan-gate chips above.
Permissions
- everyone
- Any server member. No Discord-level perms required.
- guild_only
- Refuses DMs.
- guild_admin
- Discord-level Manage Server (manage_guild) OR Administrator.
- inside_ticket_only
- The slash invocation must be inside a ticket channel or thread.
- panel_staff:can_claim
- A role configured in /staff role with the can_claim bit set.
- panel_staff:can_close
- A role configured in /staff role with the can_close bit set.
- panel_staff:can_train_ai
- A role configured in /staff role with the can_train_ai bit set.
- panel_staff:can_transfer
- A role configured in /staff role with the can_transfer bit set.
- panel_staff:can_claim_or_can_close
- Either can_claim OR can_close. Used by /ticket add|remove|ping|priority and /qr use.
Plan gates
- all
- Free, Premium, Pro, Enterprise.
- Free
- Limited tier (1 panel, 5 categories/panel, 5 QRs, 3 staff roles, 50k tokens/day, 500k tokens/month, 30-day transcripts, watermark forced).
- Premium
- €9.99/mo or €99/yr. 5 panels, 10 categories/panel, 50 QRs, 10 staff roles, 250k tokens/day, 3M tokens/month, 365-day transcripts, no watermark, full feature flags.
- Pro
- €29.99/mo or €299/yr. 15 panels, 15 categories/panel, 200 QRs, 25 staff roles, 1M tokens/day, 15M tokens/month, 730-day transcripts.
- Enterprise
- Per-deal custom limits + price; operator-negotiated.
- feat_modal_questions
- Premium+ — custom open-time questions on a panel category.
- feat_working_hours
- Premium+ — UTC schedule per panel.
- feat_inactivity_close
- Premium+ — auto-close after N hours of silence.
- feat_clone_category_on_limit
- Premium+ — overflow when a Discord category hits the 50-channel cap.
- feat_embed_customization
- Premium+ — per-panel colors, thumbnail, banner.
- feat_whitelabel
- Premium+ — per-server bot nick / avatar / banner / bio.
- feat_public_faq_channel
- Premium+ — designate a public channel where the AI answers.
- feat_outgoing_webhooks
- Premium+ — per-panel outgoing webhooks (HMAC signed).
- feat_advanced_analytics
- Premium+ — /ticket stats AI block + arbitrary time ranges + /staff stats.
Still missing something?
If a command behaves differently than what is documented here, that is a bug. Email [email protected] and we will reconcile the bot, the export, and this page.
Looking for billing or refund details? See the pricing page and refund policy.