Routing & orchestration

Architect flow design

Every customer journey on Genesys Cloud CX runs through Architect. Our certified squad designs, builds, tests and governs flows that are easy to read, safe to change and traceable to your requirements.

Architect flow to the right agent On the left a dark tile represents a Genesys Cloud Architect flow: an incoming call, a decision diamond and an automated task step marked by a gear. An arrow leads into a large bullseye of concentric rings, with small dots for agents in each skill ring, representing skills-based, bullseye and predictive routing. A second arrow leaves the bullseye and selects the highlighted royal blue tile in a column of three agents, showing the interaction reaching the right agent. ROUTING & ORCHESTRATION Architect flow Skills · bullseye Right agent

In summary

Genesys Cloud Architect flow design decides how every call, message, email, bot conversation and workitem behaves before it reaches an agent. QVCCS designs, builds and tests Architect flows that are clear, reusable and safe to change: inbound call, in-queue, inbound email, inbound message, bot, workitem, secure call and common module flows, connected to your systems through data actions. Our certified team traces every flow from requirement to test, peer review every build and use Archy to manage flows as code, so your journeys stay understandable as they grow.

Who works on this

  • Solution Architect
  • Senior Developer
  • Software Developer
  • Senior Business Consultant / Business Analyst
  • Systems Integration Tester
  • Senior Platform Practice Lead (Genesys Cloud CX)
  • Every flow type coveredCall, in-queue, email, message, bot, workitem, secure call and common module flows designed to one documented standard.
  • Reusable by designCommon modules hold shared logic once – business hours, authentication, lookups – so changes happen in one place.
  • Data in every decisionData actions connect flows to CRM, billing and bespoke systems, with error handling for every response.
  • Flows as codeArchy and YAML bring version control, four-eyes peer review and repeatable promotion of Architect flows between test and production orgs.
DiagramHow we structure Architect flows on Genesys Cloud CX
  1. Entry flows
    • Inbound call
    • Inbound message
    • Inbound email
    • Workitem
  2. Conversation logic
    • Bot flows
    • In-queue flows
    • Secure call flows
  3. Shared building blocks
    • Common modules
    • Data actions
    • Data tables
  4. Governance and DevOps
    • Archy and YAML
    • Version control
    • Test and release

Entry flows stay thin, shared logic lives in modules, and everything is governed as code.

01

Why Genesys Cloud Architect flow design matters

Architect is the Genesys Cloud visual flow designer, and it sits at the heart of the customer experience. Every greeting, menu, identification step, self-service transaction, routing decision and in-queue message is defined in a flow. Good Genesys Cloud Architect flow design makes those journeys quick and natural for customers and predictable for the people who run them. Poor design shows up as long menus, repeated questions, dead ends, dropped context and flows so tangled that every change becomes a risk nobody wants to take.

For contact centre leaders, well-designed flows mean faster change: a new product line, an outage message or an extra language can be introduced without fear of breaking something else. For technical architects, they mean a maintainable estate with clear structure, documented dependencies and consistent error handling. QVCCS treats flow design as engineering. Each flow path starts as a requirement in the Business Requirements Document and Requirements Traceability Matrix, is specified in a dialogue design specification and low-level design, built to our engineering standards, peer reviewed and proven by a test before it is published.

02

Architect flow types and how they fit together

Architect offers a flow type for each job. Inbound call flows handle the IVR experience, from greeting and identification to self-service and routing. In-queue flows, available for calls, emails and messages, control what customers experience while they wait, such as hold messages, wait announcements and callback offers. Inbound email and inbound message flows classify and route digital interactions. Bot flows, built as Genesys Dialog Engine Bot Flows or Genesys Digital Bot Flows, provide conversational self-service that call and message flows invoke. Workitem flows automate Work Automation tasks. Secure call flows temporarily prevent recording and agent access while a caller enters sensitive information such as card details.

Common module flows hold reusable logic that other flows call, such as business hours and emergency checks, customer identification or a standard data lookup, and each module can be enabled for the flow types that need it. Data actions let flows call your CRM, billing, order or bespoke systems in real time, while data tables hold configuration such as opening hours or routing parameters outside the flow logic. Architect also records flow outcomes and milestones for self-service reporting and shows the dependencies between flows and resources. QVCCS sets out how these pieces interact in the high-level design, so each flow has a single responsibility and every journey can be traced end to end.

A good Architect flow is one your newest administrator can read, change and test with confidence – because every path traces back to a requirement and forward to a test.

QVCCS point of view

03

Design standards, secure flows and common pitfalls

The most common Architect problem is the monolithic flow: one enormous inbound call flow that grew by accretion, with copied logic, hard-coded values and unlabelled branches. It works until someone needs to change it. QVCCS designs flows the other way round. Entry flows stay thin and delegate to common modules, configuration lives in data tables, and naming, variable scoping, comments and failure paths follow our documented naming and configuration standards. The low-level design, or build book, records every flow, module, prompt, data action and table, so any administrator can open a flow and understand what it does and why.

Data handling is the next big risk. Every data action can be slow, return nothing, return many results or fail, and every outcome needs a defined path. Our Interface Control Documents fix request and response schemas, timeouts and fallbacks, so a failed lookup never leaves a customer in silence. Sensitive data goes through secure call flows: when an agent transfers a caller, the agent can be reserved and the caller returned with the Return to Agent action, while digits entered are kept out of recordings, logs and agent hearing. Genesys warns that diagnostic protocol captures are not encrypted, so we design that risk out and record it in your runbooks.

Change control completes the picture. Architect keeps a version history for each flow, but versions alone do not provide peer review, environment promotion or rollback across a whole release. Archy, the Genesys command-line tool for Architect flows defined in YAML, lets flows be exported, stored in source control, reviewed like any other code and imported into development, test and production organisations, with queue and data action mappings updated procedurally rather than by hand. QVCCS sets up these pipelines, often alongside CX as Code for the surrounding configuration, where they suit your team, and documents a disciplined manual release process where they do not.

04

Who builds your flows, and decisions that age well

Flow work is shaped to the size of your estate, and the team we draw from our own bench reflects that. A Senior Business Consultant / Business Analyst runs discovery and requirements workshops and owns the traceability matrix. A Solution Architect produces the flow architecture in the high-level design and agrees interface contracts with your system owners. Senior Developers and Software Developers build to the low-level design, and the Senior Platform Practice Lead peer reviews the work against our engineering standards. Testing is path by path: each menu option, input type and data response has a SIT case, failures such as timeouts and empty lookups are forced deliberately, and we check what each path writes to participant data and reporting. Voice flows are tested with real calls and keypad input; digital and bot flows with the phrasing customers actually use.

Some design decisions only show their value months later. Emergency and outage messages should be switchable from a data table by an authorised person, not by editing and republishing a flow at short notice. Prompts deserve a register: which are recorded and which use text-to-speech, who approves the wording, and how each language version is kept in step. Common modules need care, because a change to a shared module affects every flow that calls it, so the dependency view is checked before every release. Participant data names should follow one convention across all flows, or agent scripts and reporting break quietly. And every flow needs a defined end for the unexpected: an error path that reaches a person or a clear message, never silence or a disconnect.

05

Governing and evolving your flow estate

Flows change more often than almost any other part of a contact centre, so governance matters long after go-live. At handover you receive as-built documentation, runbooks and a support model in an operational handover pack. Release readiness reviews of Genesys release notes look for changes that could affect your flows, and every change follows a cut-over runbook with a rehearsed rollback. Regular optimisation reviews use flow outcome, milestone and Flow Insights data to find abandonment and drop-off points. QVCCS supports the estate in line with your support model, as the change and escalation layer behind your provider or under a direct SLA. We also tidy inherited estates, consolidate duplicated logic into modules and bring AI into journeys under the same design authority.

What you get from QVCCS

  • Flow architecture in the HLD covering every flow, module, data action and table
  • LLD / build book with naming, variable and error-handling standards
  • Inbound, in-queue, digital, bot, workitem and secure call flows built
  • Reusable common modules for shared journey logic
  • SIT pack and negative tests traced to the requirements matrix
  • Archy and YAML flow-as-code pipeline where it suits your team
  • Handover pack, release readiness reviews and support aligned to your model

Genesys documentation references

Checked against current official documentation, October 2026. Genesys releases weekly, so we re-validate every design against the live release notes.

  1. About Architect (Genesys Cloud help)help.genesys.cloud
  2. Define Architect flows using YAML (Archy)help.genesys.cloud
  3. Secure flows overviewhelp.genesys.cloud
  4. Secure flow scenarioshelp.genesys.cloud
  5. Work with workitem flowshelp.genesys.cloud

Methods & templates

How quality is built in, stage by stage.

Every QVCCS engagement follows our seven-stage delivery lifecycle, each stage closed by a quality gate. These are the techniques and standard templates we lean on for Architect flow design – each one traceable from requirement to design, build, test and support.

  1. 01DiscoverDiscovery sign-off
  2. 02DefineRequirements baseline
  3. 03DesignDesign authority review
  4. 04BuildBuild complete
  5. 05ProveGo / no-go readiness
  6. 06TransitionOperational acceptance
  7. 07Run & evolveService reviews
  • 2 · Define

    Requirements Traceability Matrix (RTM)

    Links every menu option, decision and data lookup to a requirement and a test, so no flow path is built or released untested.

  • 3 · Design

    Dialogue design specification and prompt list

    Defines prompts, inputs, confirmations and failure handling for each journey before anything is built on the Architect canvas.

  • 3 · Design

    Low-Level Design / build book (LLD)

    Records every flow, common module, variable, data action and data table with naming and configuration standards for builders and reviewers.

  • 4 · Build

    Configuration-as-code with Archy in version control

    Keeps flows in YAML under source control with four-eyes peer review, so promotion between test and production is repeatable.

  • 5 · Prove

    Negative and failure-path testing

    Forces data action timeouts, empty results, invalid input and errors to prove every flow fails safely and never strands a customer.

  • 7 · Run & evolve

    Release impact assessments

    Reviews Genesys release notes against your flow estate so new Architect behaviour is assessed before it affects live journeys.

See the full QVCCS delivery method

How we deliver

Your engagement at a glance: one accountable team.

  1. 01Discover & defineMap journeys, prompts, decisions and data needs with operations, captured in the BRD and traceability matrix.
  2. 02Design the estateHLD, LLD and interface contracts define every flow, module, data action and table, approved by design authority.
  3. 03Build to standardCertified developers build to the LLD under our engineering standards, with four-eyes peer review and version control.
  4. 04Prove every pathSIT, negative and telephony testing traced to requirements, then UAT scripts run with your operations team.
  5. 05Transition & evolveCut-over runbook, handover pack, release readiness reviews and support alongside your provider, or direct from us, keep the estate healthy.

The specialists on this work, from our own bench

  • Solution Architect
  • Senior Developer
  • Software Developer
  • Senior Business Consultant / Business Analyst
  • Systems Integration Tester
  • Senior Platform Practice Lead (Genesys Cloud CX)

Every engagement follows our seven-stage method, with design authority, engineering standards and four-eyes peer review behind it. How we deliver →

Questions

Architect flow design: common questions

What flow types are available in Genesys Cloud Architect?

Architect flow types include inbound and outbound call, in-queue (for calls, emails and messages), inbound email, inbound message, bot, workitem, secure call, voicemail, survey and common module flows. Each has a specific role in the customer journey, and shared logic such as business hours or identification is best held once in a common module.

What is Archy in Genesys Cloud?

Archy is the Genesys command-line tool for Architect flows defined in YAML. Flows can be exported to YAML, kept in source control, peer reviewed and imported into development, test and production organisations, with mappings such as queues and data actions updated procedurally.

How do secure call flows work in Architect?

A secure call flow temporarily prevents system recording and agent access while a caller enters sensitive information such as card details. An agent can transfer the caller in and, if designed that way, stay reserved until the flow returns the caller. We design these flows with your payment provider and test that nothing sensitive reaches recordings or logs.

Can you take over and improve existing Architect flows?

Yes. We start with a configuration audit of your inherited estate, document what each flow does, identify duplicated or fragile logic and plan a safe refactoring into common modules and data tables. Changes are traced to requirements, tested path by path and released through a cut-over runbook, so improvements never put live journeys at risk.

Last reviewed

Talk to a specialist about this

We work by introduction. Clients, partners and people introduced to us can reach the right specialist for this topic directly.

Who to contact