Skip to main content

Genesys - Architect - Call Flow UI Overview

The Architect call flow editor contains multiple UI sections that define how calls are processed, routed, and managed. These sections appear in the left navigation panel, toolbox, and configuration panels within the call flow editor.


Flow Configuration Panel (Left Navigation)

SectionDescription
Starting TaskEntry point of the flow. The first logic executed when a call arrives — typically used for initial checks such as caller identification, block lists, or routing decisions.
SettingsDefines default behavior for the flow including timeout handling, event handling, and fallback routing logic if unexpected errors occur.
Menu DefaultsDefines standard IVR behavior such as how many times a menu repeats and how long the system waits for caller input before timing out.
Supported LanguagesConfigures the languages available in the flow. Each language can use pre-recorded prompts or text-to-speech engines.
Speech RecognitionEnables or disables voice recognition so callers can speak commands instead of using DTMF keypresses.
ResourcesDisplays variables used in the flow including system variables (such as caller ANI) and user-created variables used for routing logic.
PromptsLists audio prompts referenced directly in the flow such as greetings, announcements, or menu prompts.
DependenciesDisplays resources used by the flow such as prompts, data tables, or tasks to prevent accidental deletion of required objects.
Reusable MenusStores reusable IVR menus that can be called from multiple parts of the flow to simplify management and reduce duplication.
Reusable TasksStores reusable logic blocks used for background processing such as schedule checks or routing decisions.

Architect Toolbox Categories

The Toolbox contains all actions used to build call flow logic. It is available on the flow's main page and inside the task editor. Categories are collapsible, and a search bar lets you quickly filter and find any action by name. Action availability varies by Genesys Cloud license plan and flow type.

CategoryDescription
AudioPlays prompts, text-to-speech, or other audio to the caller. Also handles whisper audio to agents, transcription, audio monitoring, and flushing queued audio.
BotIntegrates conversational bots such as Genesys Dialog Engine Bot Flows, Amazon Lex, Google Dialogflow (ES and CX), Nuance Mix, or external voice bots via Audio Connector.
CommonExecutes logic stored in a previously created Common Module flow, allowing shared logic to be reused across multiple flows.
Customer Secured DataHandles sensitive data within flows using encryption. Includes Get Secured Data, Set Secured Data, Encrypt Data, and Decrypt Data.
DataRetrieves or manipulates data from external services, APIs, or internal data tables. Includes Call Data Action, Data Table Lookup, Collect Input, Update Data, Set/Get Participant Data, Set UUI Data, Call Decision Table, Get/Set SIP Headers, and Set External Tag.
DialEnables Dial by Extension, allowing callers to dial and be transferred to a specific extension directly.
DisconnectEnds the call or interaction. Used as the terminal action when no further routing is needed.
External ContactsRetrieves information from the Genesys Cloud External Contacts system. Includes Get External Contact, Get External Organization, and Promote External Contact.
FindDynamically locates resources at IVR runtime by name or ID. Includes Find Queue, Find Queue by ID, Find User, Find User by ID, Find Users by ID, Find Group, Find Skill, Find Language Skill, Find Schedule, Find Schedule Group, Find Emergency Group, Find System Prompt, Find User Prompt, and Find Utilization Label.
FlowInteraction-level actions including Create Callback, Set Screen Pop, Set Wrap-Up Code, Set Language, Set/Clear Post-Flow, Initialize/Set Flow Outcome, Add Flow Milestone, Set/Clear Utilization Label, and Enable Participant Recording.
LogicalDecision-making and schedule-based routing. Includes Decision (if/else), Switch, Evaluate Schedule, and Evaluate Schedule Group.
LoopRepeats sections of a task sequence. Includes Loop, Next Loop, and Exit Loop. Supports fixed count, collection iteration, and condition-based looping.
MenuCreates IVR menus where callers choose options via DTMF keypresses or speech recognition. Includes Menu, Jump to Menu, and Previous Menu.
TaskGroups related actions into reusable routines. Includes Task, Call Task, Jump to Reusable Task, and End Task.
TransferRoutes callers to a destination. Includes Transfer to ACD (queue), Transfer to User, Transfer to Number, Transfer to Group, Transfer to Flow, Transfer to Secure Flow, and Transfer to Voicemail.

📌 Note: The Communicate category does not exist in inbound call flows. Action availability differs across flow types (inbound, outbound, in-queue, bot, email, message, etc.) and Genesys Cloud license plans.


Toolbox Actions – Common Examples

Audio

ActionDescription
Play AudioPlays a prompt or text-to-speech message to the caller.
Play Audio on SilencePlays a message to completion when silence is detected.
Flush AudioClears any queued audio within the call flow.
Set Whisper AudioPlays a message to the agent before they answer the call to indicate which queue the caller came from.
TranscriptionEnables the voice transcription feature for the call flow.
Audio MonitoringStarts or stops streaming conversation audio to a third-party service for real-time analysis.

Bot

ActionDescription
Call Bot FlowLaunches an existing Genesys Dialog Engine Bot Flow within the call flow.
Call Lex Bot / Call Lex V2 BotIntegrates Amazon Lex (v1 or v2) for self-service and intent processing.
Call Dialogflow Bot / Call Dialogflow CXIntegrates Google Dialogflow (ES or CX) for self-service and intent processing.
Call Nuance BotIntegrates a Nuance Mix bot into the call flow.
Call Audio ConnectorStreams conversation audio to an external voice bot and returns audio back to Genesys Cloud.

Common

ActionDescription
Call Common ModuleExecutes reusable logic stored in a previously created Common Module flow. Allows shared logic to be maintained in one place and referenced across multiple flows.

Customer Secured Data

ActionDescription
Get Secured DataRetrieves a secured data attribute from an interaction participant.
Set Secured DataAssigns a secured data attribute value to a call participant.
Encrypt DataEncrypts sensitive data using your organization's encryption key.
Decrypt DataDecrypts previously encrypted data within a flow.

Data

ActionDescription
Call Data ActionRetrieves customer data from a default or custom data actions integration (e.g. Salesforce, external API).
Call Decision TableExecutes a rule-based decision table previously configured by an administrator.
Collect InputPrompts a caller to enter a string of digits (e.g. account number).
Data Table LookupRetrieves a value stored in a Genesys Cloud data table.
Get Participant DataRetrieves a participant attribute previously set on the interaction.
Set Participant DataSets a named attribute value on the call participant — persists across flows and is accessible to agents and integrations.
Update DataAssigns or modifies flow or task-level variables.
Set UUI DataPasses User-to-User Information (UUI) data through transfer and disconnect actions.
Get SIP Headers / Get Raw SIP HeadersRetrieves BYOC Cloud SIP headers for use in routing logic.
Set External TagAssociates the interaction with a record in an external CRM or system of record (SOR).

Dial

ActionDescription
Dial by ExtensionAllows the caller to dial a specific extension and be transferred directly to it.

Find

ActionDescription
Find Queue / Find Queue by IDDynamically locates a queue by name or ID at IVR runtime.
Find User / Find User by ID / Find Users by IDLocates a specific agent or multiple agents at runtime.
Find GroupRetrieves a Genesys Cloud group at runtime.
Find SkillFinds an ACD skill by name at runtime for use with Transfer to ACD routing.
Find Language SkillRetrieves a language skill at runtime for use with Transfer to ACD routing.
Find Schedule / Find Schedule GroupRetrieves a schedule or schedule group at runtime for dynamic routing decisions.
Find Emergency GroupRetrieves an emergency group at runtime.
Find System Prompt / Find User PromptDynamically looks up a prompt by name for playback.
Find Utilization LabelDynamically retrieves a utilization label by name at runtime.

Flow

ActionDescription
Create CallbackOffers callers the option to receive a callback instead of waiting in queue.
Set Screen PopSelects a predefined script to display to the agent when the interaction arrives.
Set Wrap-Up CodeAutomatically assigns a wrap-up code to the interaction.
Set LanguageAllows callers to select the language in which they hear prompts.
Set Post-Flow / Clear Post-FlowAssigns or removes a post-flow action (e.g. voice survey or transfer) that executes after the interaction ends.
Initialize Flow Outcome / Set Flow OutcomeTracks and sets success or failure outcomes for analytics and reporting.
Add Flow MilestoneAdds a milestone marker to the flow for granular reporting and customer journey tracking.
Set Utilization Label / Clear Utilization LabelDynamically applies or removes a utilization label on the interaction.
Enable Participant RecordingGives callers the option to consent to call recording.

Logical

ActionDescription
DecisionRoutes the flow based on a true/false condition (if/else).
SwitchRoutes the flow based on multiple possible case values.
Evaluate ScheduleRoutes calls based on whether a schedule is open, closed, or in a holiday state.
Evaluate Schedule GroupRoutes calls using a schedule group that combines multiple schedules.

Loop

ActionDescription
LoopRepeats a series of actions before continuing to the next action. Supports fixed count, collection iteration, and condition-based modes.
Next LoopSkips the remaining actions in the current iteration and moves to the next.
Exit LoopExits the loop entirely and continues execution with the next action after the loop.

Menu

ActionDescription
MenuCreates an IVR submenu where callers select options by pressing a digit or speaking a valid speech recognition entry.
Jump to MenuTransfers the caller immediately to a designated menu within the flow.
Previous MenuReturns the caller to the menu they came from.

Task

ActionDescription
TaskGroups related logic steps into a named routine within the flow.
Call TaskExecutes another task within the same flow.
Jump to Reusable TaskExecutes a previously created reusable task.
End TaskEnds execution of the current task and returns control to the calling action.

Transfer

ActionDescription
Transfer to ACDSends the interaction to a queue for agent routing. Supports preferred agents, skills-based routing, and pre-transfer audio.
Transfer to UserSends the call directly to a specific agent or user.
Transfer to NumberTransfers the call to an external phone number.
Transfer to GroupTransfers the call to a Genesys Cloud group.
Transfer to FlowTransfers the call to another Architect call flow.
Transfer to Secure FlowTransfers to a secure call flow for handling sensitive data such as payment card information.
Transfer to VoicemailSends the caller directly to a voicemail destination.

Workspace UI Components

ComponentDescription
CanvasThe main visual area where flow components are placed, arranged, and connected to build interaction logic.
ConnectionsVisual lines representing the execution path between flow components, updated as components are linked.
Properties PanelDisplays configuration options for the currently selected component.
ValidationChecks the flow for configuration errors. Red = must fix before publishing; yellow = warning, publishing still allowed.
Debug ToolActivates a testable version of the flow reachable via SIP address (YourFlowName-debug@localhost) to hear the flow from the caller's perspective before publishing. English-language flows only.

📌 Limits reminder: The maximum number of actions Architect runs per flow invocation is 10,000. If exceeded, the flow enters error handling (default: disconnect). Flow authors can configure an alternative path such as Transfer to ACD, Jump to Menu, or Jump to Reusable Task — Architect grants an additional 1,000 actions for error handling. Exceeding that limit results in a silent disconnect.


Last verified against Genesys Cloud Resource Center – March 2026