Skip to content

Designs for paging

Problem to solve

As part of the larger initiative, On-call Schedule Management, users need to be paged when they receive an alert when they are on-call. In the MVC, we used email notifications to page on-call responders. We need to expand this functionality to include paging via text and calls. We are going to integrate with Twilio to provide this communications service

Intended users

User experience goal

User should be able to complete the following tasks:

  • Configure an integration with Twilio
  • Set up escalations in their own policy (e.g. text me, if I do not respond in 5 minutes, call me)

Proposal

There will be two pieces here:

1. Configure an integration with Twilio

We'll allow the user to set up an integration with Twilio. We'll also link them to the user notifications page so they can update their contact details and add in a personal paging policy.

Paging settings section - collapsed Paging settings section - expanded
Config_-_collapsed Config_-_expanded

2. Extending user notification settings to include additional options for paging

We'll introduce a tab on the user notification settings page to hold all of the additional paging configuration items.

Expected workflow:

  1. User opens the paging settings tab. They see the email address associated with their GitLab account is automatically populating the email field. By default, they will also see information under Personal Paging Policy clarifying that, for all new alerts, they will immediately get an email.
  2. The user optionally adds SMS and voice details and clicks to "save changes". Saving will automatically add the additional notification options to the table under Personal paging policy and set the time for notification to "immediately".
  3. User can edit the notification times/methods by clicking the edit policy button. That button will prompt a modal where people can update the times for utilizing the different notification options.
  4. User clicks save in the modal, and sees the times for utilizing the different paging notification options updated in the table.

Visually, that will look like this:

User views the paging settings page and sees the default paging options SMS and voice details added Edit paging policy modal Modal dropdown options Updated paging policy
Personal_notification_preferences_-_Default Personal_notification_preferences_-_all_options_added Modal Modal_-_2 Personal_notification_preferences_-_all_options_added-1

Note: paging during specific time periods is out of scope for the MVC, as is having a flag in the country code dropdown. Icons for SMS and voice still need to be created and added to the GitLab SVG project.

Figma file

Edited by Amelia Bauerly