This document describes how to utilize Supervisor Tools to manage routine contact center administrative tasks. Topics covered include how various configuration changes are done and how those are synced with Cisco Unified Contact Center Administration.
The target audience of this document is the UCCX supervisors and system administrators who need to manage various UCCX configurations on a daily basis.
This document uses the following conventions.
Used to describe the menu items or field names
Used to describe important notes
Supervisor Tools for Cisco Unified Contact Center Express offers a rich, drag & drop user interface for the non-technical supervisors to manage their daily operations. This includes making dynamic changes to the call routing scripts, managing teams, reskilling agents, managing CSQs, changing IVR announcements, managing holiday announcements, creating call switches, defining opening/closing hours of the business and managing VIP/malicious caller lists. Furthermore, privilege-based access caters for the needs of multi-tenant, multi-department or multi-site contact centers.
Workspace management in Supervisor Tools allows supervisors to only view their own team’s configuration. Supervisors can also switch between teams when required. A supervisor can also optionally playback call recordings and run surveys for team agents to help evaluate agent performance.
Integration with Cisco UCCX takes care of all changes made to contact center configurations through Supervisor Tools. This way, Supervisor Tools controls UCCX scripts and configurations and allows the non-technical supervisors to modify the behaviour of the contact center.
The following sections describe how the end-user can log in and perform routine operations in Supervisor Tools.
The users of Supervisor Tools are UCCX supervisors and administrators. When logging in as a supervisor, use the CCX credentials to start managing your team configurations. Use the super admin credentials (provided by the EF team for first time login) to have admin-level access to all UCCX configurations.
Supervisor Tools: Logging in as Admin User
On the login screen, select one of the two options below before pressing the LOGIN button.
Active Directory: Select this option while logging with the local user credentials such as when logging in as an admin.
Contact Center: Select this option while logging in with Finesse Supervisor credentials instead of local account credentials.
Integration with the client’s Active Directory is not yet supported
The item names should not contain spaces and special characters. Also, a name can not have fewer than 3 characters. If, however, any such name exists on UCCX, that cannot be updated or removed from the EF tool. Consider renaming it before having to update it.
Administrators can assign either system-defined roles to users OR create their own customized roles with predefined permissions to certain screens only. See User Management to learn more on how to create customized roles and the roles available by default in the system.
Users that are assigned the system-defined “Administrator” role have full access to all system features including:
Groups & Skills
Announcements & Calendars
Users that are assigned the system-defined “Supervisor” role have full access to all system features including:
Groups & Skills
Announcements & Calendars
However, administrators can also create their own customized roles with predefined permissions to certain screens only. See User Management to learn more on how to create customized roles.
Only supervisors synced from CCX can have certain teams/workspaces assigned to them and hence, access to their own workspace(s) only.
Local users who are assigned the Supervisor role are able to access all data in the EF tool regardless of the workspace. This is because since they are not actual supervisors of CCX and cannot have any workspaces assigned to them, they have access to all data.
A CCX supervisor without having any team or workspace (assigned to him) cannot log on to the EF tool. Administrators must assign some workspaces to CCX supervisors who are the real users of the EF tool.
Currently, contact centre agents do not have access to Supervisor Tools and cannot log on to the tool with Finesse credentials.
This is reserved for the future.
The application provides the following default user roles to be chosen from while getting started:
Administrator: Have full superuser access with access to all system features. See Admin Access
Supervisor: Have the supervisor access to all features except User Management. See Supervisor Access
Junior Supervisor: Have limited access to the Team Administration menu with permissions to the following:
Agent: Reserved for future use. No permissions are assigned to this role since the tool does not allow agents to log on.
Except for the master user, i.e. “admin” (provided by EF to log on for the first time in the application), each user in EF Supervisor Tools has UCCX “supervisor” capability by default. To make a user an administrator on the EF tool, update the user role from Supervisor to Administrator from the User Management interface.
Note that this role update is internal to EF Supervisor Tools and will not affect the “User Capabilities” of UCCX in any way.
Assign Permissions To a User
Go to the Users page to see a list of all system users. The User list shows all administrators, supervisors and agents of CCX (synched from UCCX) and also, all local users created within the application.
To quickly find a user, click the search icon on the top and write the name of the user in the search bar. See Adding New Users to learn how to create new local user accounts.
Click on the name of the user from the results and choose a role from the Roles dropdown to update the user permissions. See Adding Roles to learn how to create custom roles.
Assign roles to a user
Adding New Users
Create local users to have multiple administrative accounts with different levels of permissions.
Navigate to the Users tab to see a list of all system users. Click the + icon and select Create New User option. The Add User form appears.
Fill in the form as per the table below and add the user.
Set the flag to ‘true’ to activate the user and ‘false’ to block its access. This is OFF by default.
Define the username. Note that special characters and spaces are not allowed in a username. A username must consist of a minimum of 3 and a maximum of 30 characters. Also, note that the username of a local user cannot be updated at the moment.
Create a password for the user. Note that the password must consist of a minimum of 8 and a maximum of 30 characters. Click the preview icon to preview the typed-in password.
Also, note that the password of a local user cannot be updated at the moment.
Define the full name of the user here. The name of the user must consist of a minimum of 3 and a maximum of 100 characters.
Define the email address of the user here. A valid email should be defined in the following format:
Upload a profile picture of the user. Picture format should be ‘.jpg’ or ‘.jpeg’ and the size of the file should not be more than 20MB.
Select role(s) from the Roles dropdown to be assigned to this user. This field is visible only once the user is added successfully with the above data.
Add New User screen
Once the user is added, the admin can start adding roles to the user profile.
Navigate to the Roles tab to see a list of all roles. Click the + icon and select Create New Role option. The Add Role form appears.
Fill in the form as per the table below and add the role.
Name given to this role. Note that special characters and spaces are not allowed in the name of the role. Also, a role name must consist of a minimum of 3 and a maximum of 30 characters.
An optional description of the role having a maximum of 150 characters.
Permissions to be added to the role. These are the system-default permissions. Select only the relevant permissions to be assigned to a customized role. This field is visible only once the role has been created successfully.
Add users to this role to whom this role has to be assigned. This field is visible only once the role has been created successfully.
The role assigned to the user can also be done alternatively from the User assignment page. See Assign Permissions To a User
Once the role is created, some permissions can be assigned to it.
Select the newly-created role from the Roles list and start adding permissions from the Permissions dropdown.
Also, select a user(s) from the Users drop-down and start adding users to this role.
Add permissions and users to a role
Deleting users and roles
To delete a user, hover the mouse pointer over the user under the Users tab and click on the Delete button.
To delete a role, hover the mouse pointer over the role under the Roles tab and click on the Delete button.
Contact centre users as synced from CCX cannot be deleted from the ExpertFlow tool. They need to be removed from CUCM in order to desync them from the EF tool.
Only the admins have access to the Users page.
If the name of a user is updated from CUCM, it takes a few mins to reflect the changes in UCCX and so in Supervisor Tools.
We do not recommend that a user’s id be changed from CUCM. It causes issues in Supervisor Tools.
If a user logs in then by default, he has read permission on all the lists
If the Supervisor logs in and he has no workspace assigned to him, he will not be able to log on to the tool
The module allows supervisors to manage their own workspaces independent of other teams. This allows management of agents, queues and optionally also scripts and applications. Let’s go through each one by one.
Adding Groups and Skills
This interface allows users to add new agent Groups and Skills in Supervisor Tools. Groups and skills added are global and hence, available to all UCCX teams or EF workspaces.
Groups & Skills definition screen
In the GROUPS tab, click the Add Group button and give a group name. Note that the name should not contain spaces within it. The name must comprise more than 2 characters and should be unique.
In the SKILLS tab, click the Add Skill button and give a skill name. Note that the name should not contain spaces within it. The name just has a length of more than 2 characters and should be unique.
Groups and skills added in UCCX are automatically synced and available on the EF Supervisor Tools.
A team in UCCX is supposed to be a ‘workspace’ in Supervisor Tools. Administrators of the contact centre can add new workspaces, assign supervisors, agents, and CSQs to a workspace by accessing the Workspaces page from the left sidebar in the Team Administration menu.
Updating a Workspace
Administrators can also optionally provide a Scripts Folder and Prompts Folder of that workspace. What the application does is, create a new script folder and a prompt folder on the root folder with the specified names. Hence, supervisors of the workspace are restricted to the scripts and prompt uploaded in the given folders. However, if restricted access to scripts and prompts is not required, this setting can just be left blank.
With this setup, an administrator can independently manage all of its business tenants from within the EF Tool, running on top of the single UCCX instance where each workspace in the EF tool corresponds to one small contact centre/tenant. This also allows avoiding the deployment of separate UCCX servers in each individual business territory.
Creating a workspace
Log on as an administrator and go to the Workspaces list. Use the following table to fill Create a Workspace form.
Name of the workspace.
Choose a primary supervisor who is supposed to manage the UCCX team.
Optionally, choose a secondary supervisor for this workspace.
Optionally, choose agents for this workspace.
Choose CSQs for this workspace.
Choose UCCX applications for this workspace. If no applications are provided, the supervisors of the workspace will not be able to see any applications.
Choose service DN’s (Dialed Numbers) to be available for this workspace. With this, the supervisor(s) of the workspace will only be able to see selected DN’s while creating an easy announcement. If no DN’s are linked with this workspace, the supervisors of the workspace will not see any DN while creating an easy announcement.
Define a folder name for the workspace. If specified, supervisors will only have access to prompts uploaded in the specified folder. If left blank, supervisors will have access to all existing UCCX prompts.
Define a scripts folder name for this workspace. If specified, supervisors will only have access to scripts uploaded in the specified folder. If left blank, supervisors will have access to all existing UCCX scripts.
Only administrators can create new workspaces and have access to the Workspaces list.
Secondary Supervisors can also manage the assigned workspaces.
If an agent/supervisor id is changed from CUCM, the agent will automatically be removed from the workspace it was a part of.
Working within your workspace
Log in as a supervisor. A list of assigned workspaces (if some workspaces are assigned to this supervisor) is available in the Workspaces drop-down on the top right corner of the screen. Switch to any one of the listed workspaces from the drop-down.
Switching between a workspace
Note that switching between workspaces impacts the list of Agents, Queues are shown on the screen and optionally also the Announcements, and applications (if specific DNs and Applications were assigned to this workspace).
Supervisor Tools Finesse gadget
The new Finesse gadget for Cisco Contact Center Express supervisors allows supervisors to manage agent teams, queues, agent skills, calendars and IVR announcements right from within the Supervisor Finesse desktop. The web-based admin application opens up on the Finesse desktop and allows access to a supervisor’s workspace based on the workspaces assigned to him/her.
The application also continues to serve the system administrators as a web-based portal to manage users and permissions.
Single Sign-On (SSO) with Finesse allows SSO-enabled users to log on to the Supervisor Tools gadget automatically as soon as they log on to the Finesse desktop.
Supervisor Finesse Gadget
This interface lists all existing UCCX agents or agents in a particular team (if logged in as a supervisor). The list shows all users who have the following one of the following UCCX capabilities:
Supervisors can see their own agents that are assigned to the supervisor workspace while system administrators can see all CCX agents.
To manage agents, navigate the Agents page from the left sidebar. To quickly find an agent, click the search icon on the top and write the name of the agent in the search bar.
To see the detail of an agent profile, click on the name of the agent from the list.
The agent list shows the full name of the agent, agent id and agent extension.
Note that the name of the agent, agent ID and extension cannot be updated from the EF tool. These parameters can only be updated from CUCM.
Change an agent’s profile such as the profile picture, skill(s), workspace (team) and agent group (resource group in CCX) as per the needs of the business. Note that the profile pictures are only for the visual aid and are internal to the EF tool.
To change a skill competence level of an agent, click on the three dots appearing against the Skills dropdown. Select the skills that are to be assigned to the agent. Once a skill is selected, click the pencil icon to edit the skill competence level. Move the competence level slider back and forth on a scale from 1 to 10 to adjust the skill competence level of the agent.
Update Agent Profile
Click the ‘tick’ icon to save your changes. Click ‘cross’ to cancel it.
The newly updated agent by default goes to the bottom of the list.
Agent ‘alias’ field is currently not available in Supervisor Tools.
Only JPEG images are supported for agent profile pictures.
It takes a few mins to reflect new agents added on UCCX/CUCM to be shown on the EF tool.
If you cannot see any changes, try refreshing the list by navigating to some other page and getting back to the desired page.
Navigate to Queues from the left sidebar to see a list of existing Contact Service Queues (CSQs). Supervisors can see CSQs assigned to their workspaces (based on the workspace selection).
As seen in the picture above, some of the CSQs are shown in green while others are shown in blue colour. This colour differentiator provides a visual aid to determine the type of the CSQ, hence, CSQs in green are “Resource Group-based” while those in blue are “skill-based” queues.
To quickly find a queue, click the search icon on the top and write the name of the queue in the search bar.
To add a new queue, click on the ‘+’ icon on the Queues list.
Adding a queue
For a SKILL GROUP based queue, start adding skills in the queue by clicking Add Skills option in the queue. This logically groups all agents having that skill in the queue.
For a RESOURCE_GROUP based CSQ, select one agent group to be assigned to the CSQ. See how to add agent groups in Groups and Skills. Note that there is a one-one mapping between CSQs and agent groups.
Once a queue is added, other queue attributes such as wrapup time, service level, service level percentage can be changed by editing the queue. Click the three dots to see the Edit option.
Changing a queue settings
You can move agents between the agent-based CSQs (i.e. queues of type Resource Group) if and when required. For instance, if you quickly want to reskill your agents in the peak hours to handle increased call volume on a queue, you just drag agents from one queue and drop it to the affected queue to handle calls on that queue. This eliminates the need to visit UCCX web administration to change agent groups for them to handle additional calls.
For an agent-based queue, agents in the agent group automatically become a member of the CSCQ. To manually add an agent to a queue, Click Add Agent or move an agent from some queue and drop it to this queue.
To remove an agent from a CSQ, hover your mouse on the agent name. Click the delete icon to remove it from the queue.
Changes to the order of agents within a CSQ reflect neither in UCCX nor in Supervisor Tools.
If an agent/supervisor id is changed from CUCM, the agent will automatically be removed from the team it was a part of.
You cannot edit the skill level of skill once added to the queue.
Set up new CCX applications by navigating to the Applications link from the left sidebar. As a supervisor, you can see all the applications that are assigned to your workspace by the administrator. Any applications that you create are automatically assigned to the workspace in which you are logged in.
Add necessary details to create a UCCX application in Supervisor Tools. Fill in the details using the following table:
Enter the name of the application. Note that the name must consist of at least 3 and should not exceed more than 30 characters. Spaces and special characters are not allowed in the name of the application.
Enter the number of sessions.
Enter the id of the application. Note that the id must be unique across all applications.
Choose to enable or disable the application. If the application is not enabled, the expected functionality would not work.
Choose a UCCX script. If you are logged on as a supervisor, you’d only be able to see scripts uploaded in your workspace.
Creating a new application
Once an application has been created, add a CCX trigger to the application.
The script variables are script parameters and are only shown if these are defined in the Scripts list. See the Managing Scripts section to see how to define the script parameters of a script.
To quickly find an application, click the search icon on the top and write the name of the application in the search bar.
As a supervisor, new applications are created within your own workspace.
Spaces in the name of an application are not allowed.
Once a script is attached with an application, it cannot be changed afterwards
While selecting a script, make sure that the script does not contain any errors.
To change script variables attached to an application, the variables must first be defined within the Supervisor Tools Scripts list.
Upload new UCCX scripts from Supervisor Tools and link them to UCCX applications. Navigate to the Scripts link from the left sidebar.
If you are a supervisor, you’d only be able to see scripts uploaded in the Scripts Folder of your workspace. If the administrator did not define any folder, you’ll be able to see all UCCX scripts.
To upload a new folder, hover your mouse on the ‘+’ icon and click on the folder icon. Click on the other icon to upload a new script file (.aef). Note that one .aef file must not exceed 20Mb in size.
To quickly find a script, click the search icon on the top and write the name of the script in the search bar.
To see details about a particular script or folder, click on it.
Script List Interface
It shows the following details of a script:
Name of the script
Last modified date/time
The date when the script was last updated such as script name or parameters.
Size of the script
The overall size of the script
Location / folder name
The name of the folder in which the script exists
The list of variables added in the script from the EF tool
Using the same interface, UCCX script variables can be defined in order to set their values from UCCX applications. Script variables in Supervisor Tools should be defined with the same name and type as they are defined within the UCCX script. Also, the script variables have to be the script parameters in UCCX (exposed to be updated outside of the script).
Only variables of type Prompt, String and Integer can be defined.
The name of the user who uploaded a script or folder will always remain “Administrator”. This is because UCCX requires administrator access to make changes to the system.
Once a script is attached to an application it will not be deleted
Spaces in folder names are not allowed.
You cannot upload zip files and folders in this interface.
Announcements and Calendars
This interface allows users to add new Agencies, Directory Numbers, Shift Schedule, Services and Regions in Supervisor Tools.
Click on each of the objects listed on the left to add a new instance of it. For instance, click Agencies and the + icon to add a new agency. Similarly, click Regions to add a new region and so on.
To upload CCX prompts, select the Prompts page from the left sidebar.
Prompts List Interface
This interface shows UCCX folders/languages and prompts in each folder.
Please note that uploading prompts on the root folder is not permissible in CCX and so in the EF tool. So while uploading prompts, a subfolder must also be created.
If logged in as a supervisor, prompts uploaded in the supervisor’s workspace will be available. If, however, the administrator did not define any folder in the supervisor’s workspace definition, the supervisor can see all UCCX prompts.
To quickly find a prompt or language folder, click the search icon on the top and write the name of the folder in the search bar.
On the right-hand side of the Prompt list, the following information is shown for a selected folder or prompt.
The type of the item being selected; i.e. either File or Folder.
The total size of the folder or file.
This shows the location of the selected item. For instance, the location of a file “xyz.wav” in “en_US” folder will be shown as “/en_US/”
The name of the user who uploaded a file. Currently, for each prompt that is uploaded, the owner name remains the “Administrator”.
The date or time when the item was recently got updated.
To create a new folder or Upload a prompt file, hover your mouse on the ‘+’ icon on the top of the screen. Click the folder icon to upload a new folder and/or prompt icon to upload a new audio file.
Make sure that the file size of the audio prompt should not exceed 20MB in size.
You can also delete a prompt or download it using the icons shown on the right-hand side of the window.
You cannot upload prompts on the root folder.
To upload prompts in bulk, press and hold the CTRL key and select the prompts to be uploaded.
An existing prompt cannot be overwritten. If you try to do so, the application shows an error.
Managing Easy Announcements
An easy announcement is one or more prompts to be played in IVR. The interface allows managers to create new or change an existing announcement on the fly, e.g they can create an announcement for an unplanned outage. By adding calendar time/date, managers can insert scheduled announcements within a call script.
Easy Announcements List
Create an Easy Announcement
Navigate to the Easy Announcement page from the left sidebar, click on the ‘+’ icon and select General Announcement to create a new easy announcement.
Before creating an easy announcement, the following prerequisites must be fulfilled:
Make sure a DN already exists against which the announcement needs to be created. If not found, ask your administrator to do that or see Calendar Settings if you have the admin rights to add a service.
Make sure a region is already added against which the announcement is to be created. See Calendar Settings if you have the admin rights to add a region or ask your administrator to add it for you. If you do not want to specify a region with an announcement, select the default option ‘Any’.
Make sure the prompts that are supposed to be played as part of the easy announcement are already uploaded to Supervisor Tools. See Manage Prompts learn how to add new prompts. Once the prompt is uploaded through the Prompt Management interface, it will automatically start appearing in the drop-down under Add Announcement window.
If you are an admin and want to create an announcement for a specific workspace, make sure that workspace is already added to the system. See the Managing Workspace/Teams section in the admin guide to understand how to add a new Workspace. If no workspace is mentioned, the announcement will remain available to administrators only. If a workspace is mentioned, supervisors of the workspace would be able to see and change the announcement parameters. If you are a supervisor, you’d not see this field and the announcement would automatically be added to the workspace with which you are logged in.
Fill the form Add Easy Announcement using the following table:
Name of the easy announcement. This is mandatory.
Choose a colour to represent the announcement on the calendar. The default colour is blue.
Choose a service Dialed Number (DN) on which the announcement should be played. So whenever the caller dials this number, he hears the announcement on the IVR as per the IVR specifications. If logged in as a supervisor, you can only view the list of DN’s which were assigned to your workspace by the administrator. See Managing Workspace/Teams for more details.
Choose prompt(s) to be played as part of the easy announcement. See Manage Prompts to learn how to upload prompts in the system. If logged in as a supervisor, you can either view the list of prompts that were uploaded within the Prompts folder of your workspace OR if no Prompts folder is specified in the supervisor workspace, all prompts are accessible to the supervisor. See Managing Workspace/Teams for more details.
Choose a region to specify a region-based announcement, i.e. for callers calling from a particular region.
Choose the workspace in which this easy announcement is to be created. This is optional and only shown if logged on as an administrator.
Choose the start and end date to add scheduled announcements.
Choose the start and end times. Enabled only if the All Day flag is turned off.
Select this option to play the announcement throughout the day.
Set the order of playback. The default value is 1. This is generally useful when there are multiple announcements defined for the same DN and have overlapping schedules. You should specify an order on a range from 1-20 with 1 being highest and 20 being the lowest.
If there are multiple overlapped announcements within the specified schedule, choose how the newly created announcement should be played. Based on the order set above, the next announcement in the list will be played after this new announcement if the Play Next option is selected. If the sequence suggests to Stop, it will stop playing the other announcements coming next in the list after playing this announcement.
Choose to repeat the announcement daily, on particular days of the week or on special days) of the month. Possible options are:
Once the announcement is created, it will appear on the calendar. Multiple instances of an announcement will appear based on the recurrence/repeat settings specified above.
To quickly find an easy announcement, click the search icon on the top and write the name of the announcement in the search bar.
To delete an existing announcement,
Click on the announcement name from the list on the left sidebar.
Click the delete icon in the bottom right corner in the easy announcement pop up window.
Switch between different calendar views such as Monthly, Weekly, Daily to see the desired list of announcements on the calendar.
Always select General announcement while creating an easy announcement.
The announcements of type Holiday and Working are not functional.
As a supervisor, you’d be able to see announcements created within your workspace(s).
An administrator would always have access to all announcements in the system.
If a supervisor has no workspace(s) assigned, he’d have complete access to all announcements in the system.
If an administrator creates an announcement such that there is a conflict between the service DN and workspace selection, the announcement would still be created.
You need to click on the weekly/monthly options to see defined days in an existing announcement.
If a recurrent announcement is deleted, the application will automatically remove all instances of the easy announcement.
If you observe that the changes are not properly being appeared, refresh the page.