Service Level Preferences

This feature is in Public Beta and available in @twilio/flex-ui@1.27.0 and later. In order to be able to configure the preferences, the Real-Time SLA Metrics features should be enabled in Feature Settings under the Beta tab. Starting in 1.30.2, you can access the Metrics page from the Flex Admin dashboard under Service Levels.

Users with the admin role can use Service Level Preferences (SLPs) to customize how metrics in the Real-Time Queues View are calculated. Custom preferences can be set for each queue and each channel in a queue, and this enables you to align metrics calucation to your unique business KPIs.

Service Level Preferences

To access the Service Levels page, select Configure Service Levels from the Flex Admin page.


The following SLPs are available:

  • Daily Metrics Reset — The time of day and time zone that determine when the metrics in the Today time frame are reset. You can use a geographical time zone that takes local time changes into consideration. For example, Daylight Savings Time. This preference can be set individually for every queue.
  • Service Level Threshold — The time the customer will spend in a queue to be counted as handled within the Service Level Agreement (SLA). All customers that connect to an agent sooner than this threshold are counted as handled within the SLA. All customers that wait longer than this threshold are counted as handled outside of the SLA. This preference can be set individually for every queue-channel combination.
  • Short Abandons — The time the customer will spend in a queue before giving up without impacting the SLA. This preference can be set individually for every queue-channel combination.

Changes to Daily Metrics Reset impact when the next reset occurs. All metrics in the Today time frame will continue to be added to the current statistic until the new time that you set is reached. This means that the Today time frame can show more than 24 hours of data if the reset time is moved to a later time in the day.

Changes to Service Level Threshold and Short Abandons SLPs apply to customers that are still waiting in a queue after the change is saved. We recommend to change these preferences before or after a shift. Changes during a shift may reduce the clarity of real-time reporting.

Global service levels

Global service levels display at the top of the Service Levels page. Flex uses global service level preferences for any queue and queue-channel combination that does not have custom preferences set up. All newly created queues and channels use global service levels by default.

We recommend to set your global service level preferences to values that are applicable for most of your queues and channels. You can then use Custom service level preferences to define exceptions.

Modify global preferences

  1. From the Service Levels page, select Edit in the top-right corner:
    Service Level - Global
  2. Implement your changes then select Save.
  3. Ensure that you understand the changes in reporting, especially if you make the changes during a shift. Click Confirm:
    Confirm Save Global Preferences

Set custom Service Level Preferences

You can set custom SLPs for a specific queue or for any queue-channel combination. Once set, custom SLPs are shown on the Service Levels page. Queues and queue-channel combinations that do not have a custom preference are marked Global.

  1. From the Service Levels page, select a queue in the table.
  2. Click Set custom time to customize the Daily Metrics Reset for the queue. We recommend setting the time of day to a few hours before the shift starts for this queue. The time zone is typically set to either the agent location or the location of customers you are serving with your contact center.
  3. Click Add custom levels to customize thresholds for Service Level Thresholds and Short Abandons in this queue. You can set limits for each channel in the queue. Channels that do not have custom settings use global preferences:
    Queue Level Preferences - Default
  4. Click the Remove button on any custom preference that you want to remove and use the global setting instead:
    Service Level Preferences - Queue
  5. Click Save to apply all changes.
Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.

Thank you for your feedback!

Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

Sending your feedback...
🎉 Thank you for your feedback!
Something went wrong. Please try again.

Thanks for your feedback!