Skip to main content
System and administration

Lunch scheduling settings

Set the lunch rules for your organization: the deadline, the lunch length, the start-of-shift prompt, warnings and alarm, who approves skipped lunches, who is e-mailed, and overrides for a team or one agent.

Last updated 18 days ago

The Lunch scheduling settings page sets the rules that lunch scheduling follows: how soon after work starts a lunch is due, how long it is, how agents are prompted and warned, and who decides and who is told when something goes wrong. The numbers apply to everyone, and you can override most of them for a team or for one agent.

Before you start: you need the Administrator, Service Desk Manager or Timeclock Admin sign-in role. Lunch scheduling is off until you switch it on here, so nothing changes for anyone until you do. Agents must be linked to their sign-ins. The two away limits stay on the Messaging tab of Q-Director: Slack, Teams and agent mapping and still apply to lunch.

Open the settings

Open Lunch scheduling settings from the link on the Messaging tab of Q-Director Config, or go to /settings/lunch. The page opens with a one-line example for an agent with the default shift and updates as you change the numbers, for example the deadline and the start times the picker will offer.

Turn it on and set the rule

Select the box at the top of the page, which reads Lunch scheduling is off, so that it reads Lunch scheduling is on. Then set the rule that every agent follows:

SettingWhat it does
Hours workable without a lunch breakHours after work starts by which lunch must start (5 hours by default; from 1 to 12). A shift no longer than this needs no lunch.
Lunch break duration (minutes)The length of a lunch (60 by default). One length is used in the panel, Slack, Teams and the Dispatch board.
Earliest lunch after work starts (minutes)The earliest a lunch may start (120 by default).
Slot size (minutes)How far apart the start times in the picker are (15 by default).
Warnings before the deadline (minutes)Up to four warnings, such as 30, 10, as the deadline comes closer.
Planned-start remindersWhether agents get a reminder shortly before a planned lunch starts.

Set the start-of-shift prompt

SettingWhat it does
Prompt modeRemind offers the picker as a sheet agents can close. Required covers the panel's tab area until the agent picks a time, asks for a different time or asks to skip; it never covers the header or the Clock tab. Off never prompts.
"Decide in 15 minutes" allowancesHow many times an agent can put a required prompt off.
Prompt on these daysThe days of the week the prompt is shown.
Reserve a slot automaticallyWhen an agent has not picked, QuantumOps reserves a time and tells them.
Reserve this long before the deadline (minutes)How long before the deadline the automatic reservation is made.

Set what happens past the deadline

SettingWhat it does
Alarm and banner for the agentThe red banner and the repeating sound for an agent whose deadline passed.
Alarm repeats every (minutes)How often the sound repeats.
Dispatch board bannerThe red banner across the Dispatch board naming who is late.
Tell leads and managers after (minutes)How long after the deadline leads and approvers are told by a notice and a direct message.
Send the e-mail after (minutes)How long after the deadline the e-mail below is sent.
Chat message when the extension is closedSend a Slack or Teams message to an agent whose panel is closed.
"Emergency: keep working" lasts (minutes)How long the alarm stays quiet after an agent uses it.
...and may be used this many timesHow many times an agent can use it in a day.

Choose who decides

Two groups of sign-in roles:

  • Approvers (sign-in roles) decide skip-lunch requests. The boxes Agents marked Supervisor also approve and Service delivery managers (SDM roles) also approve add those agents.
  • May move someone else's lunch (sign-in roles) may move another person's lunch with a reason. Moving it past the deadline needs an approver too. Customer Success can see the Dispatch board but is not on this list unless you add it.

Select Save settings when you finish. Settings that are empty use the default, which the page shows next to each box.

Set the e-mail contacts

E-mail contacts lists the three lunch e-mails: the deadline passed, a skip request, and its decision. For each, select Send this e-mail, add Designated contacts (pick a person from your PSA and they are added at once, or type an outside address and select Add) and choose whether to also e-mail every agent marked Supervisor, or the agent it is about. These are the same notifications as on the Settings tab of the timeclock Admin Hub, so changing them in either place changes both. The deadline-passed e-mail is on by default and goes to supervisors; the two skip e-mails are off until you turn them on. Select Save contacts to keep your changes.

Override a team or one agent

Team overrides lets a team use its own prompt mode, lunch length and other numbers. Choose a team (the list holds the teams in your PSA and any team your agents already carry), select Add, set only what differs (an empty box means Inherit), then Save team. Remove override returns the team to the organization's numbers.

For one agent, open the agent in Team Management and use the Lunch section of the Edit details dialog: each box shows what the agent would inherit, and Use the team's numbers removes the override. The order is agent, then team, then organization, then the default. An agent in several teams uses their primary team's settings.