Model: view/MicrosoftSubscriberQas

Quick Subscriber

This procedure displays and updates a Microsoft user, and moves the user to the correct site, with all configuration and licensing applied.

Note

Quick Subscriber simplifies onboarding with the use of Quick Add Groups (QAGs). QAGs 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 updating a user via Quick Subscriber, 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:

Sync in the MS Teams user to the Customer level

Set up the site defaults and QAG with the appropriate configuration and licenses.

Perform these steps:

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

Choose the relevant site.

On the Quick Subscriber page:

Required. In the Username field, select the user to populate fields on the page.

Note

This workflow is intended for Microsoft-only users. When choosing a hybrid user with Cisco-Microsoft services, you'll need to work with this user via the Hybrid multi vendor actions. The Hybrid Status Message field displays the user's hybrid status. See Cisco-Microsoft Hybrid Subscribers
To include users higher in the hierarchy in the Username drop-down, select Include users at higher hierarchy.
To send a subscriber a welcome email once they're set up, select Send welcome email.
Note
- You must have a SMTP server set up to send emails.
- The read-only User status field displays the user's current status; that is, whether they are online, in staging, or not yet provisioned.
- The value in the read-only Feature type field defines whether this Microsoft user has MS Teams with or without the voice service. The user has MS Teams and voice service when feature type displays both Teams and PhoneSystem
Required. From the Quick Add Group drop-down, select the relevant Quick Add Group (QAG) (licenses the user and applies settings defined in the QAG).

Quick Add Groups support group licensing for MS 365 groups, so that subscribers can be licensed according to group membership. Refer to:
- Microsoft Licenses
- Quick Add Subscriber Groups
Note

If an existing user is holding a particular license is assigned a Quick Add Group where the group license provides additional services (for example, from existing IM services only to Voice services), the user license is updated as follows:
- the user is either placed in the staging queue (see: Microsoft Subscriber Staging) until the license update is synced and then provisioned with services, or
- the user is provisioned without a staging process.
From the Line URI drop-down, choose a number; alternatively, select Use next available line to automatically populate the Line URI field with the next available line.
Note
- The Line URI and Use next available line fields display only when Feature Type is PhoneSystem, or Manage Licenses is enabled (via the MS Teams tab in the site default docs).
- The Enterprise Voice Enabled option has been deprecated since PowerShell V4.0.0. Setting Enterprise Voice Enabled is no longer required. Thus, to enable a licensed user for Enterprise Voice in Quick Subscriber, assign a line (choose a number from Line URI) and ensure that the Feature Type field displays value Teams, PhoneSystem. Alternatively, choose a Quick Add Group that has a configuration template set up to enable Enterprise Voice for licensed users, regardless of whether a line is assigned.
  
  If you wish to disable Enterprise Voice for this user (or enable it again in future), you can do so via the user's account settings (relation/MicrosoftSubscriber). See Microsoft Subscribers
- The Line URI drop-down displays available lines (staged lines are excluded), with the vendor and line type shown in brackets, for example, Microsoft - CallingPlan. Lines types may be: Direct Routing, Calling Plan, or Operator Connect
- When choosing a line, the INI will eventually update to this number.
- The default for Use next available line is False (disabled).
  
  When selecting Use next available line:
  - If the user does not already have a line, they are assigned the next available line.
  - If the user has an existing line, this line is replaced by the next available line.
  - Staged numbers are considered unavailable and will not be used.
Optionally, from the Tenant dial plan field, choose a tenant dial plan.

Note

Choosing a tenant dial plan different from the default set up in the site defaults (SDD) overwrites the default. If you don't choose an option for this field, the tenant dial plan set up in the SDD applies.
From Calling Line Identity, assign a calling line identity for this user, or use the value that comes from the QAG.
Click Save.

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

Note

The user is placed in the staging queue (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).

Starting with VOSS Automate v21.3-PB1, you can, with immediate effect, un-stage a user waiting in the staging queue. This executes a direct sync to the Microsoft cloud to determine whether the user has appeared in MS Teams after their licensing update.

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:
- The user's number is allocated
- Policies are assigned

Related Topics

Microsoft Subscribers in the Core Feature Guide

Microsoft User Move Configuration in the Core Feature Guide

Flow Through Provisioning in the Core Feature Guide

Subscriber Staging (Microsoft Users) in the Core Feature Guide

Microsoft Licenses in the Core Feature Guide

Model Details: view/MicrosoftSubscriberQas

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
User Details		Group Assigned by FDP	Field Name: User Details Type: Object
	Username *		Field Name: User Details.username Type: String
	Include users at higher hierarchy	Includes users above site level when searching Default: True	Field Name: User Details.lookUpForUser Type: Boolean Default: True
	User status		Field Name: User Details.msteams_user_status Type: String
	Hybrid Status Message		Field Name: User Details.mvs_hybrid_status_message Type: String
	First name		Field Name: User Details.first_name Type: String
	Last name		Field Name: User Details.last_name Type: String
	Title		Field Name: User Details.title Type: String
	Department		Field Name: User Details.department Type: String
	Email address		Field Name: User Details.email Type: String Pattern: ^([^.@]+)(\.[^.@]+)@([^.@]+\.)+([^.@]+)$ Format:* email
	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: User Details.send_email Type: Boolean
	Phone number		Field Name: User Details.phone_number Type: String
	Mobile phone		Field Name: User Details.mobile_phone Type: String
	Feature type		Field Name: User Details.feature_type Type: String
	Quick Add Group *		Field Name: User Details.qagroup_name Type: String Target: data/QuickAddGroups Target attr: group_name Format: uri
	Use next available line	Use the next available line from the inventory.	Field Name: User Details.automatic_line Type: Boolean
	Line URI		Field Name: User Details.line_uri Type: String
	Tenant dial plan		Field Name: User Details.tenant_dial_plan Type: String
	Calling line identity		Field Name: User Details.calling_line_identity Type: String
	Online voice routing policy		Field Name: User Details.online_voice_routing_policy Type: String
Existing Services		Group Assigned by FDP	Field Name: Existing Services Type: Object
	Current Tenant dial plan		Field Name: Existing Services.current_tenant_dial_plan Type: String
	Current Calling line identity		Field Name: Existing Services.current_calling_line_identity Type: String
	Current Online voice routing policy		Field Name: Existing Services.current_online_voice_routing_policy Type: String