Troubleshooting Webex Contact Center users that do not appear as agents
Verified 2026-10-02 · 60 sources · tier 2
Also known as wxcc-users-not-showing-as-agents.
In Webex Contact Center, an agent user account combines a user profile that grants access to the Agent Desktop module with an agent profile that assigns the group of permissions for handling customer interactions 4. Contact Center privileges can be assigned to a user only after that user has been added in Control Hub with Contact Center licence entitlements and synchronised with Contact Center 5247.
How an agent account is built
A contact center user's Contact Center enabled setting is what lets the user access the Agent Desktop and handle customer requests 16. A contact center user's first name, last name and email are edited from Control Hub user management, not from the contact center user settings 33. A contact center user can be assigned to 1 or more teams, chosen from a drop-down list in the user's desktop settings 56.
Webex Contact Center has 5 default user profile types: Licensed Administrator, Unlicensed Administrator, Supervisor, Premium Agent and Standard Agent 38. Administrators who hold a Standard Agent licence are mapped to the Standard Agent user profile 3. If a full administrator role is given to a user who holds a Webex Contact Center Standard licence, the administrative features of the Management Portal are not accessible to that user 31.
A Webex Contact Center desktop profile is a group of permissions and desktop behaviours assigned to specific agents, covering general settings, wrap-up and idle codes, collaborations, voice, agent statistics and desktop timeout 20. We infer that the agent profile field on the contact center user page and the Desktop Profile column in the bulk users CSV probably refer to the same object under an older and a newer name 37.
See also Webex Contact Center Agent Desktop and widgets.
Adding users and assigning licences
Users for Webex Contact Center can be added manually, in bulk with CSV files, or through automatic licence assignment in Control Hub 2.
| Method | Documented limit |
|---|---|
| Manual addition in Control Hub | Up to 25 users at a time 32 |
| Control Hub user CSV | Up to 1000 users 18 |
In the Control Hub user CSV, a Standard Agent licence is assigned by setting the Webex Contact Center Standard column to TRUE, and a Premium Agent licence by setting the Webex Contact Center Premium column to TRUE 17. The Control Hub user CSV does not set Supervisor or Administrator roles for Contact Center, and those roles are updated manually 19.
Before adding Contact Center users, the administrator identifies whether the tenant is on Webex Contact Center 1.0 or the new platform from Contact Center > Settings > General > Service Details, because the licence steps differ 35.
| Platform | Manual licensing control |
|---|---|
| New platform | Licensed agent checkbox with Standard Agent, Premium Agent and Premium Agent - Supervisor Role 34 |
| Webex Contact Center 1.0 | Contact Center checkbox with Standard Agent or Premium Agent, where Premium Agent then offers Agent or Supervisor 60 |
If a user previously created a Webex trial account with their email address, that trial organisation must be deleted before the user can be added to the customer organisation for Contact Center 59. The Provisioning Administrator role in partner organisations cannot perform any Contact Center user management activities 39.
See also Webex Contact Center provisioning through Partner Hub.
Automatic licence assignment
A Control Hub organisation-based automatic licence assignment can be applied to future users only or to existing users 58. Applying a Contact Center automatic licence assignment template to existing users may reset their custom user profiles to the default user profiles 57. If a user receives both Standard and Premium Contact Center licences through membership of multiple groups, the Premium licence applies 36. Cisco advises against putting a user in multiple licence groups because a user requires a single Contact Center licence 42.
Synchronising users
Cisco recommends synchronising Control Hub users with Contact Center as the initial step when an administrator first lands in the Contact Center service in Control Hub 48. Before running Synchronize Users, users must already be added in Control Hub with Contact Center licence entitlements after the Contact Center service is provisioned 52. After an existing user's Contact Center licence is updated, the users must be synchronised with Control Hub using Synchronize Users 46.
The Ways to Add Users article places the Synchronize Users button at Services > Contact Center > Settings > General 50. WarmTransfer's reading of the sources is that the menu label holding Synchronize Users (Settings versus Tenant settings) has probably been renamed across Control Hub releases, so a missing button under one label is not evidence the function was removed 49.
Directory and SSO sources
When a Webex organisation is synchronised with Active Directory, new users are granted the licences selected on their group's licence assignment 1. Without auto-assign licence templates, users newly synchronised by Directory Connector receive only free licences 22. Directory Connector's default incremental synchronisation runs every 30 minutes on versions 3.4 and earlier and every 4 hours on versions 3.5 and later, and the interval can be changed 23. We infer that a user just created in Active Directory may not be available to license or sync into Contact Center for up to the Directory Connector incremental interval, so a same-day missing agent is often a timing issue rather than a configuration error 25.
Directory Connector synchronises account state, so users disabled in Active Directory appear as inactive in the Webex cloud 21. Users deleted through Directory Connector are kept in the Webex cloud identity service for 7 days before permanent deletion 24.
Microsoft lists its Cisco Webex provisioning connector as Preview and notes that Cisco Webex is in Cisco's Early Field Testing phase 28. In that Microsoft Entra ID connector, users assigned with the Default Access role are excluded from provisioning 27. The connector requires the userName attribute, which is also the attribute supported for matching 30. The bearer token used as the Secret Token for the Entra ID to Cisco Webex SCIM connector is valid for 365 days 29.
With Control Hub SSO, the identity provider may map any attribute to uid, but it must match 1 of the user's Webex email addresses at sign-in, and Webex supports up to 5 email addresses per user for this mapping 44. WarmTransfer's reading of the sources is that an agent whose IdP uid value matches none of the email addresses on the licensed Control Hub user cannot be resolved to that contact center user, so fixing the mapping or the user's email is the remedy rather than any Contact Center setting 43.
See also Identity SSO and directory provisioning for UC.
Teams, sites and resource collections
A Webex Contact Center team is associated with a single parent site, and the site cannot be edited after the team is created 55. Teams can be added to a user-profile resource collection only for sites already in that resource collection 40. When adding agents to a team, the drop-down offers only agents that the organisation's administrator has configured for the enterprise 53. A Webex Contact Center team can be deleted only when it is in an inactive state 54.
See also Webex Contact Center queues teams and routing strategies.
Bulk Operations
Webex Contact Center Bulk Operations update Contact Center-specific attributes for users who are already assigned Contact Center entitlements 15. We infer that Contact Center Bulk Operations cannot bring a new person into Contact Center, because the user must first exist in Control Hub with a Contact Center licence, so a bulk user row for an unlicensed email is expected to error 9.
A Bulk Operations CSV request processes at most 5000 rows, and larger loads must be split into separate files and requests 11. Only 1 bulk operation can be active at a time, and while one is in progress, Create Bulk Operation is disabled 10. A job whose CSV had some failing records ends in the status Completed with errors, and the failures are downloaded with Export errors to CSV on the Job Details page, which adds an Error Message column 6. Webex Contact Center purges Bulk Operations jobs older than 1 year 7.
See also Webex Contact Center bulk operations imports and export jobs.
Diagnosing a missing agent
WarmTransfer's reading of the sources is that a user missing from a team's agent drop-down most likely lacks a Contact Center licence, has not been synchronised after licensing, or is not configured as a contact center user 45.
- Confirm the tenant platform from Contact Center > Settings > General > Service Details, because the licence steps differ between Webex Contact Center 1.0 and the new platform 35.
- Confirm the user holds a single Contact Center licence, since Cisco states a user requires a single Contact Center licence and Premium applies when group memberships grant both 4236.
- For directory-synced users, check that a licence template exists, because without auto-assign templates newly synchronised users receive only free licences 22.
- Run Synchronize Users after licensing or changing a licence 46.
- Check that Contact Center enabled is set on the contact center user 16.
- Check that the user's account is not inactive due to being disabled in Active Directory 21.
- If the email is tied to an old Webex trial organisation, delete that trial organisation before adding the user 59.
- For teams, confirm the team's parent site is in the user profile's resource collection, because teams can be added only for sites already in that collection 40.
When checking who is signed in, note that the Signed in users tab does not list users signed in only as supervisors, while users signed in as Supervisor/Agent do appear 41.
See also Troubleshooting Webex Contact Center Agent Desktop sign-in and station login.
Applicability
Applies to: Cisco Webex Contact Center, Cisco Webex Control Hub, Cisco Webex Directory Connector, and Microsoft Entra ID. Deployments: multi-tenant. Sources checked 2026-10-02. The Directory Connector synchronisation interval is documented separately for versions 3.4 and earlier and for versions 3.5 and later 23. The Microsoft Entra ID connector for Cisco Webex is listed by Microsoft as Preview 28.
What remains uncertain
How long Synchronize Users takes to run and how quickly its results propagate is not covered by the sources below. Whether current-platform tenants synchronise users automatically without pressing Synchronize Users is not covered by the sources below. The Agent Desktop error text shown for an SSO uid or email mismatch is not covered by the sources below. An API for inspecting a contact center user record, including its site, teams and profiles, is not covered by the sources below. The current status of Webex Contact Center 1.0 tenants is not covered by the sources below. A catalogue of Bulk Operations user-row error messages is not covered by the sources below. The full set of Contact Center columns in the Control Hub user CSV template is not covered by the sources below. Whether Cisco's Agent Desktop troubleshooting documentation includes provisioning entries is not covered by the sources below.
See also
Related to
- Identity SSO and directory provisioning for UC — Directory Connector and SCIM sync timing and SSO uid matching decide whether and when a Control Hub user exists to be licensed
- Troubleshooting Webex Contact Center Agent Desktop sign-in and station login — A user who is not licensed or synced or not Contact Center Enabled cannot sign in to Agent Desktop; provisioning is upstream of sign-in
- Troubleshooting Webex Contact Center supervisor monitoring and barge-in — User profile permissions and resource collections decide which teams and agents a supervisor can see and monitor
- Webex Contact Center bulk operations imports and export jobs — Bulk Operations update Contact Center attributes of existing licensed users; row and file-size limits apply
Referenced by
- Troubleshooting Webex Contact Center supervisor monitoring and barge-in — User profile permissions and resource collections decide which teams and agents a supervisor can see and monitor
- Webex Contact Center provisioning through Partner Hub — Partner admins added via customer groups lack Contact Center access unless directly assigned
Sources
- 1When a Webex organisation is synchronised with Active Directory, new users are granted the licences selected on their group's licence assignment.Set up automatic license assignments in Control Hub · Group-based licence assignment, directory-synced users · Checked 2026-10-02
- 2Users for Webex Contact Center can be added manually, in bulk with CSV files, or through automatic license assignment in Control Hub.Ways to Add Users for Webex Contact Center · Introduction · Checked 2026-10-02
- 3Administrators who hold a Standard Agent licence are mapped to the Standard Agent user profile.Manage access in Webex Contact Center · User profiles overview, default profile mapping note · Checked 2026-10-02
- 4In Webex Contact Center an agent user account includes a user profile that grants access to the Agent Desktop module and an agent profile that assigns the group of permissions for handling customer interactions.Manage Contact Center Users · Manage contact center users, introduction (agent user account includes) · Checked 2026-10-02
- 5In the Contact Center bulk users CSV, the Desktop Profile column is required when Site and Teams are assigned.CSV definition for bulk operations in Webex Contact Center · Users section, CSV column table, Desktop Profile row · Checked 2026-10-02
- 6A bulk operation job whose CSV had some failing records ends in the status Completed with errors, and the failures are downloaded with Export errors to CSV on the Job Details page, which adds an Error Message column.Bulk Operations in Webex Contact Center · Job statuses; View job details and export errors · Checked 2026-10-02
- 7Webex Contact Center purges Bulk Operations jobs older than one year.Bulk Operations in Webex Contact Center · View bulk operations jobs · Checked 2026-10-02
- 8In the Contact Center bulk users CSV, Email, User Profile and Contact Center Enabled are mandatory columns.CSV definition for bulk operations in Webex Contact Center · Users section, CSV column table · Checked 2026-10-02
- 9Contact Center Bulk Operations cannot bring a new person into Contact Center; the user must first exist in Control Hub with a Contact Center licence, so a bulk user row for an unlicensed email is expected to error.inferredCSV definition for bulk operations in Webex Contact Center · Users section, introduction · Checked 2026-10-02
- 10Only one Webex Contact Center bulk operation can be active at a time; while one is in progress, Create Bulk Operation is disabled.Bulk Operations in Webex Contact Center · Create bulk operation, note · Checked 2026-10-02
- 11A Webex Contact Center Bulk Operations CSV request processes at most 5000 rows; larger loads must be split into separate files and requests.Bulk Operations in Webex Contact Center · Bulk operations CSV limits · Checked 2026-10-02
- 12The Webex Contact Center bulk-operations CSV definition page gives a maximum CSV file size of 10 MB.disputedCSV definition for bulk operations in Webex Contact Center · General limits at top of CSV definition page · Checked 2026-10-02
- 13Webex Contact Center Bulk Operations cannot process CSV files larger than 5 MB.disputedBulk Operations in Webex Contact Center · Bulk operations CSV limits · Checked 2026-10-02
- 14In the Contact Center bulk users CSV, multiple teams for one user are given as pipe-separated values in the Teams column.CSV definition for bulk operations in Webex Contact Center · Users section, CSV column table, Teams row · Checked 2026-10-02
- 15Webex Contact Center Bulk Operations update Contact Center-specific attributes for users who are already assigned Contact Center entitlements.CSV definition for bulk operations in Webex Contact Center · Users section, introduction · Checked 2026-10-02
- 16The Contact center enabled setting on a contact center user is the setting that lets the user access the Agent Desktop and handle customer requests.Manage Contact Center Users · Edit contact center users, Contact center enabled field description · Checked 2026-10-02
- 17In the Control Hub user CSV, a Standard Agent licence is assigned by setting the Webex Contact Center Standard column to TRUE and a Premium Agent licence by setting the Webex Contact Center Premium column to TRUE.Ways to Add Users for Webex Contact Center · Add Multiple Users in Webex Control Hub · Checked 2026-10-02
- 18Adding Webex Contact Center users through the Control Hub user CSV handles up to 1000 users.Ways to Add Users for Webex Contact Center · Introduction (manual and CSV limits) · Checked 2026-10-02
- 19The Control Hub user CSV does not set Supervisor or Administrator roles for Contact Center; those roles are updated manually.Ways to Add Users for Webex Contact Center · Add Multiple Users in Webex Control Hub · Checked 2026-10-02
- 20A Webex Contact Center desktop profile is a group of permissions and desktop behaviours assigned to specific agents, covering general settings, wrap-up and idle codes, collaborations, voice, agent statistics and desktop timeout.Manage desktop profiles · Desktop profiles overview · Checked 2026-10-02
- 21Directory Connector synchronises account state, so users disabled in Active Directory appear as inactive in the Webex cloud.Deployment Guide for Directory Connector · Account state synchronisation passage · Checked 2026-10-02
- 22Without auto-assign licence templates, users newly synchronised by Directory Connector receive only free licences.Deployment Guide for Directory Connector · Licence assignment for synchronised users passage · Checked 2026-10-02
- 23Directory Connector's default incremental synchronisation runs every 30 minutes on versions 3.4 and earlier and every 4 hours on versions 3.5 and later, and can be changed.Deployment Guide for Directory Connector · Synchronization schedule passage · Checked 2026-10-02
- 24Users deleted through Directory Connector are kept in the Webex cloud identity service for 7 days before permanent deletion.Deployment Guide for Directory Connector · Deleted users passage · Checked 2026-10-02
- 25A user just created in Active Directory may not be available to license or sync into Contact Center for up to the Directory Connector incremental interval, so a same-day missing agent is often a timing issue rather than a configuration error.inferredDeployment Guide for Directory Connector · Synchronization schedule passage; read with ngc1xsy Sync Users prerequisite · Checked 2026-10-02
- 26Contact center users are listed and edited in Control Hub under Services > Contact Center > User management > Contact center users, with active and inactive filters.Manage Contact Center Users · Search and filter contact center users; Edit contact center users (procedure steps) · Checked 2026-10-02
- 27In the Microsoft Entra ID provisioning connector for Cisco Webex, users assigned with the Default Access role are excluded from provisioning.Configure Cisco Webex for automatic user provisioning with Microsoft Entra ID · Assigning users to Cisco Webex > Important tips for assigning users to Cisco Webex · Checked 2026-10-02
- 28Microsoft lists its Cisco Webex provisioning connector as Preview and notes that Cisco Webex is in Cisco's Early Field Testing phase.Configure Cisco Webex for automatic user provisioning with Microsoft Entra ID · Introduction note; Connector limitations · Checked 2026-10-02
- 29The bearer token used as the Secret Token for the Entra ID to Cisco Webex SCIM connector is valid for 365 days.Configure Cisco Webex for automatic user provisioning with Microsoft Entra ID · Configuring automatic user provisioning to Cisco Webex, step 7 · Checked 2026-10-02
- 30The Microsoft Entra ID provisioning connector for Cisco Webex requires the userName attribute, which is also the attribute supported for matching.Configure Cisco Webex for automatic user provisioning with Microsoft Entra ID · Configuring automatic user provisioning to Cisco Webex, step 12 attribute table · Checked 2026-10-02
- 31If a full administrator role is given to a user who holds a Webex Contact Center Standard licence, the administrative features of the Management Portal are not accessible to that user.Webex Contact Center administrator roles and privileges · Full Administrator role description, note · Checked 2026-10-02
- 32Manual addition of Webex Contact Center users in Control Hub handles up to 25 users at a time.Ways to Add Users for Webex Contact Center · Introduction (manual and CSV limits) · Checked 2026-10-02
- 33A contact center user's first name, last name and email are edited from Control Hub user management, not from the contact center user settings.Manage Contact Center Users · Edit contact center users, note on name and email · Checked 2026-10-02
- 34On the new Webex Contact Center platform, manual licensing uses a Licensed agent checkbox with the options Standard Agent, Premium Agent and Premium Agent - Supervisor Role.Ways to Add Users for Webex Contact Center · Add Multiple Users in Webex Control Hub / manual steps for the new platform · Checked 2026-10-02
- 35Before adding Contact Center users, the administrator identifies whether the tenant is on Webex Contact Center 1.0 or the new platform from Contact Center > Settings > General > Service Details, because the licence steps differ.Ways to Add Users for Webex Contact Center · Identify the Webex Contact Center Platform · Checked 2026-10-02
- 37The agent profile field on the contact center user page and the Desktop Profile column in the bulk users CSV probably refer to the same object under an older and a newer name.inferredManage desktop profiles · Desktop profiles overview; compared with nzk6tpp Desktop settings and imku7e Users CSV table · Checked 2026-10-02
- 38Webex Contact Center has five default user profile types: Licensed Administrator, Unlicensed Administrator, Supervisor, Premium Agent and Standard Agent.Manage access in Webex Contact Center · User profiles overview, default profile list · Checked 2026-10-02
- 39The Provisioning Administrator role in partner organisations cannot perform any Contact Center user management activities.Webex Contact Center administrator roles and privileges · Provisioning Administrator role description · Checked 2026-10-02
- 40Teams can be added to a user-profile resource collection only for sites already in that resource collection.Manage access in Webex Contact Center · Resource collections section · Checked 2026-10-02
- 41The Signed in users tab of contact center user management does not list users signed in only as supervisors; users signed in as Supervisor/Agent do appear.Manage Contact Center Users · Force sign out section, note on the Signed in users tab · Checked 2026-10-02
- 42Cisco advises against putting a user in multiple licence groups because a user requires a single Contact Center licence.Ways to Add Users for Webex Contact Center · Automatic license assignment note · Checked 2026-10-02
- 43An agent whose IdP uid value matches none of the email addresses on the licensed Control Hub user cannot be resolved to that contact center user, so fixing the mapping or the user's email is the remedy rather than any Contact Center setting.inferredSingle Sign-On Integration in Control Hub · uid attribute mapping passage; read with nzk6tpp note that name and email are edited in Control Hub · Checked 2026-10-02
- 44With Control Hub SSO the identity provider may map any attribute to uid, but it must match one of the user's Webex email addresses at sign-in, and Webex supports up to 5 email addresses per user for this mapping.Single Sign-On Integration in Control Hub · uid attribute mapping passage · Checked 2026-10-02
- 45A user missing from a team's agent drop-down most likely lacks a Contact Center licence, has not been synchronised after licensing, or is not configured as a contact center user.inferredManage teams in Webex Contact Center · Create a team, Agent settings; read with ngc1xsy Sync Users section · Checked 2026-10-02
- 46After an existing user's Contact Center licence is updated, the users must be synchronised with Control Hub using Synchronize Users.Ways to Add Users for Webex Contact Center · Add Users Manually in Cisco Webex Contact Center 1.0, note after licence steps · Checked 2026-10-02
- 47Synchronising Control Hub users with Contact Center is necessary before Contact Center privileges can be assigned to those users.Set up a tenant in Webex Contact Center · Sync Users section · Checked 2026-10-02
- 48Cisco recommends synchronising Control Hub users with Contact Center as the initial step when an administrator first lands in the Contact Center service in Control Hub.Set up a tenant in Webex Contact Center · Sync Users section, opening sentence · Checked 2026-10-02
- 49The menu label that holds Synchronize Users (Settings versus Tenant settings) has probably been renamed across Control Hub releases, so a missing button under one label is not evidence the function was removed.inferredSet up a tenant in Webex Contact Center · Sync Users section, compared with Ways to Add Users synchronisation note · Checked 2026-10-02
- 50The Ways to Add Users article places the Synchronize Users button at Services > Contact Center > Settings > General.Ways to Add Users for Webex Contact Center · Add Users Manually, synchronisation note · Checked 2026-10-02
- 51The tenant setup article places Synchronize Users at Services > Contact Center > Tenant settings > General.Set up a tenant in Webex Contact Center · Sync Users section, procedure · Checked 2026-10-02
- 52Before running Synchronize Users, users must already be added in Control Hub with Contact Center licence entitlements after the Contact Center service is provisioned.Set up a tenant in Webex Contact Center · Sync Users section, prerequisite · Checked 2026-10-02
- 53When adding agents to a team, the drop-down offers only agents that the organisation's administrator has configured for the enterprise.Manage teams in Webex Contact Center · Create a team, Agent settings · Checked 2026-10-02
- 54A Webex Contact Center team can be deleted only when it is in an inactive state.Manage teams in Webex Contact Center · Delete a team · Checked 2026-10-02
- 55A Webex Contact Center team is associated with a single parent site, and the site cannot be edited after the team is created.Manage teams in Webex Contact Center · Create a team, Parent Site field · Checked 2026-10-02
- 56A contact center user can be assigned to one or more teams, chosen from a drop-down list in the user's desktop settings.Manage Contact Center Users · Edit contact center users, Desktop settings, Teams field · Checked 2026-10-02
- 57Applying a Contact Center automatic licence assignment template to existing users may reset their custom user profiles to the default user profiles.Ways to Add Users for Webex Contact Center · Automatic license assignment warning · Checked 2026-10-02
- 58A Control Hub organisation-based automatic licence assignment can be applied to future users only or to existing users.Set up automatic license assignments in Control Hub · Configure organization-based automatic licensing for users · Checked 2026-10-02
- 59If a user previously created a Webex trial account with their email address, that trial organisation must be deleted before the user can be added to the customer organisation for Contact Center.Ways to Add Users for Webex Contact Center · Add Users Manually, trial account note · Checked 2026-10-02
- 60On Webex Contact Center 1.0, manual licensing uses a Contact Center checkbox with Standard Agent or Premium Agent, and Premium Agent then offers Agent or Supervisor.Ways to Add Users for Webex Contact Center · Add Users Manually in Cisco Webex Contact Center 1.0 · Checked 2026-10-02
Documents
Bulk Operations in Webex Contact Center
Configure Cisco Webex for automatic user provisioning with Microsoft Entra ID
CSV definition for bulk operations in Webex Contact Center
Deployment Guide for Directory Connector
Manage access in Webex Contact Center
Manage Contact Center Users
Manage desktop profiles
Manage teams in Webex Contact Center
Set up a tenant in Webex Contact Center
Set up automatic license assignments in Control Hub
Single Sign-On Integration in Control Hub
Ways to Add Users for Webex Contact Center
Webex Contact Center administrator roles and privileges
Cite this page
APA
WarmTransfer. (2026, October 2). Troubleshooting Webex Contact Center users that do not appear as agents. WarmTransfer. https://warmtransfer.net/knowledge/wxcc-user-provisioning-troubleshooting
BibTeX
@misc{warmtransfer-wxcc-user-provisioning-troubleshooting,
title = {Troubleshooting Webex Contact Center users that do not appear as agents},
author = {{WarmTransfer}},
year = {2026},
url = {https://warmtransfer.net/knowledge/wxcc-user-provisioning-troubleshooting},
note = {Verified 2026-10-02}
}