SupportDeskSupport Desk Docs
v1.0.0 Public Support Open App

Departments

A department is an internal team that can receive tickets. Think of it like a folder plus an owner group: Billing tickets go to Billing, technical tickets go to Technical Support, HR tickets go to HR.

Why Departments Matter

  • Tickets require a department, so every ticket has a team owner.
  • Users can belong to a department, which helps filtering and assignment.
  • Categories can automatically route tickets to departments.
  • SLA policies can be scoped to one department.
  • Reports and dashboards can group work by department.

Department Fields

FieldPlain MeaningExample
Department NameThe team name shown in ticket forms, filters, and reports.Billing Support
Department EmailOptional shared email address for the team.billing@example.com
Default Assigned AgentThe fallback person when the department receives a ticket and no more specific assignee is chosen.Send unclassified Billing tickets to Ayesha Khan.
Sort OrderDisplay order. Smaller numbers appear earlier.10 for Support, 20 for Billing.
Assignment StrategyHow the app chooses an agent when there is no fixed category assignee.least_loaded chooses the agent with fewer open tickets.
Active DepartmentWhether this department is available for new routing.Turn off an old department after a reorganization.
DescriptionInternal note explaining what the department handles.Handles invoices, payments, refunds, and contract billing questions.

Assignment Strategy Examples

StrategyHow It BehavesUse It When
Default AssigneeUses the department fallback person.A small team has one triage owner.
Round RobinRotates work across eligible users.You want fair distribution across a similar team.
Least LoadedPrefers the eligible user with fewer open tickets.You want to avoid overloading one agent.

Example: Billing Department

  1. Create department Billing Support.
  2. Set email to billing@example.com.
  3. Choose a default assigned agent, such as the billing lead.
  4. Set assignment strategy to least_loaded if multiple billing agents share the work.
  5. Mark it active.
  6. In Ticket Setup, create categories such as Invoice Question and Refund Request, then point those categories to Billing Support.

Department vs Category

ConceptSimple MeaningExample
DepartmentWho owns the work.Technical Support
CategoryWhat type of work it is.Bug Report

A ticket can be in the Technical Support department and have category Bug Report. The department tells the system which team owns it; the category tells staff what kind of issue it is.

Delete Rules

A department cannot be deleted while users, tickets, issue groups, SLA policies, or category automation still reference it. This protects history. If you no longer need a department, deactivate it first. Deleting is safest only before the department has been used.

Permissions

Users need view departments to see the list, create departments to add one, edit departments to change one, and delete departments to remove one.

Screenshots To Add

These placeholders are intentionally kept in the docs so release screenshots can be dropped in later without changing the written guide for Departments.

Screenshot 1
Departments main screen
documentation/assets/media/screenshots/departments-admin/01-overview.png
Add the first-view screenshot for this documentation page or app module.
Screenshot 2
Departments key workflow
documentation/assets/media/screenshots/departments-admin/02-workflow.png
Add the most important form, table, modal, drawer, or guided-step screenshot.