# Agent Roster Management

The **Agent Roster Management** feature allows owners and admins to plan agents’ working schedules, set on-duty and off-duty periods, and automate off-duty messaging.

{% hint style="info" %}
⚙️ Available for **Owner** and **Admin** roles only.\
💡 This is a **paid add-on feature**.
{% endhint %}

### Accessing the Agent Roster Management Page

You can find this feature under: Settings page > Team > Agent Roster Management

<figure><img src="https://605198658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP7nf2G1iCRba8EP7DawZ%2Fuploads%2FlTUKKANflnsycYuxEPr6%2Fimage.png?alt=media&#x26;token=0bda82de-bb55-419d-a852-0230172e5f58" alt=""><figcaption></figcaption></figure>

From this page, you can:

* **Search and filter** by team or agent name.

<figure><img src="https://605198658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP7nf2G1iCRba8EP7DawZ%2Fuploads%2FRoi8U1LVgvRaJrNMejfL%2Fimage.png?alt=media&#x26;token=84d47645-a169-4146-af36-cbe1d67c5078" alt="" width="563"><figcaption></figcaption></figure>

* **Switch the default view** between **On-Duty** and **Off-Duty** using the toggle on the bottom.

<figure><img src="https://605198658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP7nf2G1iCRba8EP7DawZ%2Fuploads%2FIQuQhX7HPo2jqE0gD9j4%2Fimage.png?alt=media&#x26;token=6af350c0-8067-4348-ba10-01fd3d9e3935" alt="" width="563"><figcaption></figcaption></figure>

* **View uploaded rosters** and agent availability in a calendar format.

### Step 1: Customize Duty Slots

Click **Roster Setting** to define your organization’s duty slots.

<figure><img src="https://605198658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP7nf2G1iCRba8EP7DawZ%2Fuploads%2FkxJinxeRJGuRMrYKdM3H%2Fimage.png?alt=media&#x26;token=e1d35bb9-c3eb-42ce-a8d4-3f98bf2391c7" alt=""><figcaption></figcaption></figure>

<figure><img src="https://605198658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP7nf2G1iCRba8EP7DawZ%2Fuploads%2FwyKHYX3rb4igQZCqNNKQ%2Fimage.png?alt=media&#x26;token=1e2cd0e4-1eb2-4721-98c7-b2c6c2edbc12" alt=""><figcaption></figcaption></figure>

Each duty slot can include:

* **Slot Name:** e.g., Morning, Afternoon, Night Shift
* **Color:** Used for easy visual distinction on the roster calendar
* **Slot Period:** Define start and end time for each slot
* **Maximum of 5 slots** can be created

***

### Step 2: Set Off-Duty Messages

In the **Roster Setting** page, you can also set automatic messages for off-duty hours.

<figure><img src="https://605198658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP7nf2G1iCRba8EP7DawZ%2Fuploads%2F8mAiD0dzcX4OmZT67YXW%2Fimage.png?alt=media&#x26;token=0448e6be-de66-44e0-9683-6111cda9f19e" alt=""><figcaption></figcaption></figure>

* **Organization Off-Duty Message:** Applies to all teams.
* **Team Off-Duty Message:** Applies to a specific team and overrides the organization message if both exist.

These messages will be sent automatically when customers message during an agent’s off-duty period.

***

### Step 3: Upload Your Roster

Click **Upload CSV** to import your team’s schedule.

<figure><img src="https://605198658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP7nf2G1iCRba8EP7DawZ%2Fuploads%2Fr0Ql28D3gsOml5nOXbnY%2Fimage.png?alt=media&#x26;token=3ee4ff2f-e8a7-4e97-a242-a82fc37fac39" alt=""><figcaption></figcaption></figure>

* Click the **sample** format first to ensure correct data fields.

<figure><img src="https://605198658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP7nf2G1iCRba8EP7DawZ%2Fuploads%2FquphvAkn3TgypAVWdWIr%2Fimage.png?alt=media&#x26;token=793b20c0-c30c-4e11-8afb-c80492341fe7" alt=""><figcaption></figcaption></figure>

* The CSV must include:
  * **Agent Email**
  * **Date**
  * **Slot Name** (must match one of your defined duty slots)

Once uploaded, the roster will appear on the **Agent Roster Management** page.

<figure><img src="https://605198658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP7nf2G1iCRba8EP7DawZ%2Fuploads%2FAPORnmq3WC0zarVfNil2%2Fimage.png?alt=media&#x26;token=d1e2a2c2-7202-4b35-a483-05f137cd7754" alt=""><figcaption></figcaption></figure>

> 🔄 To make changes, simply upload a new CSV file with the updated schedule — the system will replace the previous data.

***

### Step 4: Assign Conversations with Off-Duty Indicators

* On the **Message Page**, when manually assigning a conversation, off-duty agents will be **marked** clearly.

<figure><img src="https://605198658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP7nf2G1iCRba8EP7DawZ%2Fuploads%2Fak3CxVsUvuOLK729pVo1%2Fimage.png?alt=media&#x26;token=dd7f2e52-f8dc-4af1-8768-4a8c6d2a39fe" alt="" width="375"><figcaption></figcaption></figure>

* You can still choose to assign a conversation to an off-duty agent if needed.

<figure><img src="https://605198658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP7nf2G1iCRba8EP7DawZ%2Fuploads%2FmsCTPRe0EfTMUoYFAEOO%2Fimage.png?alt=media&#x26;token=afae1e10-410b-4c9c-908e-52d058997ebc" alt="" width="375"><figcaption></figcaption></figure>

* On the **Chat Flow** page, in the **Advanced Assign Conversation** flow block, you can **set rules** to automatically **exclude off-duty agents** from assignment.

<figure><img src="https://605198658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP7nf2G1iCRba8EP7DawZ%2Fuploads%2FZifldEujST201vnDfyyA%2Fimage.png?alt=media&#x26;token=272a25ad-9470-4d04-934a-7dfee7b5f60f" alt="" width="289"><figcaption></figcaption></figure>

***

### Step 5: Automated Off-Duty Responses

If a conversation is already assigned to an off-duty agent:

* Any new incoming message from the customer will **trigger the off-duty message** (if one is set).

<figure><img src="https://605198658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP7nf2G1iCRba8EP7DawZ%2Fuploads%2FF7Gq6NSBLiJ920Oq61Rm%2Fimage.png?alt=media&#x26;token=33db1ac0-d51f-443f-a402-7afae5fbf5e5" alt="" width="375"><figcaption></figcaption></figure>

This ensures a seamless customer experience even outside of working hours.
