Setting up Scheduling in Workforce Optimization for Customer Service

  • Release version: Australia
  • Updated March 12, 2026
  • 6 minutes to read
  • Manage events using the team calendar. Create different types of event categories. Use scripted extension points to customize event types.

    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

    1. Navigate to All > Workforce Optimization for Customer Service > Scheduling > Event Categories.
    2. In the Event Categories list, select New.
    3. In the Name field, enter a name for the event category.
    4. If you want to exclude this event category for agent coverage calculation, enable the Exclude from coverage check box.
    5. 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": ""
                      }
                      ]
                  }
              }
    6. 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

    1. Navigate to All > Workforce Optimization for Customer Service > Scheduling > Event Configuration.
    2. Select New.
    3. On the form, fill in the fields.
      Table 1. Event configuration form field
      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.
    4. 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

    1. Navigate to All > Workforce Optimization for Customer Service > Schedule Adherence > Settings
    2. On the form, fill in the fields.
      Table 2. Schedule Adherence properties form
      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.
    3. Select Save.

    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

    1. Navigate to All > System Extension Points > Scripted Extension Points.
    2. Search for sn_shift_planning.ScheduleAdherenceExtPt.
    3. On the form banner, select the link here to edit the record.
    4. To create your extension point script, select Create Implementation in the related links.
    5. Modify the formulas for calculating the schedule adherence and conformance in the getAdherencePercentage and getConformancePercentage methods.
      Scripted extension point displaying the getAdherencePercentage and getConformancePercentage sections.
    6. 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.
    Table 3. Extension points for event types
    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:
    Table 4. Extension scripts for creating events
    Category Extension Script
    Meeting AgentScheduleMeetingEventManager
    Break AgentScheduleBreakEventManager
    Training AgentScheduleTrainingEventManager
    Time off AgentScheduleTimeOffEventManager
    Work AgentScheduleWorkEventManager