> ## Documentation Index
> Fetch the complete documentation index at: https://chatbase.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Schedule agent shifts and time off in the Helpdesk

> Define shifts and time off so agent availability and ticket auto-assignment run on their own.

Chatbase Helpdesk scheduling lets support leads define recurring weekly **Shifts**, put teammates on them, and add **Time off**. A teammate on a shift is set to **Available** during their shift hours and **Away** outside them, so ticket auto-assignment only sends them tickets while they're working. Shifts also feed the [Attendance](https://chatbase.co/docs/user-guides/chatbot/help-desk/attendance.md) and [Live Status](https://chatbase.co/docs/user-guides/chatbot/help-desk/live-status.md) reports.

You manage scheduling from the AI agent's **Settings → Helpdesk → Scheduling** page. It has three cards: **Shifts**, **Agent schedules**, and **Time off**. Shifts, schedules, and time off belong to one AI agent: someone who works on two AI agents has a separate shift, status, and time off on each.

***

## How availability is determined

Each agent is in one of two modes:

* **Scheduled**: the agent has a shift assigned. Their status is computed in real time from the shift's working hours plus any time off. The Scheduling page shows it as `On shift` or `Off shift`, and the Members page and [Live Status](https://chatbase.co/docs/user-guides/chatbot/help-desk/live-status.md) show the same two states as `Available` and `Away`. They cannot change it manually.
* **Manual**: the agent has no shift. Their status (`Available`, `Away`, `Busy`, `Paused`) is set by an admin, or by the agent themselves if you allow it on the **Members** page (**Settings → Helpdesk → Members**).

Only agents who are currently `Available` (manual) or `On shift` (scheduled, with no active time off) are eligible for new ticket assignment.

***

## Create a shift

A shift is the days of the week and the working hours you set for each day, in the timezone you choose. It repeats every week.

**1. Open the Shifts card**

Go to **Settings → Helpdesk → Scheduling** and click **Add shift** in the **Shifts** card.

**2. Name the shift**

Enter a name like *Weekday Standard* or *EU Mornings*. Names help you tell shifts apart when you assign them.

**3. Choose a timezone**

Pick the timezone the working hours should be evaluated in. The selector defaults to your browser's timezone.

**4. Set working days and hours**

Toggle each day you want the shift to be active. For each enabled day, pick a **Start time** and **End time**. Times are in 15-minute increments and default to **09:00 to 17:00**.

Use the **12h / 24h** toggle in the Shifts card header to switch the time format.

If the End time is the same as or earlier than the Start time, the shift is treated as overnight and continues into the next day. The dialog shows a **(next day)** label so you can confirm.

Each day has one start and one end time. To cover a split day, such as 09:00 to 12:00 and 14:00 to 18:00, set the full span or use manual status for that agent.

**5. Save**

Click **Save** to create the shift. It now appears in the Shifts card and becomes available in the Agent schedules dropdown.

You can edit or delete shifts at any time. Deleting a shift moves every agent assigned to it back to manual mode: the dialog says "Agents on this shift will revert to manual mode." There is no limit on the number of shifts.

### Example shifts

| Shift | Timezone | Days | Hours |
| - | - | - | - |
| *EU Mornings* | Europe/Berlin | Mon to Fri | 08:00 to 16:00 |
| *US Evenings* | America/New\_York | Mon to Fri | 14:00 to 22:00 |
| *Weekend Night* | America/Los\_Angeles | Sat, Sun | 22:00 to 06:00 (next day) |

Hours are read in the shift's own timezone, so a shift follows daylight saving time. A 09:00 to 17:00 shift stays 09:00 to 17:00 local time all year.

***

## Assign agents to shifts

The **Agent schedules** card lists every Helpdesk agent with a per-agent shift dropdown. Each agent can be on one shift per AI agent.

* Pick a shift name from the dropdown to put the agent on that schedule.
* Pick **No shift (manual)** to remove the schedule and manage their status manually. This sets the agent to `Away`.

The badge at the top of the card shows how many of your agents currently have a shift, in the form **2/5 scheduled**.

> [!WARNING]
>
> Removing a shift from an agent who has scheduled time off will make those time off entries inert, since time off only applies to scheduled agents. The dashboard will warn you before this happens.

***

## Add time off

Use **Time off** to block dates for scheduled agents (vacation, holidays, sick leave, or anything else that should make them unavailable during their normal shift hours).

**1. Open the Time off card**

In **Scheduling**, click **Add time off** in the **Time off** card.

**2. Pick agents**

Select one or more agents from the **Agents** field. Only agents who currently have a shift assigned can be picked, since time off has no effect on manual agents.

**3. Pick a date range**

Choose a start and end date in the **Dates** picker. You cannot pick dates in the past. Time off covers whole days: any day in the range makes the agent unavailable for that day's shift, and there's no way to book part of a day.

**4. Add a reason (optional)**

Optionally enter a short reason like *Annual leave* or *Public holiday*.

**5. Save**

Click **Save**. During the selected dates, every chosen agent is treated as `Off shift` and is not eligible for new ticket assignment, even if their shift covers those days.

Past time off entries are hidden once their end date passes. If no agent has a shift yet, the card says "Assign agents to shifts before adding time off."

***

## Status indicators

| Indicator | Meaning |
| - | - |
| **On shift** (green) | Scheduled agent, currently inside their shift hours and not on time off. |
| **Off shift** (amber) | Scheduled agent, outside shift hours, or on time off. |
| **Available** (green) | Manual agent, set as available and eligible for assignment. |
| **Away** (amber) | Manual agent, not eligible for assignment. |
| **Busy** (red) | Manual agent, not eligible for assignment. |
| **Paused** (grey) | Manual agent, not eligible for assignment. |

On the **Members** page, scheduled agents show the tooltip `Status is managed by the schedule "<shift name>"`. Their status is read-only because the schedule is in charge, and it reads **Available** or **Away** there rather than On shift or Off shift.

***

## How scheduling affects auto-assignment

Scheduling acts as the eligibility gate for ticket auto-assignment:

* **Manual agents** are eligible when their stored status is `Available`.
* **Scheduled agents** are eligible when the current time is inside their shift (in the shift's timezone) and they have no active time off.

The assignment algorithm (Balanced or Round robin) then picks one agent from that pool. See [Ticket Assignment](https://chatbase.co/docs/user-guides/chatbot/help-desk/assignment-algorithm.md) for how each algorithm chooses.

If nobody is eligible, the ticket stays unassigned. A shift starting on its own doesn't release it: waiting tickets are picked up when something changes, such as an agent being set to `Available`, a shift being edited, an agent being put on a shift, or time off being added or removed. See [When waiting tickets are picked up](https://chatbase.co/docs/user-guides/chatbot/help-desk/assignment-algorithm.md#when-waiting-tickets-are-picked-up).

To avoid the wait, enable **Assign to next available shift**, which assigns tickets straight away to the agent whose shift starts soonest. See [Assign to next available shift](https://chatbase.co/docs/user-guides/chatbot/help-desk/assignment-algorithm.md#assign-to-next-available-shift) for details.

***

## Tips and edge cases

* **Overnight shifts** wrap past midnight automatically. Pick an end time that is the same as or earlier than the start time, and the shift continues into the following day.
* **Deleting a shift** moves every assigned agent back to manual mode. It does not reset their status, so they keep whatever status the schedule last set. Picking **No shift (manual)** in the per-agent dropdown is what sets an agent to `Away`.
* **New agents** start as `Away` until you assign them a shift or change their status manually.
* **Time off only applies to scheduled agents.** If you want a manual agent to be unavailable, change their status directly.
* **Shifts and time off also drive [Attendance](https://chatbase.co/docs/user-guides/chatbot/help-desk/attendance.md),** which compares each agent's shift with the time they had the Helpdesk open.
* **Daylight saving time** is handled by the shift's timezone. Shift hours stay the same in local time when the clocks change.
* **Shifts, schedules, and time off use the same permission as editing Helpdesk tickets.** Changing your own status only needs access to the Helpdesk, and only works when **Allow teammates to be able to change their availability status** is on.

***

## Frequently asked questions

> [accordion] Do shifts adjust for daylight saving time?
>
> Yes. Each shift has a timezone, such as Europe/Berlin, and its hours are read in that zone's local time, so a 09:00 to 17:00 shift stays 09:00 to 17:00 all year.

> [accordion] Do waiting tickets get assigned when a shift starts?
>
> Not by the shift starting alone. Waiting tickets are picked up when something changes, such as an agent being set to Available or a shift being edited. Turn on **Assign to next available shift** on the team to assign tickets to the next agent on shift right away.

> [accordion] What happens to agents when I delete a shift?
>
> They go back to manual mode and keep the status the schedule last set. Removing a single agent from a shift with **No shift (manual)** sets them to `Away`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.