Model: data/MicrosoftSubscriberQasStaging

Quick Add Subscriber

To access the latest documentation, go to Documentation and Resources at: https://voss.portalshape.com

This procedure adds a single Microsoft user via quick add subscriber (QAS), and moves the user to the correct site, with all configuration and licensing applied.

Note

The Quick Add Subscriber (QAS) feature simplifies onboarding with the use of Quick Add Groups (QAGs). Quick Add Groups are service and policy assignment templates that allow you to pre-configure how calling rights, policies, and services are assigned to users based on their user role. When adding a user via QAS, you select the relevant QAG, and the automated workflows in VOSS Automate handles the required cloud sync and licensing. The workflow also removes the need for an administrator to check the licensing, or to flag the required policies and settings individually, and then to wait for the cloud to sync in.

Prerequisites:

The Microsoft Teams user must be synced in at the customer level in VOSS Automate.

The site defaults and Quick Add Group (QAG) must be set up with the correct model filter criteria rule to allow the workflow to move the user to the site with the appropriate configuration and licenses.

Perform these steps:

Go to (default menu) MS Subscriber Management > Quick Add Subscriber.

From the organization picker, choose the relevant site.

On the Quick Add Subscriber page:

In the Username field, select the user.
Select Include users at higher hierarchy to show these users in the Username drop-down.
Select Send welcome email (if you wish to send the subscriber a welcome email once they've been added and configured via QAS, and if you have a SMTP server set up).
Select Enterprise Voice Enabled to display the Line URI field, where you can assign a line.
From the Line URI drop-down, select a number.

Note

Only available numbers display. The INI will eventually update to this number.
From Calling Line Identity, assign a calling line identity for this user.
From the Quick Add Group drop-down, select the relevant Quick Add Group (to license the user to be enabled for telephony enterprise voice).
Click Save.

Go to MS Subscriber Management > Subscriber Staging to view the user in the staging queue.

VOSS Automate places the user in staging (with all configuration applied), while waiting for the cloud to sync in. Once the licensed user appears in the Microsoft Teams portal, a second, targeted sync is triggered, which searches only for staged users (not all users from the tenant).

Once the sync completes, the user becomes a fully provisioned subscriber, and the number is flagged as used. The subscriber receives a welcome email (if you've chosen this option, and you have a SMTP server configured).

Verify that the subscriber is configured and licensed:

Go to (default menu) Subscriber Management > Subscribers.

Note

The Located At column on the Subscriber list displays the hierarchy location of each subscriber added to the system, for example, customer or site.
Click on the subscriber to open the Subscribers[name] page.
On the MS Licenses tab, view the subscriber's license details.
On the MS Teams tab, verify the following:
- Enterprise voice is enabled
- The user's number is allocated
- Policies are assigned

Related Topics

Microsoft Overview in the Core Feature Guide

Microsoft User Move Configuration in the Core Feature Guide

This model is used to store Microsoft QAS data when a MS Teams user does not exist yet. The data will be like a queue and a seperate workflow will run periodically and delete the data.

Model Details: data/MicrosoftSubscriberQasStaging

An asterisk * in the title indicates the field is mandatory.
If a field has a default value, it is shown in the Description column.
If the field type is an array, the Field Name has a .[n] suffix, where n is the array index placeholder.
Object and array field names are listed to provide context. If a field belongs to an object or an array, the full field name is shown in dot separated notation.

Title	Description	Details
Username *	Username of User	Field Name: username Type: String
First name		Field Name: first_name Type: String
Last name		Field Name: last_name Type: String
Send welcome email	Send Email to user using predefined HTML Email Template. Email template used is 'Quick Add Subscriber'. To enable email feature set 'Allow welcome email to be sent to user after Quick Add Subscriber' in Global Settings.	Field Name: send_email Type: Boolean
Line URI		Field Name: line_uri Type: String
Calling line identity		Field Name: calling_line_identity Type: String
Online voice routing policy		Field Name: online_voice_routing_policy Type: String
Hosted voice mail		Field Name: hosted_voice_mail Type: Boolean
Enterprise voice enabled		Field Name: enterprise_voice_enabled Type: Boolean
Quick Add Group		Field Name: qagroup_name Type: String
Timestamp		Field Name: timestamp Type: String