UCCX scripts and Flow Designer flows
Verified 2026-09-22 · 59 sources · tier 2–4
Also known as aef-script-to-flow, flow-designer-redesign, uccx-editor-to-flow-designer, uccx-script-conversion.
Cisco Unified CCX Editor scripts and Webex Contact Center Flow Designer flows represent distinct paradigms for call routing and workflow execution 2224.
UCCX Script Architecture
The Cisco Unified CCX Editor provides a graphical programming environment for creating, modifying, validating, and debugging telephony and multimedia application scripts 22. Unified CCX script steps are written in Java, although Cisco states that an author does not need to understand Java programming to build a script 49. A script is associated with an application and runs when the application's associated trigger is dialled 47.
Cisco documents 3 categories of variables available to a Unified CCX script: local script variables, Cisco predefined enterprise call variables, and Expanded Call Context variables 58. Local script variables are defined in the Variable pane of the Unified CCX Editor and belong to the individual script 39. Exchanging data between a local script variable and an ICME script requires the Set Enterprise Call Info and Get Enterprise Call Info steps 21.
For modular design, the Call Subflow step invokes another script from within a main script 7. Its General tab controls the target script and interruption settings, while the Input Mappings and Output Mappings tabs carry data 7. In an input mapping, a main-script variable can map only to a subflow variable of the same type 54. Any valid expression can be passed, and Unified CCX evaluates all input expressions before invoking the subflow, storing the results in the named subflow variables 51.
Direct SQL operations in Unified CCX rely on the Database palette, which provides 4 steps: DB Read, DB Get, DB Write, and DB Release 12. These database steps require either a Cisco Unified IP IVR or a Cisco Unified CCX Premium license 11. Additionally, the database subsystem and a Data Source Name must be configured before these steps function in a script 10.
Flow Designer Architecture
Flow Designer organizes its activity library into 4 groups: Contact Handling, Flow Control, Utilities, and Voice 24. Voice flows are managed in Flow Designer, whereas digital channel flows are created in Flow Builder within Webex Connect 16.
External system integration in Flow Designer is handled through the Utilities group 3745. The HTTP Request activity acts as the external interface and allows target systems to be configured centrally in Control Hub as custom connectors 3736. A Parse activity extracts values from structured responses 45. To replicate direct database queries, Cisco provides the CiscoDevNet webexcc-dbconnector sample, a Spring Boot REST service that fronts a SQL database so Flow Designer can query it via the HTTP Request activity 15.
Flow Designer supports multiple variable classes, including custom flow variables, predefined variables, global variables, and JSON variables 38. Predefined variables include activity output variables and event output variables, which are populated after an activity executes 1. Expressions inside flows use Pebble template syntax, complemented by Cisco-documented custom Pebble filters 46. For advanced tasks, Flow Designer includes a managed Functions object that enables data manipulation and automation via scripting languages such as Python 2930.
Global variables are configured centrally under Flows > Global Variables in Control Hub and are accessible across flows 34. Digital flows in Flow Builder also support global variables alongside custom flow variables 16. Up to 100 global variables can be enabled for reporting simultaneously 33. Cisco instructs administrators not to store secure data, such as credit card numbers, personal identification numbers, or social security numbers, in global variables because historical reporting users can view their values 35. A global variable can also be presented on the agent Desktop with a custom label, and if Edit on Desktop is configured, an agent can edit the value during the session 32.
Flow Designer handles modularity through the Subflow and GoTo activities 4050. The Subflow activity executes reusable logic, accepts inputs, and returns outputs to the main flow 50. While developers can map a main flow's global variable to a subflow local variable, global variables cannot be added directly inside a subflow 52. Subflows support a "Propagate changes to all flows" setting to push updates out to every flow using that subflow 53.
Operational Safeguards and Lifecycle Management
Webex Contact Center enforces loop-prevention safeguards and validation requirements prior to execution 5748. Flows must be validated and all errors resolved before publishing; the Publish control remains disabled while errors exist 57. To guard against runaway execution, Webex Contact Center enforces per-activity self-loop limits: 48
Flow Designer includes built-in Copy flow, Export flow, and Import flow actions 239. Cisco distributes official flow template samples as JSON files 55. Flows themselves are not supported configuration types in Webex Contact Center Bulk Operations, which restricts other configurations to 5000 rows per CSV request, a 5 MB CSV file limit, and a 50 MB limit for audio ZIP archives 65.
Version labels such as Dev, Test, and Live can be assigned to flows to facilitate blue-green promotions at the entry point 59. On 29 July 2026, Cisco announced Flow V2 APIs alongside a public Flow schema on the Webex Contact Center Developer Portal 27. These APIs allow teams to author flows programmatically, and to search, validate, publish, export, lock, and unlock flows, subflows, and functions 2728.
Migration Considerations
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, generating bulk import files 19. It also extracts UCCX audio prompts as .wav files 17. The tool requires Java 8 or above, network access to the Cisco Unified CCX server, and administrator credentials 20. Cisco notes that the discovery tool evolves continuously and may not cover all recent features 56.
Field reports suggest that a UCCX to Webex Contact Center transition can take 3 to 6 months depending on script volume and environment scale 26. Field reports suggest that on at least one migration the organization opted to preserve and simplify its existing call flow logic rather than redesigning flows during the migration 25.
See also
- See also The UCCX to Webex Contact Center discovery tool.
- See also UCCX objects and their Webex Contact Center equivalents.
- See also Webex Contact Center bulk operations imports and export jobs.
Applicability
Applies to: Cisco Unified Contact Center Express and Cisco Webex Contact Center. Deployments: on-premises and multi-tenant. Sources checked 2026-09-22. The Unified CCX database steps apply specifically to Cisco Unified CCX deployments with IP IVR or Unified CCX Premium licensing 11. Field reports suggest that migration timelines of 3 to 6 months and call flow preservation patterns are reported from deployments in the United States region 2625.
What remains uncertain
Whether the Cisco UCCX discovery tool will support automated conversion or direct translation of Unified CCX Editor scripts into Flow Designer JSON formats is not covered by the sources below.
See also
Depends on
- The UCCX to Webex Contact Center discovery tool — The discovery tool is the only Cisco-supplied migration automation and it carries routing and resource configuration plus .wav prompts; it does not carry script logic. Script redesign starts where the discovery tool stops.
Related to
- UCCX Configuration REST API — The UCCX Configuration API is the read side of an inventory-before-redesign exercise: it enumerates applications and triggers whose scripts have to be rebuilt.
- UCCX historical reporting after a move to Webex Contact Center — Global variables are the reporting carrier in Webex Contact Center and are capped at 100 reportable at a time; which constrains how UCCX script-level reporting fields are reproduced.
- UCCX objects and their Webex Contact Center equivalents — Object-level crosswalk covers queues; skills and teams; this topic covers the executable logic that references them.
- Webex Contact Center bulk operations imports and export jobs — Bulk Operations loads the queues; entry points; teams; skills and audio files that a redesigned flow references; but flows are not a Bulk Operations object type.
Referenced by
- UCCX Configuration REST API — PROPOSED by this packet. The Configuration API exposes script files as repository artefacts and byte downloads only; so script-to-flow redesign work cannot be driven from this API alone.
- The UCCX to Webex Contact Center discovery tool — Provisionally named. The discovery tool's output schema has no worksheet for UCCX scripts or applications; so call-flow logic is out of scope for the tool and is the subject of a separate redesign effort.
- UCCX to Webex Contact Center migration — Step 7 rebuilds UCCX Editor scripts as Flow Designer flows; the activity-by-activity redesign lives in that topic.
- UCCX objects and their Webex Contact Center equivalents — Scripts and applications are the one UCCX object class with no bulk-upload sheet and no documented automatic conversion; that gap is the subject of the script-to-flow redesign topic.
- Telephony during a UCCX to Webex Contact Center migration — The UCCX-performing-call-distribution model requires a redirect step and a DB write step inside the UCCX script; and an HTTP Request node in the Webex CC flow; the script-side detail belongs to that topic.
Sources
- 1Webex Contact Center Flow Designer exposes activity output variables and event output variables as predefined variables that a flow reads after an activity runs.Build and manage flows with Flow Designer · Use variables and expressions > Predefined variables > Event Output Variables; Activity Output Variables · Checked 2026-09-22
- 2Unified CCX scripts are files with the .aef extension, and a subflow is selected by naming its .aef file.The Call Subflow Step - Contact Center Express · The Call Subflow Step > General tab example, which names getNumbersToCall.aef · Checked 2026-09-22
- 3Before the July 2026 Flow V2 announcement there was no public Webex Contact Center API for authoring or managing flows, so bulk or scripted flow work in that period had to go through the Flow Designer user interface.inferredWhat's new for administrators in Webex Contact Center · July 29, 2026 entry, read against the absence of any earlier flow API announcement · Checked 2026-09-22
- 4Webex Contact Center limits an individual audio file to 5,242,880 bytes and total audio storage to 2,097,152,000 bytes.System limits in Webex Contact Center · System limits in Webex Contact Center > Audio file rows · Checked 2026-09-22
- 5Webex Contact Center Bulk Operations accepts at most 5000 rows per CSV request, rejects CSV files larger than 5 MB, and accepts audio-file ZIP archives up to 50 MB.Bulk Operations in Webex Contact Center · Bulk Operations in Webex Contact Center > file limits · Checked 2026-09-22
- 6Flows are not among the configuration object types that Webex Contact Center Bulk Operations can create, modify, import or export.Bulk Operations in Webex Contact Center · Bulk Operations in Webex Contact Center > list of supported configuration object types · Checked 2026-09-22
- 7The Unified CCX Call Subflow step invokes another script from within a script, selecting the target script and an interruption setting on its General tab and carrying data on Input Mappings and Output Mappings tabs.The Call Subflow Step - Contact Center Express · The Call Subflow Step > General, Input Mappings and Output Mappings tabs · Checked 2026-09-22
- 8The Webex Connect Set Variable node for Webex Contact Center supports String, Boolean, Integer, Decimal and Date Time variables, and can add or update at most 30 variables per node.Set Variable - WXCC · Set Variable - WXCC > supported data types and node limits · Checked 2026-09-22
- 9Copy a flow is a documented Flow Designer operation, distinct from export and import.Build and manage flows with Flow Designer · Create and manage flows > Copy a flow · Checked 2026-09-22
- 10Using Unified CCX database steps requires that the database subsystem and a Data Source Name be configured before the steps will work in a script.Database Steps - Contact Center Express · Database Steps > prerequisites · Checked 2026-09-22
- 11The Unified CCX database steps require either a Cisco Unified IP IVR or a Cisco Unified CCX Premium license.Database Steps - Contact Center Express · Database Steps > licensing note · Checked 2026-09-22
- 12The Unified CCX Editor Database palette contains four steps: DB Read, DB Get, DB Write and DB Release.Database Steps - Contact Center Express · Database Steps > palette contents · Checked 2026-09-22
- 13Unified CCX database steps support varchar fields up to 255 characters and do not support varchar(max).Database Steps - Contact Center Express · Database Steps > field length restriction · Checked 2026-09-22
- 14The CiscoDevNet webexcc-dbconnector sample is published under the MIT license and its 2.1.1 release is dated 3 March 2026.CiscoDevNet/webex-contact-center-dbconnector · repository root > LICENSE and Releases · Checked 2026-09-22
- 15Cisco's CiscoDevNet webexcc-dbconnector sample is a Spring Boot REST service that fronts a SQL database so that a Webex Contact Center flow can query it through the HTTP Request activity.CiscoDevNet/webex-contact-center-dbconnector · repository README > overview and usage from Flow Designer · Checked 2026-09-22
- 16Webex Contact Center flows for digital channels are built in Flow Builder in Webex Connect rather than in the voice Flow Designer, and support global variables and custom flow variables.Set up digital channels in Webex Contact Center · Variables support for digital channels · Checked 2026-09-22
- 17The Cisco UCCX to Webex Contact Center discovery tool extracts UCCX audio prompts as .wav files.Migrate Cisco Unified Contact Center Express to Webex Contact Center · Run the discovery tool for migration > audio prompts · Checked 2026-09-22
- 18Output 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.Migrate Cisco Unified Contact Center Express to Webex Contact Center · Run the discovery tool for migration > edit the generated spreadsheet · Checked 2026-09-22
- 19The 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.Migrate Cisco Unified Contact Center Express to Webex Contact Center · Run the discovery tool for migration > migrated object types · Checked 2026-09-22
- 20The UCCX discovery tool requires Java 8 or above, network access to the Cisco Unified CCX server and administrator credentials.Migrate Cisco Unified Contact Center Express to Webex Contact Center · Prepare for migration > prerequisites · Checked 2026-09-22
- 21Moving data between a Unified CCX local script variable and an ICME script requires the Set Enterprise Call Info and Get Enterprise Call Info steps.Using Variables - Contact Center Express · Using Variables > Set and Get Enterprise Call Info steps · Checked 2026-09-22
- 22The Cisco Unified CCX Editor is a graphical programming environment for creating, modifying, validating and debugging telephony and multimedia application scripts.Scripting Overview - Contact Center Express · Scripting Overview > description of the Unified CCX Editor · Checked 2026-09-22
- 23Export a flow and Import a flow are documented Flow Designer operations under Create and manage flows in the Webex Contact Center administrator documentation.Build and manage flows with Flow Designer · Create and manage flows > Export a flow; Create and manage flows > Import a flow · Checked 2026-09-22
- 24The Webex Contact Center Flow Designer activity library is organised into four groups: Contact Handling, Flow Control, Utilities and Voice.Build and manage flows with Flow Designer · Understand activities and events > Activities in Contact Handling / flow control / Utilities / Voice · Checked 2026-09-22
- 25On one reported UCCX to Webex Contact Center engagement the customer chose to keep the existing call flow design and simplify it as much as possible rather than redesign it during the migration.field reportChallenges of Moving from Cisco UCCX to Webex Contact Center · section describing the client's call flow decision · Checked 2026-09-22
- 26An integrator reporting on a completed UCCX to Webex Contact Center project stated that the transition can take three to six months depending on how many scripts have to be converted and the size of the existing environment.field reportChallenges of Moving from Cisco UCCX to Webex Contact Center · section on migration timeline · Checked 2026-09-22
- 27On 29 July 2026 Cisco announced that administrators and developers can use a public Flow schema and Flow V2 APIs on the Webex Contact Center Developer Portal to author, validate and manage flows programmatically.What's new for administrators in Webex Contact Center · July 29, 2026 > Programmatic Flow Design with public Flow Schema and new APIs · Checked 2026-09-22
- 28Cisco states that the Flow V2 APIs let teams search, validate, publish, export, lock and unlock flows, subflows and functions while keeping changes deterministic, versioned and reviewable.What's new for administrators in Webex Contact Center · July 29, 2026 > Programmatic Flow Design with public Flow Schema and new APIs, second sentence · Checked 2026-09-22
- 29Webex Contact Center Flow Designer treats functions as a first-class managed object, with documented procedures to create a function, manage functions and add a function to a main flow.Build and manage flows with Flow Designer · Create and manage functions > Important considerations, Create a function, Manage functions, Add a function to a main flow · Checked 2026-09-22
- 30Cisco describes the Flow Designer Functions capability as letting administrators automate complex tasks, manipulate data and extend capabilities using scripting languages including Python.Flow Designer Enhancements: Transform Customer Interactions with Powerful New Features · Functions section · Checked 2026-09-22
- 31Webex Contact Center documents an active global variable limit of 5000 per tenant.System limits in Webex Contact Center · System limits in Webex Contact Center > Global variables row · Checked 2026-09-22
- 32A Webex Contact Center global variable can be shown on the agent Desktop with a custom label and, if Edit on Desktop is enabled, edited by the agent during the interaction with the change saved within that session.Manage global variables · Manage global variables > Desktop visibility and Edit on Desktop · Checked 2026-09-22
- 33At most 100 Webex Contact Center global variables can be enabled for reporting at any one time.Manage global variables · Manage global variables > Make Reportable · Checked 2026-09-22
- 34Webex Contact Center global variables are defined centrally in Control Hub under Flows > Global Variables and are available across flows.Manage global variables · Manage global variables > where global variables are defined · Checked 2026-09-22
- 35Cisco instructs administrators never to store secure data such as credit card numbers, personal identification numbers or social security numbers in Webex Contact Center global variables, because the values remain visible to users who can see historical records.Manage global variables · Manage global variables > caution on secure data · Checked 2026-09-22
- 36The Webex Contact Center HTTP activity is the point of interface with external systems and lets the target system be configured centrally in Control Hub as a custom connector.Design Delightful Customer Experiences with Webex Contact Center Flow Designer · section on the HTTP Activity and Custom Connectors · Checked 2026-09-22
- 37Webex Contact Center Flow Designer provides an HTTP Request activity in the Utilities group for calling external systems from a flow.Build and manage flows with Flow Designer · Understand activities and events > Activities in Utilities > HTTP Request · Checked 2026-09-22
- 38Webex Contact Center Flow Designer documents JSON variables as a distinct variable concept alongside custom flow variables, predefined variables and global variables.Build and manage flows with Flow Designer · Use variables and expressions > Custom variables; Predefined variables; Global variables; JSON variables · Checked 2026-09-22
- 39Unified CCX local script variables are defined in the Variable pane of the Unified CCX Editor and belong to the individual script.Using Variables - Contact Center Express · Using Variables > local variables · Checked 2026-09-22
- 40Webex Contact Center flow local variables can be passed to other flows through the GoTo activity or the Subflow activity.Design Delightful Customer Experiences with Webex Contact Center Flow Designer · section on variables and subflows · Checked 2026-09-22
- 41Unified CCX has no organisation-wide variable store that all scripts read and write, so values shared across UCCX scripts must be carried in call variables, passed as subflow parameters, or persisted externally.inferredUsing Variables - Contact Center Express · Using Variables > variable categories (absence of any tenant-wide variable category) · Checked 2026-09-22
- 42Webex Contact Center Flow Designer has no native database or SQL activity, so UCCX DB Read, DB Get, DB Write and DB Release logic has to be re-expressed as calls to an HTTP service.inferredBuild and manage flows with Flow Designer · Understand activities and events > full activity list across Contact Handling, flow control, Utilities and Voice · Checked 2026-09-22
- 43Cisco 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.inferredMigrate Cisco Unified Contact Center Express to Webex Contact Center · Run the discovery tool for migration > migrated object types (no script, application, trigger or flow entry) · Checked 2026-09-22
- 44Webex Contact Center Flow Designer has no version control feature; the flow version number counts the number of times the flow has been published.Build and manage flows with Flow Designer · Create and manage flows > flow version behaviour · Checked 2026-09-22
- 45Webex Contact Center Flow Designer provides a Parse activity in the Utilities group for extracting values out of a structured response.Build and manage flows with Flow Designer · Understand activities and events > Activities in Utilities > Parse · Checked 2026-09-22
- 46Webex Contact Center flow expressions are written with Pebble template syntax, and Cisco documents a set of custom Pebble filters for use in flows.Build and manage flows with Flow Designer · Use variables and expressions > Writing expressions; Pebble template syntax; Custom Pebble filters · Checked 2026-09-22
- 47A Unified CCX script is associated with an application and is invoked when the trigger associated with that application is dialled.Scripting Overview - Contact Center Express · Scripting Overview > relationship between script, application and trigger · Checked 2026-09-22
- 48Webex Contact Center enforces per-activity self-loop limits in flows as a safeguard against unintended loops, with documented values including 100 for Menu, 100 for Collect Digits, 10 for Blind Transfer and 50 for Virtual Agent.System limits in Webex Contact Center · System limits in Webex Contact Center > self-loop limits for Flow Designer activities · Checked 2026-09-22
- 49Unified CCX script steps are themselves written in Java, but Cisco states that a script author does not need to understand Java programming to build a Unified CCX script.Scripting Overview - Contact Center Express · Scripting Overview > steps and the design pane · Checked 2026-09-22
- 50The Webex Contact Center Subflow activity packages reusable functionality for use in any number of flows, passing inputs into the subflow and returning outputs to the main flow.Design Delightful Customer Experiences with Webex Contact Center Flow Designer · section describing the new Subflow activity · Checked 2026-09-22
- 51A Unified CCX Call Subflow input mapping may pass any valid expression, and Unified CCX evaluates all such expressions before calling the subflow and stores the results in the named subflow variables.Input Mappings tab (Call Subflow step) - Contact Center Express · Input Mappings tab (Call Subflow step) > expression evaluation · Checked 2026-09-22
- 52A Webex Contact Center flow developer can map a global variable from the main flow to a local variable in a subflow, but cannot add global variables directly inside the subflow.Manage global variables · Manage global variables > global variables in subflows · Checked 2026-09-22
- 53Webex Contact Center subflows offer a Propagate changes to all flows setting, so an edit to a shared subflow can be pushed into every flow that uses it.Rapidly Adapt Your CX Workflows With Webex Contact Center Flow Designer · Subflows section · Checked 2026-09-22
- 54In a Unified CCX Call Subflow input mapping, a main-script variable can be mapped only to a subflow variable of the same type.Input Mappings tab (Call Subflow step) - Contact Center Express · Input Mappings tab (Call Subflow step) > mapping rules · Checked 2026-09-22
- 55Cisco's official Webex Contact Center flow template samples are distributed as JSON files intended for use in Flow Designer.WebexSamples/webex-contact-center-flows · repository README > template contents and file naming · Checked 2026-09-22
- 56Cisco states that the UCCX migration tool is continuously evolving and may not currently support all the latest features.Migrate Cisco Unified Contact Center Express to Webex Contact Center · Run the discovery tool for migration > note on tool coverage · Checked 2026-09-22
- 57A Webex Contact Center flow must be validated and its errors fixed before it can be published, and the Publish button stays disabled until all errors are resolved.Build and manage flows with Flow Designer · Create and manage flows > Validate a flow and Publish a flow · Checked 2026-09-22
- 58Cisco documents three categories of variable available to a Unified CCX script: local script variables, Cisco predefined enterprise call variables, and Expanded Call Context variables.Using Variables - Contact Center Express · Using Variables > variable categories · Checked 2026-09-22
- 59Webex Contact Center supports applying version labels such as Dev, Test and Live to a flow and selecting a labelled version at the entry point, enabling blue-green style promotion.Rapidly Adapt Your CX Workflows With Webex Contact Center Flow Designer · Flow Versioning section · Checked 2026-09-22
Documents
Build and manage flows with Flow Designer
Bulk Operations in Webex Contact Center
Database Steps - Contact Center Express
Input Mappings tab (Call Subflow step) - Contact Center Express
Manage global variables
Migrate Cisco Unified Contact Center Express to Webex Contact Center
Scripting Overview - Contact Center Express
Set up digital channels in Webex Contact Center
Set Variable - WXCC
System limits in Webex Contact Center
The Call Subflow Step - Contact Center Express
Using Variables - Contact Center Express
What's new for administrators in Webex Contact Center
CiscoDevNet/webex-contact-center-dbconnector
Flow Designer Enhancements: Transform Customer Interactions with Powerful New Features
WebexSamples/webex-contact-center-flows
Challenges of Moving from Cisco UCCX to Webex Contact Center
Design Delightful Customer Experiences with Webex Contact Center Flow Designer
Rapidly Adapt Your CX Workflows With Webex Contact Center Flow Designer
Cite this page
APA
WarmTransfer. (2026, September 22). UCCX scripts and Flow Designer flows. WarmTransfer. https://warmtransfer.net/knowledge/uccx-script-to-flow-redesign
BibTeX
@misc{warmtransfer-uccx-script-to-flow-redesign,
title = {UCCX scripts and Flow Designer flows},
author = {{WarmTransfer}},
year = {2026},
url = {https://warmtransfer.net/knowledge/uccx-script-to-flow-redesign},
note = {Verified 2026-09-22}
}