Skip to main content

Inbound Email Flows & Inbound Chat Flows

These are two distinct Architect flow types, each handling a specific digital channel. Both share structural similarities with Inbound Message flows but have channel-specific behaviors and limitations.


Inbound Email Flows

SectionDescription
Feature AreaArchitect / Flows
Flow TypeInbound Email
Navigation (Architect)Admin → Architect → Flows → Inbound Email
Navigation (Connect to domain)Admin → Contact Center → Email → [domain] → Route Settings → select flow
Primary FunctionRoute incoming ACD emails to the correct queue based on sender, subject, keywords, or scheduling logic

What Inbound Email Flows Do

Inbound email flows allow administrators to route and deliver incoming email messages to the right queue based on customer identity and intent. The flow is assigned to an email domain in the Email routing settings and runs when a new inbound email arrives.

Email Flow Characteristics

AttributeValue / Description
Does NOT have failure/success pathsUnlike call flows — errors are handled by configuring an action's path (e.g., Disconnect, Transfer to Queue)
No language settingsInbound email flows do not support language configuration
No in-queue handlingCannot trigger an in-queue flow from within the email flow itself
No audio controlsNo DTMF, no text-to-speech
Maximum wait time72 hours
In-queue flow limit30 in-queue flows per email interaction (prevents looping when target queue = current queue)
In-queue flow initial period60 seconds (recurring states run every 5 minutes + 5 second added wait)
Auto-generated email handlingConfigurable — default is Disconnect; can be set to "Process as normal"

Auto-Generated Email Detection

Genesys Cloud automatically identifies auto-generated emails by confirming all three of these headers:

HeaderValue That Triggers Auto-Generated Flag
Auto-SubmittedNot equal to "no"
PrecedenceContains "bulk"
X-AutoreplyContains "yes"

Default behavior: auto-generated emails are disconnected. Setting location: Architect → Flows → Settings → Inbound Email.

Common Routing Logic in Email Flows

Routing ScenarioArchitect Technique
Route by keyword in subject lineContains() function in a Decision action
Route by sender's email domainEmailAddressDomainPart() function in a Decision action
Route by case ID in bodyContains() on the body text
Route by schedule (business hours)Evaluate Schedule or Evaluate Schedule Group action
Auto-reply after hoursSend Auto Reply action
Route internal vs external sendersEmailAddressDomainPart() — send internal employees to employee queue, everyone else to standard queue

Permissions

PermissionPurpose
Architect > Flow > AddCreate email flows
Architect > Flow > EditEdit email flows
Architect > Flow > ViewView email flows
Architect > Flow > DeleteDelete email flows

How Email Flows Connect to Email Domains

  1. Create and publish the Inbound Email flow in Architect
  2. Navigate to Admin → Contact Center → Email
  3. Select the email domain and configure routing settings
  4. Assign the published Inbound Email flow

Inbound Chat Flows

SectionDescription
Feature AreaArchitect / Flows
Flow TypeInbound Chat
Navigation (Architect)Admin → Architect → Flows → Inbound Chat
Primary FunctionRoute ACD web chat interactions to the correct queue; optionally invoke bot flows before agent handoff
ChannelWeb chat (via Web Chat widget / Web Messenger — deprecated web chat; Inbound Chat flows are for legacy Web Chat)

What Inbound Chat Flows Do

Inbound Chat flows handle chat interactions arriving via Genesys web chat widgets. They route chats to agents, invoke bots, and perform logic based on available agent capacity, schedules, or customer data. This flow type is distinct from Inbound Message flows, which handle ACD messaging channels (SMS, social, messaging apps, Web Messenger).

Chat Flow Characteristics

AttributeValue / Description
Failure/success pathsNo — same as email; errors handled via action-level path configuration
In-queue handlingNo in-queue flow within chat flows
Audio controlsNo — no DTMF, no TTS
Language settingYes — chat flows do support a default language setting
Error event transfer queueConfigurable at flow creation — optional queue to transfer the flow to if Architect detects an error
Maximum wait time72 hours
Bot integrationCan invoke a Dialog Engine Bot Flow or Digital Bot Flow via Call Bot Flow / Call Digital Bot Flow action

Permissions

PermissionPurpose
Architect > Flow > AddCreate chat flows
Architect > Flow > EditEdit chat flows
Architect > Flow > ViewView chat flows
Architect > Flow > DeleteDelete chat flows

Comparison: Email vs Chat vs Message Flows

AttributeInbound EmailInbound ChatInbound Message
ChannelEmail (ACD)Web Chat (legacy)ACD Messaging (SMS, social, Web Messenger)
Failure/success pathsNoNoNo
Language settingNoYesNo
In-queue handlingNoNoNo
Audio / DTMF / TTSNoNoNo
Maximum wait time72 hours72 hours72 hours
In-queue flow limit30 per interactionN/A30 per interaction
Bot integrationNo (email-specific)YesYes
Auto-generated handlingYes (configurable)NoNo

Shared Architect Flow Notes for Digital Flows

RuleApplies To
No failure or success pathsEmail, Chat, Message
In-queue flow limit of 30Email and Message
Cannot loop transfer to same queueEmail and Message
72-hour max wait timeEmail, Chat, Message
All require publishing before useAll flow types
Assigned at channel config levelEmail → Email domain settings; Chat → Web Chat widget; Message → Messaging config

Key Takeaways

TopicSummary
Inbound Email flowRoutes ACD emails; no audio, no failure paths, no language; max 72hr wait; auto-generated email detection
Auto-generated detectionThree headers: Auto-Submitted ≠ "no", Precedence = "bulk", X-Autoreply = "yes"
Email routing techniquesContains(), EmailAddressDomainPart(), Evaluate Schedule, Send Auto Reply
In-queue flow limit30 per email/message interaction
Inbound Chat flowRoutes legacy web chat; similar to email but does support language setting
Chat vs MessageInbound Chat = legacy Web Chat widget; Inbound Message = ACD messaging channels (SMS, social, Web Messenger)
Both lack in-queue handlingNeither email nor chat flows trigger in-queue flows internally