Migrate Cisco Unified Contact Center Express to Webex Contact Center

Publisher

Cisco Systems, Inc. (Webex Help Center)

URL

https://help.webex.com/en-us/article/0hd75db/Migrate-Cisco-Unified-Contact-Center-Express-to-Webex-Contact-Center

Published

2025-06-27

Updated

unknown

Accessed

2026-09-05

HTTP status

200

License

Cisco proprietary documentation, all rights reserved; no-redistribution; short excerpts and locators only

Source notes citing this source

• Cisco specifies a recommended CSV import order for UCCX-to-Webex Contact Center migration to avoid dependency errors. It starts with MultimediaProfiles.csv and Site.csv, then covers profiles, skills, teams, entry points and queues, and ends with Users.csv. in context
• The Cisco UCCX migration article lists configuration entities (profiles, skills, teams, entry points, queues, users) and prompts as tool output but does not list CCX scripts, which suggests CCX script logic has to be rebuilt as Webex Contact Center flows rather than converted automatically. inferred in context
• Cisco says the UCCX migration tool is still evolving and may not support all of the latest features. in context
• Cisco's UCCX-to-Webex Contact Center discovery tool (v3.5) extracts CCX configuration into an Excel workbook for review and editing, plus a zip file of audio prompts for bulk upload. in context
• Webex Contact Center bulk operations limit each import CSV file to 5000 rows. in context
• No Cisco-documented automated tool that reads Unified CCE configuration and writes Webex Contact Center objects was found; UCCE objects must be mapped and built by the migration team or a third-party tool. inferred in context
• The UCCX migration tool article enumerates the Webex Contact Center configuration objects it creates, including multimedia profiles, sites, user profiles, auxiliary codes, agent profiles, skill definitions, skill profiles, teams, entry points, queues, entry point mappings and users. in context
• Cisco states that its migration tool is continuously evolving and may not support all the latest features. in context
• Cisco's documented Webex Contact Center migration discovery tool article covers migration from Unified Contact Center Express, not from Unified CCE. in context
• Cisco's migration article warns that Bulk Operations limits any import CSV file to 5000 rows, which bounds how much of a discovery export can be imported in a single request. in context
• The discovery tool requires Cisco Unified CCX administrator credentials, which it prompts for as a mandatory username and password. in context
• The Agent Profile sheet's documented columns include Parent Site, Wrap Up Type, Auto Wrap Up Time, Outdial Enabled, Outdial EP, Outdial ANI, Dial Plan Enabled and DN Validation Option. in context
• The discovery tool saves the configuration details supplied at the prompts into a file named application-pro.yml, which the operator may edit before a later run. in context
• Cisco's migration article has exactly three content sections: 'Prepare for migration', 'Run the discovery tool for migration' and 'Device discovery guidelines'. in context
• Cisco's migration article carried a printed last-updated date of June 27 2025 when accessed on 22 September 2026. in context
• If no port is supplied to the discovery tool, it uses 443 as the default port. in context
• The migration article's download link points to a Cisco software special-release URL, https://software.cisco.com/download/specialrelease/9b808a0869aefbfc8b168b7e9ec75f85, rather than to the ordinary Cisco software download catalogue. in context
• Cisco's migration article instructs the reader to download discovery tool version v3.5 from the Cisco software download site as a prerequisite to migration. in context
• The Entry Point sheet's documented columns include Timezone, Channel Type and Social Channel Type. in context
• Cisco warns in the migration article that the migration tool is continuously evolving and may not currently support all the latest features. in context
• Extraction is invoked with the command 'java -jar uccx-to-webexcc-v3.4.jar -extract'. in context
• A successful -extract run creates WebexCC_Bulk_Upload.xlsx and WebexCC_Bulk_Upload_Prompts.zip inside a folder named WebexCC Bulk Upload. in context
• The 'Device discovery guidelines' section is a per-sheet table giving column names, sample values and descriptions for each exported entity, and is Cisco's most detailed published mapping between UCCX configuration and Webex Contact Center fields. in context
• Cisco specifies an order in which the exported sheets must be imported, beginning with MultimediaProfiles, Site and UserProfiles and ending with EntryPointMappings, OutdialANI and Users. in context
• Cisco's UCCX to Webex Contact Center discovery tool is distributed as a single Java archive whose filename carries its version, written as uccx-to-webexcc-v3.4.jar in the command examples of Cisco's migration article. in context
• The discovery tool requires a system running Java 8 or above. in context
• The documented procedure requires the operator to edit and validate WebexCC_Bulk_Upload.xlsx against the intended Webex Contact Center design, and to save it under the same filename, before running -zip. in context
• Running the discovery tool's -extract mode requires a mandatory migration password, which the tool prompts for before any other input. in context
• The Multimedia Profile sheet's documented columns include Mode, Voice, Chat, Email and Social Channel. in context
• The discovery tool's output schema contains no worksheet for UCCX scripts, applications or triggers, so call-flow logic is not carried by the tool and must be rebuilt separately in Webex Contact Center. inferred in context
• Cisco's migration article names no supported or required Cisco Unified CCX release for the discovery tool. in context
• The Outdial Queue sheet's documented columns include Channel Type, Max Time in Queue, Service Level Threshold, Timezone, Outbound Campaign Enabled, Routing Type, Default Music in Queue, Distribution Group and Group Teams. in context
• Cisco's migration article does not state how a reader obtains the migration password; the words partner, Cisco account team and helpdesk do not appear on the page. in context
• Cisco lists a set-up Webex Contact Center tenant as a prerequisite that must exist before the discovery tool is run. in context
• Cisco lists creating users in Control Hub and synchronising them for Contact Center as prerequisites that must be completed before the discovery tool is run. in context
• The -extract mode prompts for a mandatory domain name of the UCCX environment. in context
• The -extract mode prompts for a mandatory host name, given as the hostname or IP address of the UCCX server. in context
• The port input to the -extract mode is optional. in context
• The audio files packaged in WebexCC_Bulk_Upload_Prompts.zip are imported into Webex Contact Center through Bulk Operations. in context
• The Queue sheet's documented columns include Channel Type, Routing Type, Skill Based Agent Selection, Max Time in Queue, Service Level Threshold, Timezone, Default Music in Queue, Distribution Group, Group Seq, Group Fallback Time and Group Teams. in context
• Because the tool's only server-side inputs are a hostname, an optional web-server port defaulting to 443 and UCCX administrator credentials, it reads UCCX configuration over the UCCX web interface rather than by direct database access. inferred in context
• The discovery tool must be run from a system that has network access to the Cisco Unified CCX server it is reading. in context
• The discovery tool's spreadsheet covers seventeen Webex Contact Center configuration entities: MultimediaProfiles, Site, UserProfiles, WorkTypes, AuxiliaryCodes, AgentProfiles, AddressBook, SkillDefinition, SkillProfile, Team, EntryPoint, OutdialEntryPoint, Queues, OutdialQueue, EntryPointMappings, OutdialANI and Users. in context
• The Skill Definition sheet's documented columns include Type and a list of values for enumerated skills. in context
• Setting skipPrompts: true in application-pro.yml skips prompt extraction, and the tool extracts prompts by default when skipPrompts is false. in context
• The Team sheet's documented columns include Site, Multimedia Profile, Type, Skill Profile, Capacity and Desktop Layout. in context
• The User sheet's documented columns include Email, User Profile, Contact Center Enabled, Site, Multimedia Profile, Skill Profile, Agent Profile and Teams. in context
• Cisco's migration article is internally inconsistent about the tool version: its prerequisite section directs the reader to v3.5 while its command examples invoke uccx-to-webexcc-v3.4.jar. in context
• Packaging is invoked with the command 'java -jar uccx-to-webexcc-v3.4.jar -zip', which is a separate second invocation of the same jar. in context
• A successful -zip run creates WebexCC_Bulk_Upload.zip within the WebexCC Bulk Upload folder, and this archive is the artefact imported into Webex Contact Center. in context
• The Cisco UCCX-to-Webex-Contact-Center migration article describes only configuration migration and does not describe migrating historical reporting data, call detail records or CUIC report definitions. inferred in context
• The Cisco discovery tool for migrating Unified CCX to Webex Contact Center extracts configuration entities such as sites, users and user profiles, work types and auxiliary codes, skill definitions and profiles, teams, entry points, queues, address books and audio prompts, and emits a bulk upload workbook and a prompts archive. in context
• The Cisco UCCX to Webex Contact Center discovery tool extracts UCCX audio prompts as .wav files. in context
• Output from the UCCX discovery tool must be edited by hand to align the extracted UCCX configuration with the intended Webex Contact Center design before it is loaded through bulk operations. in context
• The Cisco UCCX to Webex Contact Center discovery tool extracts configuration for multimedia profiles, sites, user profiles, work types, auxiliary codes, agent profiles, address books, skill definitions, skill profiles, teams, entry points, outdial entry points, queues, outdial queues and users, and generates files for bulk import. in context
• The UCCX discovery tool requires Java 8 or above, network access to the Cisco Unified CCX server and administrator credentials. in context
• Cisco publishes no automated converter from a Unified CCX script to a Webex Contact Center flow: the migration documentation's object list covers routing and resource configuration only, so call-handling logic has to be rebuilt in Flow Designer. inferred in context
• Cisco states that the UCCX migration tool is continuously evolving and may not currently support all the latest features. in context
• A Unified CCX agent maps onto a Webex Contact Center user carrying a user profile and a desktop profile, which the discovery workbook represents as separate Users, UserProfiles and AgentProfiles sheets. inferred in context
• Unified CCX prompts map onto Webex Contact Center audio files, carried by the discovery tool as a ZIP of WAV files imported through bulk operations. inferred in context
• A Unified CCX resource group has no single Webex Contact Center equivalent object, and the discovery tool workbook contains no resource group sheet. inferred in context
• The Cisco migration article for Unified CCX to Webex Contact Center contains no two-column table mapping Unified CCX object names to Webex Contact Center object names; the only structured mapping it publishes is from workbook sheet names to bulk-upload columns. inferred in context
• Cisco states that the Unified CCX migration tool is continuously evolving and may not currently support all the latest features. in context
• The Cisco migration article documents no conversion of Unified CCX applications or scripts into Webex Contact Center flows, and the discovery tool workbook has no sheet for either object. inferred in context
• The Unified CCX discovery tool produces two artefacts for Webex Contact Center: WebexCC_Bulk_Upload.xlsx and WebexCC_Bulk_Upload_Prompts.zip. in context
• Running the Unified CCX discovery tool requires a system with Java 8 or above, network access to the Cisco Unified CCX server, and Unified CCX administrator credentials. in context
• The Unified CCX discovery tool workbook contains sheets for Multimedia Profiles, Sites, User Profiles, Work Types, Auxiliary Codes, Agent Profiles, Address Books, Skill Definitions, Skill Profiles, Teams, Entry Points, Outdial Entry Points, Queues, Outdial Queues, Entry Point Mappings, Outdial ANI and Users. in context
• The documented discovery-tool workflow is to run the tool with an extract flag against the Unified CCX server, hand-edit the generated workbook to the Webex Contact Center design, re-run the tool with a zip flag, and import the result through Bulk Operations in Control Hub. in context
• The Control Hub article on migrating from Cisco Unified Contact Center Express to Webex Contact Center covers the discovery tool, configuration extraction and bulk upload, and carries no PSTN, SIP trunk, CUBE or codec guidance. in context
• The discovery tool's extract phase is run from the command line as java -jar uccx-to-webexcc-v3.4.jar -extract, supplying the migration password, domain, hostname and port as inputs. in context
• The discovery tool's extract phase produces application-pro.yml, WebexCC_Bulk_Upload.xlsx and WebexCC_Bulk_Upload_Prompts.zip. in context
• The UCCX discovery tool requires a system with Java 8 or above, network access to the Cisco Unified CCX server, and the administrator username and password of the Unified CCX application. in context
• The UCCX to Webex Contact Center migration uses discovery tool v3.5, downloaded from the Cisco software download portal. in context
• After the extracted workbook is edited to match the Webex Contact Center design, the tool's -zip phase packages the edited configuration into the final migration package. in context
• The migration article prescribes a CSV import order to prevent dependency errors: MultimediaProfiles, Site, UserProfiles, WorkTypes, AuxiliaryCodes, AgentProfiles, AddressBook, SkillDefinition, SkillProfile, Team, EntryPoint, OutdialEntryPoint, Queues, OutdialQueue, EntryPointMappings, OutdialANI, then Users. in context
• Before the UCCX migration data can be bulk-loaded, the Webex Contact Center tenant must be set up and users must be added and synchronized through Control Hub. in context
• Cisco states that the UCCX migration tool is continuously evolving and may not currently support all the latest Webex Contact Center features. in context
• Webex Contact Center bulk operations limit any import file to 5,000 rows and larger datasets must be split across multiple files. in context
• Cisco publishes a required import order for the discovery tool's generated files to avoid dependency errors, beginning with multimedia profiles, sites and user profiles and ending with entry point mappings, outdial automatic number identification and users. in context
• Cisco publishes a first-party downloadable discovery tool, a Java application run against the Unified CCX server, that generates bulk upload spreadsheets for Webex Contact Center. in context
• Cisco warns that the migration tool is continuously evolving and may not currently support all the latest features. in context
• The migration article instructs downloading discovery tool version 3.5 while every command example in the same article invokes a version 3.4 archive. in context

Cite this source record

APA

WarmTransfer. (2025, June 27). Migrate Cisco Unified Contact Center Express to Webex Contact Center. WarmTransfer. https://warmtransfer.net/knowledge/sources/cisco-help-0hd75db-migrate-uccx-to-wxcc

BibTeX

@misc{warmtransfer-cisco-help-0hd75db-migrate-uccx-to-wxcc,
  title  = {Migrate Cisco Unified Contact Center Express to Webex Contact Center},
  author = {{WarmTransfer}},
  year   = {2025},
  url    = {https://warmtransfer.net/knowledge/sources/cisco-help-0hd75db-migrate-uccx-to-wxcc},
  note   = {Cisco Systems, Inc. (Webex Help Center), accessed 2026-09-05}
}