.. _new-bap-subscribers-dashboard:


Subscribers
-----------

.. _19.1.1|VOSS-514:
.. _19.3.1|VOSS-577:
.. _19.3.2|EKB-4488:

For common details on managing a feature, see: :ref:`manage-feature-or-service`
and :ref:`feature-detail-dashboard`.

The **Subscribers** landing page provides an overview of the items and tasks
available at the **Organization Selection** level:

* **Counters** that indicate the number of subscribers and services at the selected
  level, for example: **Subscribers**, **Directory Synced**, **Local Users**,
  **Phones**, **Extension Mobility Profiles**, **Voicemail Boxes**, and **Webex Teams**.
  
  Click the appropriate counter to open the list view for that item.
* **Quick Actions** that provide the following hyperlinks:
  
  * **View All Subscribers** - Opens a list view showing all subscribers at the
    selected level. Click a specific subscriber to edit the subscriber and to view
    their detail dashboard. See :ref:`feature-detail-dashboard` for general
    information about detail dashboards.
    
    When editing a subscriber, cards for services are shown. New services can be
    added by clicking "+" on a card.
    
    Certain fields on selected services are pre-populated based on the selected
    **Quick Add Group** and other configuration templates selected on the Subscriber
    Add form, e.g. 'Default Webex Teams User Template'.

  * **Add Subscriber** - Opens a form to add a subscriber.
  
    * The subscriber is added with the details entered on the **Subscriber Details**
      form. On the form, the following minimal details can be added: mobile number,
      optionally a phone name and one line.

    * A checkbox 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:
    
      * An SMTP server has been set up (refer to the SMTP server topic in the Core Feature Guide)
      * The **Allow email to be sent to user after Quick Add Subscriber** on **Email** tab
        of the **Global Settings** is set to **Yes** for the relevant hierarchy.
        (refer to the Global Settings topic in the Core Feature Guide)
    
      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.
      (refer to the Email topic in the Core Feature Guide)

    * Features and services assigned to the subscriber by the selected **Subscriber Profile**
      see :ref:`new-bap-subscribers-dashboard-subscriber-profile`.

  * **Bulk Add Subscribers** - Click this hyperlink to bulk add more than one
    subscriber from a single page.
    
    .. note::
     
       The **Default** subscriber profile (if present) can only be deleted by a
       System Administrator at sys (System) level .
   
       The following input fields are exposed for **Bulk Add Subscribers**:

       * **User ID**
       * **First Name**
       * **Last Name**
       * **Email Address**
       * **Mobile Number**
       * **Profile** : the selected subscriber profile determines features and services
         available during the bulk add.

       Values for the following are automatically generated or assigned:
 
       * Phone Name: generated - format is ``BAT<random number>``.
         
         Generate Phone Name = True
         
       * Line - assigned as next available and unused number from the internal number inventory.

         Use next available line = True

.. _new-bap-subscribers-dashboard-subscriber-profile:

Subscriber Profiles
...................
 
A subscriber profile allows for quick provisioning
of subscribers with the same (or similar) set of features and services.

Click this hyperlink to open the **Subscriber Profiles** list view showing the
subscriber profiles available at the selected hierarchy level.

Subscriber profiles can be created by an administrator using either the
Administration GUI or the Business Admin Portal (BAP).

Created profiles will be available in the BAP **Subscriber Profile** drop-down
at that hierarchy level (and below) only, and can be assigned to a subscriber
when the subscriber is added using the **Subscriber Details** form.

See "Subscriber Profiles" in the Core Feature Guide for more details about the
available options and fields.

Considerations when a service is enabled in the Subscriber Profile:

* Extension Mobility - The device types available in the drop-down, are determined
  by the extension mobility profile template, which in turn determines the device
  configuration settings. The **Line** drop-down default is the first subscriber
  line. The **Line Label** and **Line Display** are derived from the subscriber.

  Only one device profile can be added for extension mobility in VOSS-4-UC. If a
  subscriber is associated with more than one extension mobility profile on the
  Unified CM, and you sync with VOSS-4-UC, only the first extension mobility profile
  is displayed on the **Subscribers** list view in VOSS-4-UC.
  
* Voicemail - If enabled by the subscriber profile, and when adding this service,
  the subscriber can be added as a voicemail user. See also :ref:`voicemail-dashboard`. 
* Single Number Reach - You cannot add more than one remote destination profile
  for single number reach.
  
  If a mobile number has already been configured for a subscriber, it is used
  to pre-populate the **Mobile Number** field when adding Single Number Reach
  (SNR) for that subscriber. You can enter a different mobile number for SNR
  if required.
  
* Webex Teams - If enabled by the subscriber profile, and when adding this service,
  the subscriber can be added as a webex teams user. See also :ref:`webex-teams-dashboard`. 
* Contact Center Express - If enabled by the subscriber profile, and when adding
  this service, a form shows the subscriber default extension and depending on the
  selected controlled device type, (phone or extension mobility) the phone or device
  profile for the subscriber.
  An **Agent Profile** can be selected. For details, see :ref:`BAP_UCCX-Feature-Reference`.