Optimize workforce operations › Extend capabilities › Configure › Customer Service Management

Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Setting up Scheduling in Workforce Optimization for Customer Service

Manage events using the team calendar. Create different types of event categories. Use scripted extension points to customize event types.

Parent Topic:Optimize workforce operations

Configure event categories for Manager Workspace

Add an event category. Create or update field configurations for events. You can also specify if an event category must be excluded when the shift coverage for agents are calculated.

Before you begin

Role required: sn_shift_planning.admin

The following event category configurations are available by default:

Work
Meeting
Training
Time Off
Break

Procedure

Navigate to All > Workforce Optimization for Customer Service > Scheduling > Event Categories.
In the Event Categories list, select New.
In the Name field, enter a name for the event category.
If you want to exclude this event category for agent coverage calculation, enable the Exclude from coverage check box.

In the Event field configuration dialog box, edit the following configuration as necessary:

Note: You can remove any property that does not apply to a type of event.

{
            "create": {                //Creates an event type form
                "attendees": {         //Adds the Attendees field       
                "mandatory": true,     //Sets this field as mandatory
                "readOnly": false,     //Sets this field as read-only
                "allowAllUsers": false //Allows you to only add users managed by the logged-in user; to add any user, set this value to true
                },
                "startDate": {    
                "mandatory": true,
                "readOnly": false
                },
                "endDate": {
                "mandatory": true,
                "readOnly": false
                },
                "additionalSelectors": [    //Add custom fields to the form
                {
                    "fieldLabel": "Select Shift", //Name of the field that displays on the form
                    "table": "sn_shift_planning_shift_plan", //Name of the table referenced by the field
                    "field": "name", //Any field from the selected table whose display values must be shown in the custom field
                    "value": "",
                    "mandatory": true,
                    "additionalQueryString": ""
                }
                ]
            },
            "edit": {                    //Edit an event type form
                "attendees": {
                "mandatory": true,
                "readOnly": false,
                "allowAllUsers": false
                },
                "startDate": {
                "mandatory": true,
                "readOnly": false
                },
                "endDate": {
                "mandatory": true,
                "readOnly": false
                },
                "additionalSelectors": [
                {
                    "fieldLabel": "Select Shift",
                    "table": "sn_shift_planning_shift_plan",
                    "field": "name",
                    "value": "",
                    "mandatory": true,
                    "additionalQueryString": ""
                }
                ]
            }
        }

Select Submit.

Create event types to display them on the team calendar

Create multiple events from the same category and add them to the team calendar.

Before you begin

Role required: sn_shift_planning.admin

Procedure

Navigate to All > Workforce Optimization for Customer Service > Scheduling > Event Configuration.
Select New.
On the form, fill in the fields.

Field	Description
Name	Unique name for the event type.
Priority Order	Priority of the event type that you want to exclude from the coverage. The higher the number means the higher the priority.For example, let's say you are attending a work event for four hours in a day. You have marked that time window as both a time off and as a meeting event type. If time off has a higher order of priority, then the application excludes that event type from coverage.
Color	Color that identifies this type of event in the team calendar.
Active	Option that when enabled, displays the event type on the calendar.
Category	Type of event, for example, meeting, break, or time off.

Select Submit.

Note: After an event type is assigned to a shift, that event type cannot be deleted.

Configure properties for schedule adherence and conformance

Configure schedule adherence properties to calculate the adherence and conformance of your agents so that you can improve the operational efficiency of your organization.

Before you begin

Role required: admin

About this task

The threshold settings for adherence and conformance indicate how many minutes early or late an agent can clock in or clock out to a scheduled work shift without being considered as non-adherent.

Procedure

Navigate to All > Workforce Optimization for Customer Service > Schedule Adherence > Settings

On the form, fill in the fields.

Field	Description
Enable Schedule Adherence	Calculation and information about the agents' adherence to the schedules.
Threshold for early checkin for planned shift (in Minutes)	Time that you can set for early check-in. This time is the acceptable time for an agent to start the work shift before the actual shift time. The default value is 60 minutes. For example, if an agent's planned work shift is 08:00 to 17:00 and the agent clocks in at 07:00, the threshold time allows flexibility and the agent isn’t considered as a non-adherent agent.
Threshold for adherence% of Time Worked Summary	Percentage that you can set for a threshold in adherence. The agents who don’t qualify to be above the defined threshold value (70%) are considered non-adherent agents.
Lower threshold conformance % of Time Worked Summary	Lower threshold percentage that you can set for flexibility in conformance. The agents who don’t qualify for the defined lower and upper conformance threshold values (80-120) are considered as non-conformant agents. The default value is 80%.
Upper threshold for conformance % of Time Worked Summary	Upper threshold percentage that you can set for flexibility in conformance. The agents who don’t qualify for the defined lower and upper conformance threshold values (80-120) are considered as non-conformant agents. The default value is 120%.
Default threshold time for clock-out event generation (in Minutes)	Default threshold time to generate an automatic clock-out event if an agent fails to clock out. The default value is 60 minutes. For example, if an agent's planned work shift is 08:00 to 17:00 and the agent fails to clock out at 17:00, the system waits for 60 minutes as the threshold time and generates an automatic clock-out event.

Select Save.

Monitor schedule adherence of your agents

Analyze conformance from time worked summary

Modify schedule adherence and conformance formulas by using extension points

Configure and tweak the schedule adherence and conformance formulas using scripted extension points so that you can customize them for your organization.

Before you begin

Role required: admin

About this task

Use the sn_shift_planning.ScheduleAdherenceExtPt extension point and create an implementation to configure the formulas. You can create multiple implementations. However, the implementation with the lowest order number is executed.

Procedure

Navigate to All > System Extension Points > Scripted Extension Points.
Search for sn_shift_planning.ScheduleAdherenceExtPt.
On the form banner, select the link here to edit the record.
To create your extension point script, select Create Implementation in the related links.
Modify the formulas for calculating the schedule adherence and conformance in the getAdherencePercentage and getConformancePercentage methods.

Image omitted: extension\_script\_adherence.png
Scripted extension point displaying the getAdherencePercentage and getConformancePercentage sections.

Select Update.

Result

The schedule adherence and conformance calculations are based on the formulas in the implementation.

Event type extension points in Workforce Optimization for Customer Service

Use extension points to call scripts for event categories such as meeting, time off, or work time.

To see a list of extension points that you can use for Workforce Optimization for Customer Service, navigate to System Extension Points > Scripted Extension Points. In the Extension Points list, open the sn_shift_planning.EventManagerextension point.

Use scripted extension points to integrate customizations without altering the core components in the application code. When customizing a base application, you implement the scripted extension points by creating the custom script includes and registering them against the scripted extension points.

Extension point name	Description
sn_shift_planning.EventManager	Implement this extension point to customize the logic for the event categories that you create.

You can use extension points to create events such as meeting, training, and time-off requests. For example, for extension point implementations, see the following extension instances in the Implementations related list:

Category	Extension Script
Meeting	AgentScheduleMeetingEventManager
Break	AgentScheduleBreakEventManager
Training	AgentScheduleTrainingEventManager
Time off	AgentScheduleTimeOffEventManager
Work	AgentScheduleWorkEventManager