User Administration

Overview

All of the Symbee Connect features are optionally configurable, with the end-user features being controlled at a user by user level. As a result, each end user needs a User Profile defined within Symbee Connect. The Symbee Connect User Profile basically extends the Amazon Connect user definition and configures which Symbee Connect features are enabled for the end user.

Although you can configure Symbee Connect end users on an individual user by user basis, for ease of management, User Templates are provided to enable you to set up logical groups of users, then configure the required features on the User Template, and bulk-apply the User Template to a group of users all in one step.

At a high level, there are two fundamental types of end users defined within the User Administration section of the Symbee Connect Administration Portal:

  • Unified Communications Users: these refer to non-contact center users using Symbee Connect Unison.

  • Contact Center Users: these refer to contact center users using Symbee Connect Engage.



Maintaining Users in Amazon Connect via the Administration Portal

As noted in the overview above, every end user/agent using Symbee Connect needs to be declared in both Symbee Connect (with a Symbee Connect User profile configured via the Symbee Connect Administration Portal) and also in Amazon Connect (under Users > User Management in the Amazon Connect Console).

The Symbee Connect Administration Portal provides a complete set of user management functionality to (optionally) fully integrate directly with your Amazon Connect instance, to allow you to perform all maintenance of users from a single place (your Symbee Connect Administration Portal).

Note

Full user management functionality from within the Symbee Connect Administration Portal has been added over time, as initially Amazon Connect API's did not have 100% coverage for all aspects of user management (there is now).

The reason all aspects of integrated user management were added as configuration settings (noted below) that you optionally have to enable in Symbee Connect was A) to avoid unexpected behavior changes for existing Symbee Connect customers as additional integration aspects were added; and B) to avoid changes being made to your Amazon Connect configuration without your administrators being aware.

To fully enable all aspects of integrated user management functionality so you can perform all user administration from your Symbee Connect Administration Portal, make sure to do all of the following:

  1. Download and deploy the optional Amazon Connect Management and Real-time Statistics CloudFormation - see here for details on how to do this. This step provides the IAM permissions to allow Symbee Connect to have visibility to the Users configured in your Amazon Connect instance.

  2. Enable the Connect User Management Integration enabled setting under the Amazon Connect Integration settings on the Amazon Connect Integration view access from the main Function Menu - see here for reference. This step enables visibility, creation, and deletion of Users in your Amazon Connect instance from the User Administration views in your Symbee Connect Administration Portal.

  3. In your Symbee Connect User profiles and User Templates, enable the Allow Updates to Amazon Connect User setting under Amazon Connect User Settings in the AWS Integration section of the User profile or User Template - see here for details. The Amazon Connect User Settings section of the Symbee Connect user profile/template are a direct representation of the 10 fields that make up the definition of a User within your Amazon Connect instance. This step allows updates made to values of these 10 fields from the Symbee Connect Administration Portal to also be made back in your Amazon Connect.

Warning

Step 3 above was the last to be added once Amazon Connect API's finally had 100% coverage for all user management aspects.

If you don't perform this step, changes made after the initial user creation, to the 10 Amazon Connect fields (for example, First Name, Last Name, Auto Accept, Routing Profile selection, etc) on User profile screens in Symbee Connect will not be replicated to the respective Users back in your Amazon Connect instance and your Symbee Connect User definitions will become out of sync with your Amazon Connect user definitions.

Related to this, on the User listing screens in Symbee Connect, there is a Resync Users with Amazon Connect action specifically provided to get your user definitions back in sync (it performs a synchronization of the 10 Amazon Connect related user fields with the values from your users configured in your Amazon Connect instance). See here for details.


User Templates

Users in Symbee Connect are initially created from a User Template. Each user can then be customized to differ from the Template as needed after creation. For ease of user maintenance, create User Templates for each group of users that will have a different configuration. If the user groups' configuration needs to change at a later time, the User Template can then be updated and quickly re-applied to the group of users in a single step. A different or modified User Template can be reapplied to an already created User at any time.

Options are available to Modify, Delete, Duplicate Template, and Add Template.

A User Template has to be added through the Add Template option before it can be configured.

Add Template

User Template Name

The template identifier that will be displayed in pick-lists.

User Template Description

Provide a short description for the new User Template being created.


Modify User Template

When you Modify a User Template, there are three User Modes:

Unison

Unified Communications Users, i.e., non Contact Center Users.

Click here for Unison User Settings.

Engagement

Contact Center Users - this is the default selected User Mode

Click here for Engagement User Settings.

Supervisor

Contact Center Supervisor Users - these are a variation of Contact Center Users with additional Supervisor-specific settings.

Click here for Supervisor User Settings.


Notes:

  • When modifying a User Template, make sure you have the correct User Mode selected (at the top) for the template your are updating.
  • When an existing user template is updated, existing user's that have that user template last-applied to them will not automatically be updated. This behavior is intentional and by-design.
  • After updating a user template, if you want all users that currently have that template last-applied to them updated as well:
    • Navigate to the Contact Center Users or Unified Communications Users listing screen
    • Use the Search Filter to show all existing users that have the user template in question last applied to them
    • Check the select-all check box in the top-left of the users listing table to select all entries shown
    • Click the (Re)Apply Template action button, select your updated template on the resulting confirmation dialog and click Apply Template.

Your user template changes will then be applied to all the selected users.


Duplicate Template

Use the Duplicate Template action to create a new User Template based on the current settings of an existing template.

Select an existing User Template you want to base the new template on from the User Templates listing screen, and click the Duplicate Template action button. Complete the resulting dialog.

New Template Name

Provide the template identifier for the new template to be created, that will be displayed in pick-lists.

User Template Description

Provide a short description for the new User Template being created.


Delete Template

Select an existing User Template you want to delete from the User Templates listing screen, click the Delete action, and confirm the delete in the resulting dialog.



Contact Center Users

This screen lists all your currently configured Contact Center agents.

Note

You will have different options and fields in these screens depending on whether you have enabled integrated user management of your users in your backing Amazon Connect instance or not. When enabled, you will be able to see what users are in your Connect instance, which of those users also have a Symbee Connect User profile (and be able to easily promote Connect users to be Symbee Connect users). You can then also manage all the Amazon Connect User settings from within these Symbee Connect Administration Portal screens (including adding and deleting users) if you prefer.

See here and here for more details on enabling integrated user management.

Options area available for the following, based on whether integrated user management is enabled or not:

  • Resync Users with Amazon Connect (only available when integrated user management is enabled)
  • Show user existence (only available when integrated user management is enabled)
  • Modify
  • Delete
  • Add & Upload Users
  • (Re)Apply Profile
  • Create Users In Connect (only available when integrated user management is enabled)
  • Assign Routing Profile (only available when integrated user management is enabled)
  • Assign User Hierarchy (only available when integrated user management is enabled)


Note: A User has to be added before it can be configured.


Resync Users with Amazon Connect

When integrated user management is enabled, this action performs a synchronization of all Amazon Connect related user fields (names, email addresses, selected routing profile, security groups, hierarchy, etc) with the values from your users configured in your Amazon Connect instance.

This catches any changes made directly to users in Amazon Connect rather than through this these Symbee Connect screens. A Resync may take a few minutes, and when initiated, will run in the background.


Show User Existence

When integrated user management is enabled, checking this box modifies the below user list to contain a merge of both the users configured in your Amazon Connect instance, as well as the users configured as Symbee Connect users, and the differences.


Modify an existing User

To update an existing user's profile, either click directly on the user's Login Name in the list, or check the user's checkbox on the left, and click the Modify action.

Only one user can be updated at a time using this action. To update multiple / many users at the same time, make use of User Templates and the (Re)Apply Template action (see further below).

Once Modify is clicked (or directly clicking the user's Login Name), the Users - Maintain Profile screen will be shown. The user's mode selector is at the top, and then all the various user profile settings are organized into Groups and Sections.

Notes:

  • A user will not receive any user profile changes until they next sign-in. If they are already signed in when changes to their profile are made, they will need to sign-out and sign back in for the changes to take effect.
  • When modifying a Contact Center User, make sure you have either Engagement or Supervisor selected in the top User Mode selector.
  • See here for a complete list and description of all Engagement User Settings.


Delete existing Users

To delete existing users, check the checkbox on the left for each user to delete, and click the Delete action, and confirm the user deletion in the resulting dialog.

When integrated user management is enabled, on the confirmation dialog, you get the choice of: Also delete these users from Amazon Connect? By default, deleting a user will only delete the user's profile within Symbee Connect. Checking this additional box will cause the deletion of the user from both Symbee Connect and Amazon Connect.


Applying (or re-applying) a User Template to Users

The (Re)Apply Template action serves two purposes:

  1. A quick way to apply changes (made first to a User Template) to multiple / many users at the same time.
  2. When integrated user management is enabled, a quick way to perform an initial provisioning of user profiles in Symbee Connect that already had existing users defined in Amazon Connect. Essentially you can select a set of your existing Amazon Connect users, and "promote" or "import" them into Symbee Connect by simply applying a specified user template for each user for the first time. (Check the Show user existence check-box on the top right of the User's listing screen, to have the user list expanded to show all your Amazon Connect users that don't yet have a Symbee Connect user profile).

Check the checkbox on the left for each user you want to apply or re-apply a specified user template to. If you need to perform an apply to a significant number of users, we suggest you make use of the two Search Filters at the top of the list screen to limit the user's listed to just the user group you want to perform the apply to (for example: search for all users that last had a specific template applied to them). Then use the select-all checkbox in the top-left of the users list table to bulk-select all visible users.

With all the required user's selected, click the (Re)Apply Template action. In the resulting dialog, select the User Template to be applied, and click Apply Template.

Notes:

  • A user will not receive any user profile changes until they next sign-in. If they are already signed in when changes to their profile are made, they will need to sign-out and sign back in for the changes to take effect.
  • When an existing user template is updated, existing user's that have that user template last-applied to them will not automatically be updated. This behavior is intentional and by-design.
  • After updating a user template, you need to use this (Re)Apply Template action if you want all users that currently have that template last-applied to them updated as well.
  • The Last Template column in the Users listing table indicates which user template was last applied to that user.
  • You can manually change an individual user's template after it has had a user template previously applied to it.
  • If the user template name in the Last Template column on the list screen shows an asterisk () after it, it means that user's template has had at least one setting on it manually updated/changed since it received its last (Re)Apply Template* action.
  • To get a user's profile that has their Last Template showing with an asterisk () back to exactly matching the user template last applied to them, simply select those users, and Re(Apply) Template*, selecting the same user template already applied to them. This will reset all the user's settings back to exactly what is defined on the respective user template.
  • There is no restriction on switching a user's last applied template from one template to another, and back again, and so-forth. For example, if a user previously had "User Template 1" applied, you can apply "User Template 2" instead (which will switch all the user's profile settings to follow "User Profile 2"). You can then later re-apply "User Template 1", etc.


Assign Routing Profile and Assign User Hierarchy actions

When integrated user management is enabled, these two additional actions provide a quick way to perform Routing Profile and Amazon Connect User Hierarchy re-assignments on your backing Amazon Connect users in-bulk, directly from within the Symbee Connect administration portal.

Check the checkbox on the left of each user to perform either the Routing Profile or Hierarchy assignment on. If applying to a significant number of users, make use of the two Search Filters and the select-all checkbox in the users list table header to filter-down and select what you need.

Click either the Assign Routing Profile or Assign Hierarchy action, and in the resulting dialog select the required routing profile or hierarchy to assign, and click Update to complete.


Adding and Uploading new Users

To add or upload/import new user's either select Add and Import Users from the left navigation bar when in the User Administration module, or from one of the Users listing screens click the Add & Upload Users action button.

In either case, you will be taken to the Add and Import Users screen when you can either add a single user directly from the screen, or upload and import a list of users in bulk from a CSV file. See the Add and Import Users section.


Create Users in Connect

When integrated user management is enabled, you can also perform the reserve action of creating user's that aren't yet defined in Amazon Connect, for any existing user profiles already defined in Symbee Connect.

To do this:

  • Check the Show user existence check-box on the top right of the User's listing screen, to have the user list expanded to show all your currently existing Amazon Connect users included with your list of Symbee Connect user profiles.
  • Check the checkbox on the left of each Symbee Connect user that does not yet exist in Amazon Connect that you want to create, and then click the Create Users in Connect action and confirm the resulting confirmation dialog
  • The Create Users in Connect screen will be displayed where you can select the values you want to use for the backing Amazon Connect user creation. Complete this form and click Create at the bottom to start the user creation.



Unified Communications Users

Overview

This screen lists all your currently configured back-office Unified Communications, known as Unison users.

Note

You will have different options and fields in these screens depending on whether you have enabled integrated user management of your users in your backing Amazon Connect instance or not. When enabled, you will be able to see what users are in your Connect instance, which of those users also have a Symbee Connect User profile (and be able to easily promote Connect users to be Symbee Connect users). You can then also manage all the Amazon Connect User settings from within these Symbee Connect Administration Portal screens (including adding and deleting users) if you prefer.

See here and here for more details on enabling integrated user management.

Options area available for the following, based on whether integrated user management is enabled or not:

  • Resync Users with Amazon Connect (only available when integrated user management is enabled)
  • Show user existence (only available when integrated user management is enabled)
  • Modify
  • Delete
  • Add & Upload Users
  • (Re)Apply Profile
  • Create Users In Connect (only available when integrated user management is enabled)
  • Assign Routing Profile (only available when integrated user management is enabled)
  • Assign User Hierarchy (only available when integrated user management is enabled)


Note: A User has to be added before it can be configured.


Resync Users with Amazon Connect

When integrated user management is enabled, this action performs a synchronization of all Amazon Connect related user fields (names, email addresses, selected routing profile, security groups, hierarchy, etc) with the values from your users configured in your Amazon Connect instance.

This catches any changes made directly to users in Amazon Connect rather than through this these Symbee Connect screens. A Resync may take a few minutes, and when initiated, will run in the background.


Show User Existence

When integrated user management is enabled, checking this box modifies the below user list to contain a merge of both the users configured in your Amazon Connect instance, as well as the users configured as Symbee Connect users, and the differences.


Modify an existing User

To update an existing user's profile, either click directly on the user's Login Name in the list, or check the user's checkbox on the left, and click the Modify action.

Only one user can be updated at a time using this action. To update multiple / many users at the same time, make use of User Templates and the (Re)Apply Template action (see further below).

Once Modify is clicked (or directly clicking the user's Login Name), the Users - Maintain Profile screen will be shown. The user's mode selector is at the top, and then all the various user profile settings are organized into Groups and Sections.

Notes:

  • A user will not receive any user profile changes until they next sign-in. If they are already signed in when changes to their profile are made, they will need to sign-out and sign back in for the changes to take effect.
  • When modifying a Unified Communications User, make sure you have Unison selected in the top User Mode selector.
  • See here for a complete list and description of all Unison User Settings.


Delete existing Users

To delete existing users, check the checkbox on the left for each user to delete, and click the Delete action, and confirm the user deletion in the resulting dialog.

When integrated user management is enabled, on the confirmation dialog, you get the choice of: Also delete these users from Amazon Connect? By default, deleting a user will only delete the user's profile within Symbee Connect. Checking this additional box will cause the deletion of the user from both Symbee Connect and Amazon Connect.


Applying (or re-applying) a User Template to Users

The (Re)Apply Template action serves two purposes:

  1. A quick way to apply changes (made first to a User Template) to multiple / many users at the same time.
  2. When integrated user management is enabled, a quick way to perform an initial provisioning of user profiles in Symbee Connect that already had existing users defined in Amazon Connect. Essentially you can select a set of your existing Amazon Connect users, and "promote" or "import" them into Symbee Connect by simply applying a specified user template for each user for the first time. (Check the Show user existence check-box on the top right of the User's listing screen, to have the user list expanded to show all your Amazon Connect users that don't yet have a Symbee Connect user profile).

Check the checkbox on the left for each user you want to apply or re-apply a specified user template to. If you need to perform an apply to a significant number of users, we suggest you make use of the two Search Filters at the top of the list screen to limit the user's listed to just the user group you want to perform the apply to (for example: search for all users that last had a specific template applied to them). Then use the select-all checkbox in the top-left of the users list table to bulk-select all visible users.

With all the required user's selected, click the (Re)Apply Template action. In the resulting dialog, select the User Template to be applied. Note: Make sure you have created and select a Unison User Template, as the default user mode on a template is Engagement.

With the template to apply chosen, click Apply Template.

Notes:

  • A user will not receive any user profile changes until they next sign-in. If they are already signed in when changes to their profile are made, they will need to sign-out and sign back in for the changes to take effect.
  • When an existing user template is updated, existing user's that have that user template last-applied to them will not automatically be updated. This behavior is intentional and by-design.
  • After updating a user template, you need to use this (Re)Apply Template action if you want all users that currently have that template last-applied to them updated as well.
  • The Last Template column in the Users listing table indicates which user template was last applied to that user.
  • You can manually change an individual user's template after it has had a user template previously applied to it.
  • If the user template name in the Last Template column on the list screen shows an asterisk () after it, it means that user's template has had at least one setting on it manually updated/changed since it received its last (Re)Apply Template* action.
  • To get a user's profile that has their Last Template showing with an asterisk () back to exactly matching the user template last applied to them, simply select those users, and Re(Apply) Template*, selecting the same user template already applied to them. This will reset all the user's settings back to exactly what is defined on the respective user template.
  • There is no restriction on switching a user's last applied template from one template to another, and back again, and so-forth. For example, if a user previously had "User Template 1" applied, you can apply "User Template 2" instead (which will switch all the user's profile settings to follow "User Profile 2"). You can then later re-apply "User Template 1", etc.


Assign Routing Profile and Assign User Hierarchy actions

When integrated user management is enabled, these two additional actions provide a quick way to perform Routing Profile and Amazon Connect User Hierarchy re-assignments on your backing Amazon Connect users in-bulk, directly from within the Symbee Connect administration portal.

Check the checkbox on the left of each user to perform either the Routing Profile or Hierarchy assignment on. If applying to a significant number of users, make use of the two Search Filters and the select-all checkbox in the users list table header to filter-down and select what you need.

Click either the Assign Routing Profile or Assign Hierarchy action, and in the resulting dialog select the required routing profile or hierarchy to assign, and click Update to complete.


Adding and Uploading new Users

To add or upload/import new user's either select Add and Import Users from the left navigation bar when in the User Administration module, or from one of the Users listing screens click the Add & Upload Users action button.

In either case, you will be taken to the Add and Import Users screen when you can either add a single user directly from the screen, or upload and import a list of users in bulk from a CSV file. See the Add and Import Users section.


Create Users in Connect

When integrated user management is enabled, you can also perform the reserve action of creating user's that aren't yet defined in Amazon Connect, for any existing user profiles already defined in Symbee Connect.

To do this:

  • Check the Show user existence check-box on the top right of the User's listing screen, to have the user list expanded to show all your currently existing Amazon Connect users included with your list of Symbee Connect user profiles.
  • Check the checkbox on the left of each Symbee Connect user that does not yet exist in Amazon Connect that you want to create, and then click the Create Users in Connect action and confirm the resulting confirmation dialog
  • The Create Users in Connect screen will be displayed where you can select the values you want to use for the backing Amazon Connect user creation. Complete this form and click Create at the bottom to start the user creation.



Bulk Maintain User Settings

Use this view to more quickly make updates to the individual user settings that are not updated when applying a User Template to users. The editable fields are those that will differ for each specific user.

The settings and values here are the same fields shown in the Maintain User Profile views, but enable you to more easily make updates to multiple users as needed. Use the Columns button on the table toolbar to see all the possible settings that can be updated from this view.

Options area available to Cancel Changes and Apply Changes.

The following user fields can be updated using this screen:

  • First Name
  • Last Name
  • Direct Dial Number
  • Extension
  • Calls Auto-Accept
  • Email Address
  • Secondary Email Address
  • Mobile Number
  • Async HTTP Pop User Token 1
  • Async HTTP Pop User Token 2
  • NetSuite Fusion Employee Name



Add and Import Users

Note

The Add and Import Users screen will have different options and fields depending on whether you have enabled integrated user management of your users in your backing Amazon Connect instance or not. When enabled, fields on the lower part of the screen are used to collect the details for how new users will be created and configured within your Amazon Connect Instance.

See here and here for more details on enabling integrated user management.

The Add and Import Users screen can be accessed in three ways:

  1. From the left navigation bar when in the User Administration module
  2. From one of the Users listing screens, by clicking the Add & Upload Users action button. from the left navigation bar
  3. If integrated user management is enabled, when clicking Create Users in Connect action button from one of the Users listing screens. In this mode, the screen is used to collect the details for users created in Amazon Connect only.



Adding a Single User

Select the Create Single User radio at the top of the screen.

Under User Information, profile the specific user's identifying information, including:

Login Name

While not case-sensitive in Symbee Connect, the Login Name is case-sensitive in Amazon Connect. When integrated user management is not enabled (meaning users are created separately in Symbee Connect and Amazon Connect) this field must exactly match the Login name value for the User in Amazon Connect.

First Name and Last Name

These values are combined to create the user name in Symbee Connect. When integrated user management is enabled, these values populate the equivalent fields when the user is also created in Amazon Connect.

Email

When integrated user management is enabled, this values is used to populate the equivalent field when the user is also created in Amazon Connect.

Secondary Email

This value is used to populate the equivalent field when the user is also created in Amazon Connect.


When creating new user's in Symbee Connect, a new user is always initially created from one of your Symbee Connect User Templates. Under User Template, select the User Template that will determine the initial values for all the user's profile settings in Symbee Connect.

Note: A different User Template can be applied to the user after the initial creation - see references to the (Re)Apply Template option in previous sections).


To also create the new Single User in Amazon Connect

If integrated user management is enabled, you have the option of whether to have the new user also created In your Amazon Connect instance. Check the Create User(s) in Amazon Connect? checkbox to do this.

When integrated user management is enabled and the Create User(s) in Amazon Connect? is checked, the following additional fields are provided to collect the details for respective fields when the user is created in Amazon Connect:

  • Routing Profile
  • Security Profiles
  • Auto Accept Calls
  • User Hierarchy
  • The Initial User Password (if SSO / SAML Integration is not enabled for your Amazon Connect instance)

Complete these fields and selections appropriately.



Adding multiple users in Amazon Connect from existing Symbee Connect users

This mode is only If you have integrated user management enabled, and is accessed when clicking Create Users in Connect action button from one of the Users listing screens, and selecting one or multiple users that have already been configured in Symbee Connect. In this mode, the screen is used to collect the details for users created in Amazon Connect only.

The following fields fields are provided to collect the details for respective fields when the user (or users) are created in Amazon Connect:

  • Routing Profile
  • Security Profiles
  • Auto Accept Calls
  • User Hierarchy
  • The Initial User Password (if SSO / SAML Integration is not enabled for your Amazon Connect instance)

Complete these fields and selections appropriately.



Adding multiple Users (Importing users from a CSV file)

Select the Import Users with CSV File radio at the top of the screen.

Under User Information, use the file selector to choose a CSV (comma-separated values) file containing the user details for import.

The maximum import CSV file size is 500 KB. If your file is larger than this, separate into smaller files before uploading.

Two additional links are provided from this screen, to download an example CSV file of how the user details should be formatted.


When creating new user's in Symbee Connect, a new user is always initially created from one of your Symbee Connect User Templates. Under User Template, select the User Template that will determine the initial values for all the user's profile settings in Symbee Connect.

Note: A different User Template can be applied to the user after the initial creation - see references to the (Re)Apply Template option in previous sections).


To also create the new users being imported from file in Amazon Connect at the same time

If integrated user management is enabled, you have the option of whether to have the new users from your file also created In your Amazon Connect instance. Check the Create User(s) in Amazon Connect? checkbox to do this.

When integrated user management is enabled and the Create User(s) in Amazon Connect? is checked, the following additional fields are provided to collect the details for respective fields as each user in your file is created in Amazon Connect:

  • Routing Profile
  • Security Profiles
  • Auto Accept Calls
  • User Hierarchy
  • The Initial User Password (if SSO / SAML Integration is not enabled for your Amazon Connect instance)

Complete these fields and selections appropriately.

Note

If users being created from your CSV file require different settings in Amazon Connect (for example different Routing Profiles, different Security Profiles, or different Hierarchies), separate your list of users being imported into separate CSV files.