The Custom Notification wizard in the Hub Services console guides you through the steps to create a notification, select the target audience, and create an actionable response. When you click Create in the wizard, the notification is sent to the target audience.

The notification templates that are available in the wizard are Actionable and Informational. See Notifications Types That Can Be Sent from Workspace ONE Hub Services for a description of the templates.

Guidelines for Creating User-Friendly Notifications

Notifications cards include a header and message. The notification can also include buttons that make the message actionable. When you compose a message, consider the following good practices.

  • Write short titles to catch the users' attention. Make the description message clear and concise.
  • No more than three actions can be presented on the notification card. One or two actions are the ideal user experience.
  • When you create a label for your action button, keep it short to avoid truncation.
  • If the user can repeat the action, enable the Repeatable radio button in the Content page. When the radio button is disabled, users can perform the action once.
  • The action buttons appear as either primary or secondary. The primary action button appears before a secondary action button.

In the default view of a notification message, a logo image appears in the left corner of the notification. You can change this image when you create a custom notification. You can upload an image or add a URL address to an image you want to appear on the card.

Selecting the Target Audience

You can target custom notifications to specific audiences or you can send the notification to all employees in your organization. You can assign the following audience types.

Audience Types Description
All Employees Notifications can be sent to all employees listed as users in the Workspace ONE Access service.
All Devices Notifications can be sent to all devices configured in your Workspace ONE UEM environment, regardless of organization groups.
Organization Group Organization groups (OG) in the Workspace ONE UEM console are created to group individual organizations in your corporate structure, geographical location, business unit, or department. You can select a specific organization group in Workspace ONE UEM in which to send the notification.
Smart Group Smart groups are customizable groups within Workspace ONE UEM that determine which platforms, devices, and users receive an assigned application, book, compliance policy, device profile, or provision. You can select a smart group in Workspace ONE UEM in which to send the notification.
Platform You can select a specific platform type to send a notification. The platforms are iOS, Android, macOS, and Windows.
Users Group Groups in the Workspace ONE Access service are imported from your Active Directory or are created as local groups in the Workspace ONE Access console. You can select a group in Workspace ONE Access in which to send a notification.

If your organization implements the pre-hire onboarding process, you might not want to send certain types of notifications to the pre-hire audience and groups. To exclude users in the pre-hire groups from receiving a notification, when you configure the target audience on the Definition page, select the Exclude Pre-hires check box.

Actions That Can Be Added to Notification Messages

At the most, three actions can be presented on the notification card. When you create an action, a button appears with the text you configured. The ideal user experience is to have one or two actions. Any more than three can degrade the user experience as the buttons are in a horizontal line on the card, and the card can be too narrow to display the action buttons correctly.

Three action types can be selected.

  • Open In. When you select the Open In action, you then enter the URL that opens when the button is clicked.
  • API. When you select API, you then select the method to use to interact with the data being addressed in the notification.
    API Task Description
    GET Use GET to retrieve data from a specified resource. The data is not modified. Enter the URL of the resource that supplies the data.
    POST Use POST to send data to a specified URL to insert data in a resource. Enter the URL where the data is sent.
    PUT Use PUT to send data to a specified URL to update a resource. Use PUT when user can only send the data one time.
    PATCH Use PATCH to allow users to modify their data on the resource.
    DELETE Use Delete to let the user delete data from the specified URL.
  • API with Parameters. When you select API with Parameters, in addition to selecting the method and API endpoint, you can add specific parameters and a value for the parameters.

    For more information about parameters, go to the Workspace ONE Notification service API page. The Notifications Service reference guide is available from the Documentation tab.

Adding Attachments

You can add up to 10 attachments to notification that you create. The individual file size cannot exceed 1 MB.

Attachments to notifications can be viewed in the web portal from a browser. Attachments cannot be viewed on iOS or Android devices.

Adding Banner Images, Banner Videos, and Links to Notifications

You can add a banner that contains an image or a video to notifications, and you can add up to 10 links to the notification. To add images, videos, or links to the notification, you use the Workspace One Notifications Service API to create the banner with images and videos or to add links to the notification. For information about how to add these to notifications, see the Guidelines for creating user friendly notifications section in the Workspace ONE Notification Services API guide.

Notification Delivery Time

When you use the wizard to create a notification, when you click Create, the notification is created and sent.

The time it takes for the target audience to receive a notification depends on various factors. These factors include the Workspace UEM Mobile Device Management API response time and the total number of users and devices targeted for the notification. On an average, you can expect 10,000 recipients to receive the notification within 45 minutes.