[Index]
To access the latest documentation, go to Documentation and Resources at: https://voss.portalshape.com
Quick Add Subscriber (QAS) provides a single page where you can:
QAS supports many user types, including:
If the Default Self-service Language is set on the SDD, users will be assigned the corresponding Self-service language.
A Quick Add Group (QAG) is a collection of templates that configure the subscriber features, and is mandatory when adding a QAS.
Note
For self-provisioned phones to show as being associated with a subscriber, perform a Cisco Unified Communications Manager Data Sync after setting up a self-provisioned phone.
Any modifications of the added subscriber and associated services are done from the respective service menu items.
The Quick Add Subscriber form allows you to enable user services, such as voicemail, extension mobility, single number reach, and conferencing (meetings) and collaboration (messaging) services (such as Webex Teams). See also, Webex Teams Quick Add. The QAS page only displays services that are included in the entitlement profile you select on this page. For example, if the entitlement profile does not include voice services, the checkboxes for Voice, Jabber, and Self Service ID won't appear on the page. The selected entitlement profile also filters options available in the Phone Type drop-down (showing only devices enabled in the entitlement profile).
For the Voicemail service:
While the Admin Portal hides controls if services are not available, API and Bulk Load operations have Provisioning Workflow checks for the presence of the Default CUC User Template in the SDD and a configured WebEx Server in the NDL before the selected services can be added.
If no Unified CM has been configured at the hierarchy that the Subscriber belongs, then Quick Add Subscriber bulk load transactions and API calls will show a warning message: No Call Manager has been configured.
Webex Teams Quick Add
Selecting the Webex Teams checkbox on the QAS page displays the Webex Teams User Template drop-down, where you can select a Webex Teams User Template to apply to the user.
If you want customized values, clone the Webex Teams User Template (Customizations > Configuration Templates) and edit as required. The Webex teams User Template for CUCM Calling provides for a Settings group of controls for the specification of Calling Behaviour and provisioning of Jabber devices if relevant to the calling behaviour.
Quick Add Subscriber provides a single page where you can:
Quick Add Subscriber supports many user types, including:
If the Default Self-service Language is set on the SDD, Users will be assigned the corresponding Self-service language.
Quick Add Group is a collection of templates that configure the subscriber features. Quick Add Group is required to use Quick Add Subscriber.
Note
To add subscribers using Quick Add Subscriber, a default user template called "voicemailtemplate" must exist on the Unified CM. It is possible, through Dial Plan management, to change this default by editing the Default CUC User Template value in the Site Defaults reference.
For self-provisioned phones to show as being associated with a Subscriber, perform a Cisco Unified Communications Manager Data Sync after setting up a self-provisioned phone.
Any modifications of the added subscriber and associated services are done from the respective service menu items.
The input form on the user interface shows a number of check boxes to enable user services such as Voicemail, WebEx, Single Number Reach, Webex Teams (Webex Teams Quick Add), etc. If the Entitlement profile selected on the Quick Add Subscriber form does not include a particular service, then the check boxes for that service is not available. For example, if the selected Entitlement profile for the Subscriber does not include Voice services, then the check boxes for Voice, Jabber, and Self Service ID will not show on the form. The choice of Entitlement profile will filter the available options in the Phone Type drop-down to show only the enabled devices in the Entitlement profile.
For the Voicemail service:
While the GUI hides controls if services are not available, API and Bulk Load operations have Provisioning Workflow checks for the presence of the Default CUC User Template in the Site Defaults Doc and a configured WebEx Server in the NDL before the selected services can be added.
If no Unified CM has been configured at the hierarchy that the Subscriber belongs, then Quick Add Subscriber bulk load transactions and API calls will show a warning message: No Call Manager has been configured.
Webex Teams Quick Add
If you select the Webex Teams check box, the Webex Teams User Template drop-down is exposed. From this, you can select the Webex Teams User Template to use for the user. This selection overrides the default user template referenced in the Quick Add User Group associated to the user. If a Webex Teams User Template is not selected from the drop-down, selection falls back to the Webex Teams User Template referenced in the associated Quick Add User Group. If you want customized values, clone the Webex Teams User Template (Customizations > Configuration Templates) and edit as required.
CISCO
Overview
Quick Add Subscriber (QAS) for Cisco Unified Communications Manager (CUCM) provides a single page where you can add a CUCM user as a subscriber with a line, and a voicemail and Webex account, and provision the subscriber with services such as voice, extension mobility, single number reach (SNR), and conferencing and collaboration services.
Important
QAS is a simple, generic method for provisioning subscribers that applies single values from configuration templates (via Quick Add Groups), and the site defaults.
For more complex provisioning requirements, such as adding route partitions or multiple values for other service fields (such as two or more lines), use VOSS Automate's advanced subscriber management functionality (default menus: Subscriber Management > Subscriber), or bulk loaders. For example, you could use QAS to add subscribers with only the first line on phones, then use advanced subscriber management to add the second line to the phone.
For details around how QAS handles the application of a Line configuration template associated with a selected Quick Add Group (QAG) when adding or updating a subscriber, see Shared Lines.
Supported User Types
QAS for CUCM users supports several user types, including:
Note
If the default Self-service Language is set on the site default docs (SDD), users are assigned the corresponding Self-service language.
Related Topics
Global Settings in the Core Feature Guide.
Introduction to Entitlement in the Core Feature Guide
Configure Quick Add Subscriber
To create or configure users, to enable users with services, or to associate users with devices, configure the following items on the system:
Configuration | Description |
---|---|
|
Configure the following servers in VOSS Automate:
|
|
Provider deployment only. Configure a dial plan at both the customer and site hierarchies. |
|
Deploy voicemail service with a pilot number created and associated to a site in VOSS Automate (via Services > Voicemail). This step is required to create a "Default CUC Subscriber Template" (via Site Defaults > CUC Defaults. The template is required to create CUC voicemail users. |
|
Configure a Webex Server in VOSS Automate to deploy any Webex users provisioned through QAS. Set a password for Webex users in the Site Defaults. |
Enabling Services in Quick Add Subscriber
When adding a subscriber via Quick Add Subscriber (QAS), you can enable user services, such as voicemail, extension mobility, single number reach, conferencing (meetings), and collaboration (messaging) services (such as Webex App).
The QAS page displays services included in a selected entitlement profile (if entitlement profiles are used). For example, if the entitlement profile excludes voice services, the checkboxes for Voice, Jabber, and Self Service ID won't appear on the page. The selected entitlement profile also filters options available in the Phone Type drop-down (showing only devices enabled in the entitlement profile).
Note
It is possible to use QAS to add a subscriber without an entitlement profile. For example, entitlement profiles may not exist on the deployment, or they may not be associated with the subscriber. In this case, a phone type, for example, may still be associated with the subscriber via the Quick Add Group (QAG).
For the Voicemail service:
Configuration settings are only available if the site's SDD has a default value on the CUC Defaults tab for the Default CUC Subscriber Template.
The default value (voicemailusertemplate) should already exist on the CUCM and is automatically populated on an HCS system when a voicemail pilot is created.
A CUC device must be configured at the related Network Device List (NDL), at site level.
If the selected QAG specifies any CFT entries for UserPin or UserPassword, these are applied. Otherwise, the values from the User Template defined on CUC apply. For default CFTs, see: Quick Add Subscriber Group Default Model.
While the Admin Portal hides configuration settings for unavailable services, API and bulk load operations have provisioning workflow checks that check for the presence of the Default CUC User Template in the SDD and a configured Webex server in the NDL, before the selected services can be added.
A CUCM (call manager) must be configured at the subscriber's hierarchy. If this does not exist, the QAS bulk load transactions and API calls display the following warning: No Call Manager has been configured
Add a User via Quick Add Subscriber
This procedure adds a CUCM user via Quick Add Subscriber (QAS).
Before you start
To choose phones by their description or description and line, configure the Phones tab in the Global Settings for displaying additional information.
The default user template (voicemailusertemplate) must exist on CUCM. You can update the default by editing the default CUC User Template value in the SDD.
Configure Quick Add Groups. See Quick Add Subscriber Groups
Note
For details around how QAS handles the application of a Line configuration template associated with a selected Quick Add Group (QAG) when adding or updating a subscriber, see Shared Lines.
If required, expose device pools and Class of Service (CoS) in QAS. See Expose Device Pools and Class of Service in Quick Add Subscriber
Ensure the site defaults are correctly configured.
To add a user in QAS
In the Admin Portal, go to (default menus) Subscriber Management > Quick Add Subscriber.
On the User Details tab, configure the following:
Note
Select the username.
Note
Fill out a first name and last name.
Note
First name is mandatory only if you're provisioning the user with a Webex account. You can set only one Webex account per user.
Fill out the user's email address, and define whether to send the user a welcome email.
Note
The Send welcome email checkbox displays once you add an email address, but only if you've configured and enabled the following:
A welcome email is sent to the subscriber email address using the configured "Quick Add Subscriber" HTML email template that applies to the hierarchy. See Email.
Fill out a password and PIN.
Choose an entitlement profile, if one exists, to associate with the subscriber you're adding.
Choose a Quick Add Group (QAG).
Note
You can configure Quick Add Subscriber Groups via the Quick Add Subscriber Groups menu, or use the default group.
Choose a device pool.
Click the Plus (+) icon at Lines to choose a directory number. Alternatively, select Use next available line to automatically populate the Directory Number field with the next available line. The default for Use next available line is False (disabled).
Note
You can create a directory number in CUCM in two ways:
When creating a voicemail or voicemail line using QAS, the Directory Number Used field is set to "true" in the directory number inventory (Subscriber Management > Directory Number Inventory.
A directory number created without any device associations (for example, a voicemail line), is tagged under Subscriber Management > Lines as 'DN created without device from QAS.'
Provision relevant services:
Service | Description |
---|---|
Voice | Provisions the voice service. Since you can create multiple devices for a user, this checkbox is always available. Selecting the Voice service displays these additional fields:
Choosing alternative options in these fields overrides values set up in the Quick Add Group (QAG), configuration template (CFT), site defaults document (SDD), or any other backend (read-only) CFTs. If the QAG does not specify a phone template, or if the specified phone template has blank values for the phone fields, the phone field values are pulled from the SDD. To avoid conflicting QAS settings, it is recommended that you configure settings on the QAS form in the following order:
|
Extension Mobility | Provisions extension mobility. Only one extension mobility profile per user, so the checkbox displays only until you create an extension mobility profile. |
Voicemail | Provisions voicemail service. |
Service | Description |
---|---|
Single Number Reach | Provisions single number reach (SNR) service, and allows you to specify the SNR mobile number. If a mobile number is already configured for a subscriber, it is used to pre-populate the Mobile Number field when adding SNR for that subscriber. You can enter a different mobile number for SNR, if required. Ensure you do not add any spaces or special characters to the number. The SNR mobile number can be the same as the user's number that displays via (default menus User Management > Users). |
Jabber / Dual-Mode Device | Provisions Jabber / Dual-mode device service, and allows you to add Jabber and Dual-Mode devices. You can associate multiple Jabber and Dual Mode devices to a user. Jabber and Dual Mode devices get the first line assigned to them (specified in QAS). |
Enable self-provisioning | Defines whether to enable self-provisioning for this user, and allows you to choose the relevant self-provisioning user profile. When enabled, phone lines are added using the Universal Line Template (ULT) referenced in the selected self-provisioning user profile. When adding a user with lines but no devices, or when adding a user with devices and lines, enabling self-provisioning here automatically sets the CUCM User Primary Extension to the QAS line pattern and ULT route partition. The available self-provisioning user profiles are those found in (default menus) User Management > Self Provisioning > User Profile (and can be seen in the site defaults for the site). You can change this default, if required. |
Save your changes. The subscriber is created.
If you've provisioned SNR (single number reach), select the Existing Services tab, then verify that the Single Number Reach field displays the SNR profile name, which is the user name, followed by "-RDP". For example: jsmith-RDP.
Note
Add Webex App Service using Quick Add Subscriber
Note
When using QuickSubscriber to provision WebexApp services, the SiteDefaultsDoc - User Defaults tab values should be set to either:
or
Selecting the Webex App checkbox on the QAS page displays the Webex Teams User Template drop-down, where you can select a Webex Teams User Template to apply to the user.
If you want customized values, clone the Webex Teams User Template (Customizations > Configuration Templates) and edit as required. The Webex Teams User Template for CUCM Calling provides for a Settings group of controls for the specification of Calling Behavior and provisioning of Jabber devices if relevant to the calling behavior.
Add a Contact Center Agent using Quick Add Subscriber
You can use Quick Add Subscriber to create a Contact Center (UCCX) agent.
The Contact Center Agent check box becomes visible if:
If the check box is selected:
A Contact Center Agent Profile drop-down list is available to select an agent profile.
Note
The Contact Center Agent Profile needs to be created before adding the Contact Center Agent from the Quick Add Subscriber feature.
The agent profile will determine the team, resource group and skills assigned to the newly created agent. See: Agent Profiles.
The Agent Extension can be selected.
The extension will be a list of specified Lines, in other words, the administrator must specify the Line to be created or reused before selecting the Contact Center check box.
The Agent Device Type can be selected: either Extension Mobility or Phone:
An IPCC extension is automatically managed for the CUCM user associated with the Contact Center agent.
Quick Add Subscriber Device Pool
When adding a subscriber via Quick Add Subscriber (QAS), you can associate a device pool to the subscriber's newly associated devices or services (other than the device pool provided in the Site Defaults Doc or referenced configuration template in the Quick Add Group).
A device pool contains system, device, and location-related information, and is mandatory when adding a subscriber using QAS.
A device pool can be referenced by:
Device pool and Site Defaults Doc
The device pool referenced in the SDD ensures that a subscriber's devices are always associated to a device pool. If there is no device pool referenced in either the QAG or Admin Portal drop-down (see below) the value defaults to the SDD.
Device pool and Quick Add Subscriber Group (QAG)
The device pool referenced by a Configuration Template (CFT) in the QAG takes precedence over the device pool referenced in either the SDD or the Admin Portal drop-down (if exposed). See Quick Add Subscriber Groups for details.
Device pool and Admin Portal
An administrator can expose a Device Pool drop-down on the QAS page on the Admin Portal by editing or cloning the Field Display Policy. See Expose Device Pools and Class of Service in Quick Add Subscriber. The Device Pool drop-down allows an administrator to overwrite the value in the SDD by selecting a custom device pool from the drop-down list. The options available in the list are the site-level device pools if they are available, otherwise it displays all device pools available at customer level (NDLR aware).
Note
When exposing the Device Pool drop-down, the administrator must remove the value in the Device Pool field of the CFT referenced in the QAG, that is, the field must be blank. This is done to ensure that the value in the CFT does not overwrite the custom value in the drop-down.
The CFTs and their target models for which the device pool name can be made blank to allow the Portal to drive the device pool selection include:
Quick Add Subscriber Class of Service
With Quick Add Subscriber (QAS), you can associate Calling Search Space (CSS) values to a subscriber's newly associated lines, devices, or services (other than the CSS's provided in the Site Defaults Doc or referenced configuration template in the Quick Add Group), by selecting a Class of Service (CoS).
A Class of Service (CoS) allows you to specify a Calling Search Space (CSS) for devices and lines. A CSS is mandatory for lines and devices when adding a subscriber using QAS.
A CSS can be referenced by:
Class of Service and Site Defaults Doc
The Calling Search Space values referenced in the SDD ensure that a Subscriber's lines and devices always have a Calling Search Space associated to it. If there are no Calling Search Space values referenced in either the QAG or via the Class of Service field in the Admin Portal drop-down (see below) the value defaults to the SDD.
Class of Service and Quick Add Subscriber Group (QAG)
The Calling Search Space values referenced by a Configuration Template (CFT) in the QAG take precedence over the Calling Search Space values referenced in either the SDD or the Class of Service via the Admin Portal drop-down (if exposed). See Quick Add Subscriber Groups for details.
Class of Service and Admin Portal
An administrator can expose a Class of Service drop-down on the QAS page on the Admin Portal by editing or cloning the Field Display Policy. See Expose Device Pools and Class of Service in Quick Add Subscriber. The Class of Service drop-down allows an administrator to overwrite the Calling Search Space values in the SDD by selecting a custom Class of Service from the drop-down list. The Class of Service, in turn, contains a custom Calling Search Space for lines and devices, respectively. The options available in the list are the customer-level Class of Service instances, as created by the relevant administrator.
Note
When exposing the Class of Service drop-down, the administrator must remove the values in the Calling Search Space fields of the CFT's referenced in the QAG, that is, the field must be blank. This ensures that the value in the CFT does not overwrite the custom Calling Search Space value as defined in the selected Class of Service.
The CFTs and their target models for which the Calling Search Space name can be made blank to allow the Portal to drive the Calling Search Space values include:
Expose Device Pools and Class of Service in Quick Add Subscriber
This procedure exposes the Device Pools field and Class of Service (CoS) field on the Quick Add Subscriber (QAS) form, at a specified hierarchy.
Pre-requisites:
Perform these steps:
A Device Pool contains system, device, and location-related information, and is mandatory when adding a Subscriber using Quick Add Subscriber. A Device Pool can be referenced by:
Site Defaults Doc
The Device Pool referenced in the SDD makes sure that a Subscriber's devices are always associated to a Device Pool. If there is no Device Pool referenced in either the QAG or Admin GUI drop-down (see below) the value defaults to the SDD.
Quick Add Subscriber Group (QAG)
The Device Pool referenced by a Configuration Template (CFT) in the QAG takes precedence over the Device Pool referenced in either the SDD or the Admin GUI drop-down (if exposed). See Quick Add Subscriber Group for details.
Admin GUI
An Administrator can expose a Device Pool drop-down on the QAS page on the Admin GUI by editing or cloning the Field Display Policy. See Expose Device Pools and Class of Service in Quick Add Subscriber. The Device Pool drop-down allows an Administrator to overwrite the value in the SDD by selecting a custom Device Pool from the drop-down list. The options available in the list are the site-level Device Pools if they are available, otherwise it displays all Device Pools available at Customer level (NDLR aware).
Note
When exposing the Device Pool drop-down, the Administrator must remove the value in the Device Pool field of the CFT referenced in the QAG, that is, the field must be blank. This is done to make sure that the value in the CFT does not overwrite the custom value in the drop-down.
The CFTs and their target models for which the Device Pool name can be made blank to allow the GUI to drive the Device Pool selection include:
A Device Pool contains system, device, and location-related information, and is mandatory when adding a Subscriber using Quick Add Subscriber. A Device Pool can be referenced by:
Site Defaults Doc
The Device Pool referenced in the SDD makes sure that a Subscriber's devices are always associated to a Device Pool. If there is no Device Pool referenced in either the QAG or Admin Portal drop-down (see below) the value defaults to the SDD.
Quick Add Subscriber Group (QAG)
The Device Pool referenced by a Configuration Template (CFT) in the QAG takes precedence over the Device Pool referenced in either the SDD or the Admin Portal drop-down (if exposed). See Quick Add Subscriber Groups for details.
Admin Portal
An Administrator can expose a Device Pool drop-down on the QAS page on the Admin Portal by editing or cloning the Field Display Policy. See Expose Device Pools and Class of Service in Quick Add Subscriber. The Device Pool drop-down allows an Administrator to overwrite the value in the SDD by selecting a custom Device Pool from the drop-down list. The options available in the list are the site-level Device Pools if they are available, otherwise it displays all Device Pools available at Customer level (NDLR aware).
Note
When exposing the Device Pool drop-down, the Administrator must remove the value in the Device Pool field of the CFT referenced in the QAG, that is, the field must be blank. This is done to make sure that the value in the CFT does not overwrite the custom value in the drop-down.
The CFTs and their target models for which the Device Pool name can be made blank to allow the Portal to drive the Device Pool selection include:
For details to provision services to users, follow these instructions:
When creating users with the Quick Add Subscriber function, consider these conditions:
A check box called Send welcome email is displayed when you type in a user email address only if the following configuration has been made and is enabled:
A welcome email is then sent to the subscriber email address using the configured "Quick Add Subscriber" HTML email template that applies to the hierarchy (Email)
From the Quick Add Subscriber Group menu, create a custom group or use the default group.
You can edit existing users on Cisco Unified Communications Manager through Quick Add Subscriber only if the users exist at the Site level.
A check box called Include users at higher hierarchy can be displayed by means of a custom Field Display Policy (field name: lookUpForUser, hidden by default), so that the User drop-down list will also show users above the current site hierarchy. This setting is also available for bulk load sheets and API calls.
A check box called Fail Transaction if user not found can be displayed by means of a custom Field Display Policy (field name: failIfNotFound, hidden by default) to prevent adding users not on Cisco Unified Communications Manager. By default, the transaction will not fail. The option is used for the case where users have not been synced from LDAP to Cisco Unified Communications Manager. This setting is also available for bulk load sheets and API calls.
LDAP synced or LDAP integrated at Cisco Unified Communications Manager user fields are always read-only and cannot be edited.
You can associate a Line with multiple phones.
You can associate a Phone with multiple Lines.
If you choose to add a Phone for the user, the Phone Name drop-down list will show available phones at the user's site, according to the Phone Type as specified in the Site Defaults for the site.
The phones available from the drop-down list are those in the associated Quick Add Subscriber Group at the Customer level, which have synced from Unified CM, as well as the phones that are available at the specific site level.
You can also add a new phone if required by entering a valid name in the Phone Name field. The Phone Name must consist of a prefix, for instance SEP, followed by a MAC address, which is 12 hexadecimal characters. If you enter the Phone Name incorrectly, for example too few or too many characters, then subsequent associated transactions will fail.
Associate an Entitlement Profile with the Subscriber.
You can create multiple devices for a user. Therefore, the Voice check box is always visible. When the Voice check box is selected, four optional fields are exposed: Phone Type, Phone Protocol, Phone Button Template, and Phone Security Profile.
Values set in the Phone Type, Phone Protocol, Phone Button Template, and Phone Security Profile fields will override any existing values in QAG or CFT, as well as the SDD or any other backend CFTs (CFTs that can not be edited).
If a specific phone type is not allowed in an entitlement profile, that phone type will not be displayed in the Phone Type drop-down list for a Subscriber associated to that entitlement profile.
If a field is blank, the existing values in QAG, CFT, SDD or other backend CFTs will be used.
If a Phone Template is not specified in QAG, or if the specified Phone Template has blank values for the phone fields, then the phone field values are pulled from the SDD.
You can override the default Phone Button Template value by entering a custom value in the Phone Button Template field. The entered value will be applied on Unified CM if the Unified CM allows it for that phone type.
Note
To reduce the likelihood of conflicting QAS settings when completing the optional fields mentioned above, we strongly recommend setting the required fields in the order as displayed on the Quick Add Subscriber screen:
You can set only one Extension Mobility profile for a user. Therefore, the Extension Mobility check box is not visible after you create an Extension Mobility profile.
You can set only one WebEx account for a user.
See Contact Center Agent Quick Add.
You can associate multiple Jabber and Dual Mode devices to a user.
Jabber and Dual Mode devices get the first line assigned to them that is specified in the QAS form.
You can create a Directory Number in Unified Communications Manager in two ways:
When you create a Voicemail or Voicemail Line using Quick Add Subscriber, the Directory Number Used field is set to "true" under Subscriber Management > Directory Number Inventory.
A Directory Number created without any device associations (for example, a Voicemail Line) is tagged under Subscriber Management > Lines as 'DN created without device from QAS.'
When the Enable Self Provisioning check box is checked, phone lines are added using the Universal Line Template (ULT) referenced in the Self Provisioning User Profile chosen from the Self Provisioning User Profile drop-down list which is exposed upon selecting the check box.
If a User is added with lines but no devices, then selecting the Enable Self Provisioning check box automatically sets the CUCM User Primary Extension to the QAS line pattern and ULT route partition. If a user is added with devices and lines, then selecting this check box also automatically sets the CUCM User Primary Extension to the QAS line pattern and ULT route partition.
Choose the required User Profile from the Self Provisioning User Profile drop-down list. The available User Profiles are those under User Management > Self Provisioning > User Profile. A User Profile must be selected when a user is enabled for Self Provisioning. A default User Profile (as shown under Site Management > Site-Defaults) is selected. Change this default if required.
Contact Center Agent Quick Add
refer to UCCX Feature Reference
The Quick Add Subscriber feature supports the easy creation of an UCCX agent.
The Contact Center Agent check box becomes visible if:
If the check box is selected:
A Contact Center Agent Profile drop-down list is available to select an agent profile.
Note
The Contact Center Agent Profile needs to be created before adding the Contact Center Agent from the Quick Add Subscriber feature.
The agent profile will determine the team, resource group and skills assigned to the newly created agent. See: Agent Profiles.
The Agent Extension can be selected.
The extension will be a list of specified Lines, in other words, the administrator must specify the Line to be created or reused before selecting the Contact Center check box.
The Agent Device Type can be selected: either Extension Mobility or Phone:
An IPCC extension is automatically managed for the Unified CM user associated with the Contact Center Agent.
Related Topics
Introduction to Entitlement in the Core Feature Guide
Overview
In VOSS Automate, enabling extension mobility via Quick Add Subscriber (QAS) creates a device profile for the user on CallManager (the call processing component of CUCM).
A CUCM user device profile may be considered a dummy phone with lines. When the user logs in to a physical phone associated with the CallManager and enters their username and pin, CallManager applies their device profile to the phone (with their line, settings, and extension number), effectively assigning ownership of the phone to the user for the period they're logged in.
Provided a user is logged in to a physical phone via their device profile username and pin, they're always reachable via the extension number assigned to their device profile, regardless of the physical device they're using. The user's extension number is associated with their device profile and not to a physical device and is thus always 'mobile'.
Related Topics
Introduction to EMCC in the Core Feature Guide
Configuration Templates in the Core Feature Guide
Extension Mobility Profiles in the Core Feature Guide
EMCC and Multi-Cluster CallManager
A large organization (set up at the VOSS Automate Customer hierarchy) may have multiple CallManager clusters (separate CallManager servers in a multi-cluster setup). For example, a CallManager cluster located in London (providing phones and services to the London office), and a CallManager cluster located in New York (providing phones and services to the New York office). In this scenario, CallManager allows inter-cluster calls between these locations; each CallManager has a different IP address, and each has different data (the phones, users, and services, for either London or New York, in this case).
A CUCM administrator configures cross-cluster via the CUCM Extension Mobility Cross Cluster (EMCC) feature settings on CUCM, and in VOSS Automate (via Customer Management > EMCC).
Once configured on CUCM, EMCC may be enabled per user in CUCM, and a EMCC calling search space (CSS) is chosen for the user device profile.
Note
In VOSS Automate, EMCC groups define the clusters and countries to be used together for extension mobility. When saving an EMCC group, VOSS Automate creates the relevant route partitions, device pools, and the CSS related to the countries selected for the EMCC group.
A user enabled for EMCC can use their extension at another location that is part of the cluster. For example, a user can log in to a desk phone in London in the morning, travel to New York, and log in to a desk phone at the New York office when they arrive. Regardless of their physical location, the user remains reachable via the same extension number, provided they're logged in to a physical phone in a connected cluster, using their home cluster device profile username and pin.
Quick Add Subscriber and Configuration Templates
QAS references a selected QAG, which contains a number of configuration templates that define values for various settings. For example, the CUCM user template, or the extension mobility template (which defines the user device profile settings). For example, you can assign to the QAG, a CUCM user template that has Enable Extension Mobility Cross Cluster set to True, so that all subscribers added via QAS with this QAG are automatically enabled for EMCC.
Device Profiles and Extension Mobility Profiles
A CallManager device profile is called an extension mobility profile in VOSS Automate. Device profiles are configured in VOSS Automate via device profile configuration templates. EMCC CSS may be automatically assigned via device profile configuration template.
Assigning Extension Mobility via QAS
Go to Subscriber Management > Quick Add Subscriber, and choose a user from the Username drop-down list.
Select Extension Mobility.
To enable EMCC, select EMCC.
Note
The EMCC checkbox displays only if you've selected the Extension Mobility checkbox.
Click Save.
Verify that the extension mobility profile name appears in the Extension Mobility Profiles field on the Existing Services tab.
Note
Extension mobility can also be enabled and inspected via the Subscriber Management list view (click on the subscriber and check the settings on the following tabs: User, Extension Mobility).
Choose Subscriber Management > Subscribers. From the Subscribers list, click on the name of the subscriber to be provisioned with voicemail.
Choose the Voicemail tab.
In the Voicemail Account field, click +. The Voicemail Line drop-down appears.
Choose a line from the Voicemail Line drop-down and click OK.
For details on the workflow, see Voicemail.
Choose Subscriber Management > Quick Add Subscriber, and choose the same user from the Username drop-down list.
Choose the Existing Services tab.
Make sure that the voicemail line appears in the Voicemail Extension field.
This procedure enables a subscriber for the Webex service.
Related Topics
This procedure provisions a subscriber with the Jabber or dual mode device service, using Quick Add Subscriber (QAS).
Go to (default menus) Subscriber Management > Quick Add Subscriber.
From the Username drop-down, choose a user.
Select the Jabber/Dual-Mode Device check box. The Jabber and Dual-Mode Devices field appears.
Click the Plus icon (+) at Jabber and Dual-Mode Devices to expose the Jabber/Dual Mode Agent drop-down and Device Name field.
At Jabber/Dual Mode Agent, choose a device type. The Device Name field is automatically generated as follows:
If no device name exists in the format <device type prefix><username>, then in this format:
<device type prefix><username>
If device name exists in the format <device type prefix><username> or <device type prefix><username><number>, then in the format:
<device type prefix><username><random number>
where <random number> is generated and unique.
See examples in table below.
Example Device Type and Device Name Combinations
For this type of device | Device Name (automatically generated) Format (regex): "[a-zA-Z0-9]{1,15}" |
---|---|
Android (Cisco Dual Mode for Android) | For example: BOTJOHND003938 |
CSF (Cisco Unified Client Services Framework) | For example: CSFROBWOR77891 |
iPad (Cisco Jabber for Tablet) | For example: TABRQUENT18947 |
iPhone (Cisco Dual Mode for iPhone) | For example: TCTPDEVILLI156 |
Carrier Integrated Mobile | For example: CIMJOHNSMI |
CTI Remote Device | For example: CTIJOHNSMI |
For the following Agents, also select the Mobile Identity checkbox to enable Mobile Identity if required:
Click Save.
Go to Subscriber Management > Quick Add Subscriber.
From the Username list, choose the same user.
On the Existing Services tab, ensure that the Phones field displays the Jabber device.
For each device type, a Configuration Template that is associated with the Subscriber's Quick Add Group is used to provision the device. For defaults, see: Quick Add Subscriber Group Default Model.
Note
If a CSF Jabber device type is selected, all lines are associated to the CSF Jabber device by default.
Procedure
Choose Subscriber Management > Quick Add Subscriber, and choose the user for whom you want to provision Single Number Reach from the Username drop-down list.
Choose the Single Number Reach tab. The SNR Mobile Number field appears.
In the SNR Mobile Number field, optionally enter the mobile number. Do not add any spaces or special characters to the number.
The SNR Mobile Number can be the same as the user's Mobile Number shown in User Management > Users.
Click Save.
Choose Subscriber Management > Quick Add Subscriber, and choose the same user from the Username drop-down list.
Choose the Existing Services tab.
Make sure that the Single Number Reach displays the Single Number Reach profile name.
The Single Number Reach profile name is the user name followed by "-RDP". For example: jsmith-RDP.
This procedure enables self-provisioning for a subscriber using Quick Add Subscriber (QAS).
If the Enhanced INI Filtering feature is enabled, administrators have access to the Inventory Filter dropdown list menu for lines on the following forms:
The filter would typically be used to show a filtered, shorter dropdown list of directory numbers.
Note
If the Internal Number Inventory (INI) feature is not enabled, Enhanced INI Filtering will not be applied and all the list of numbers are obtained from the device.
The following options are available in the Inventory Filter list:
Default
This filter - enabled by default - corresponds with the standard filter of Directory Numbers:
Show Unused Numbers with Associated E164's (Site Only)
Show Unused Numbers with Associated E164's
Show Used Numbers (Site Only)
Show Used Numbers
Show Numbers belonging to this Subscriber
A Class of Service (CoS) allows the user to specify a Calling Search Space (CSS) for devices and lines, respectively. A CSS, in turn, is mandatory for lines and devices when adding a Subscriber using Quick Add Subscriber. A Calling Search Space can be referenced by:
Site Defaults Doc
The Calling Search Space values referenced in the SDD ensure that a Subscriber's lines and devices always have a Calling Search Space associated to it. If there are no Calling Search Space values referenced in either the QAG or via the Class of Service field in the Admin GUI drop-down (see below) the value defaults to the SDD.
Quick Add Subscriber Group (QAG)
The Calling Search Space values referenced by a Configuration Template (CFT) in the QAG take precedence over the Calling Search Space values referenced in either the SDD or the Class of Service via the Admin GUI drop-down (if exposed). See Quick Add Subscriber Group for details.
Admin GUI
An Administrator can expose a Class of Service drop-down on the QAS page on the Admin GUI by editing or cloning the Field Display Policy. See Expose Device Pools and Class of Service in Quick Add Subscriber. The Class of Service drop-down allows an Administrator to overwrite the Calling Search Space values in the SDD by selecting a custom Class of Service from the drop-down list. The Class of Service, in turn, contains a custom Calling Search Space for Lines and Devices respectively. The options available in the list are the customer level Class of Service instances, as created by the relevant administrator.
Note
When exposing the Class of Service drop-down, the Administrator must remove the values in the Calling Search Space fields of the CFT's referenced in the QAG, that is, the field must be blank. This is done to make sure that the value in the CFT does not overwrite the custom Calling Search Space value as defined in the selected Class of Service.
The CFTs and their target models for which the Calling Search Space name can be made blank to allow the GUI to drive the Calling Search Space values include:
A Class of Service (CoS) allows the user to specify a Calling Search Space (CSS) for devices and lines, respectively. A CSS, in turn, is mandatory for lines and devices when adding a Subscriber using Quick Add Subscriber. A Calling Search Space can be referenced by:
Site Defaults Doc
The Calling Search Space values referenced in the SDD ensure that a Subscriber's lines and devices always have a Calling Search Space associated to it. If there are no Calling Search Space values referenced in either the QAG or via the Class of Service field in the Admin Portal drop-down (see below) the value defaults to the SDD.
Quick Add Subscriber Group (QAG)
The Calling Search Space values referenced by a Configuration Template (CFT) in the QAG take precedence over the Calling Search Space values referenced in either the SDD or the Class of Service via the Admin Portal drop-down (if exposed). See Quick Add Subscriber Groups for details.
Admin Portal
An Administrator can expose a Class of Service drop-down on the QAS page on the Admin Portal by editing or cloning the Field Display Policy. See Expose Device Pools and Class of Service in Quick Add Subscriber. The Class of Service drop-down allows an Administrator to overwrite the Calling Search Space values in the SDD by selecting a custom Class of Service from the drop-down list. The Class of Service, in turn, contains a custom Calling Search Space for Lines and Devices respectively. The options available in the list are the customer level Class of Service instances, as created by the relevant administrator.
Note
When exposing the Class of Service drop-down, the Administrator must remove the values in the Calling Search Space fields of the CFT's referenced in the QAG, that is, the field must be blank. This is done to make sure that the value in the CFT does not overwrite the custom Calling Search Space value as defined in the selected Class of Service.
The CFTs and their target models for which the Calling Search Space name can be made blank to allow the Portal to drive the Calling Search Space values include:
Administrators with access to Field Display Policies (FDP) can expose the Device Pools field and Class of Service (CoS) field on the Quick Add Subscriber (QAS) interface at a specific hierarchy.
If an administrator is at the hierarchy where the cloned FDP is created or at a lower hierarchy, and then navigates to Subscriber Management > Quick Add Subscriber, a drop-down field with the title: Device Pools or Class of Service is exposed.
Administrators with access to Field Display Policies (FDP) can expose the Device Pools field and Class of Service (CoS) field on the Quick Add Subscriber (QAS) interface at a specific hierarchy.
If an administrator is at the hierarchy where the cloned FDP is created or at a lower hierarchy, and then navigates to Subscriber Management > Quick Add Subscriber, a drop-down field with the title: Device Pools or Class of Service is exposed.
Title | Description | Details | |||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
User Details | Group Assigned by FDP |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Username * |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Include users at higher hierarchy | Includes users above site level when searching |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Fail Transaction if user not found | used with API to prevent creation of local users where LDAP is in use |
|
|||||||||||||||||||||||||||||||||||||||||||||||
First Name |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Last Name * |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Email Address |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Send welcome email | Send Email to user using predefined HTML Email Template. Email template used is 'Quick Add Subscriber' |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Password | The corresponding CUCM, CUC and WebEx user password will be set with this password |
|
|||||||||||||||||||||||||||||||||||||||||||||||
PIN | The corresponding CUCM and CUC user PIN will be set with this PIN |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Entitlement Profile |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Quick Add Group * |
|
||||||||||||||||||||||||||||||||||||||||||||||||
User status |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Use next available line | Use the next available line from the inventory. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Lines |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Inventory Filter | Default: default |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Directory Number |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Voice |
|
||||||||||||||||||||||||||||||||||||||||||||||||
External Auto Trigger? |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Is PhoneType Entitled? |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Phone Type |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Phone Protocol |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Phone Button Template |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Phone Security Profile |
|
||||||||||||||||||||||||||||||||||||||||||||||||
does_phonetype_support_pac |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Use Activation Code Onboarding | Enabling this checbox will instruct this workflow to add one phone only, using the Activation-Code based registration method. The code will be automatically generated. When selected, the Phone name field also gets hidden because the phone name will be automatically generated when this onboarding method is used. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Allow MRA Mode |
|
||||||||||||||||||||||||||||||||||||||||||||||||
MRA Service Domain |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Phones |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Phone Name | Name of phone to provision for e.g. SEPABCDEFABCDEF |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Extension Mobility |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Voicemail |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Webex Meetings | Webex Meetings |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Pexip Conferencing | Pexip Conferencing |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Single Number Reach |
|
||||||||||||||||||||||||||||||||||||||||||||||||
SNR Mobile Number |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Webex App | Webex App |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Webex App User Template | Webex App User Template |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Contact Center Agent |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Agent Profile |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Agent Device Type | Default: Phone |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Agent Device |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Agent Extension |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Jabber / Dual-Mode Device | When adding a Jabber device also specify a line to be associated. The first line specified will be used for any Jabber device added here. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Jabber and Dual-Mode Devices |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Jabber / Dual-Mode Agent |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Device Name |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Mobile Identity |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Destination |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Enable Self Provisioning |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Self Provisioning User Profile |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Existing Services | Group Assigned by FDP |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Existing Services |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Primary Extension |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Phones |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Extension Mobility Profiles |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Voicemail Extension |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Conferencing |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Single Number Reach |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Webex App | Webex App |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Contact Center |
|