Workflows

Build your agent's behavior using visual, step-by-step graphs

Workflows are the building blocks of your agent. Each workflow is a visual graph that defines how your agent processes input and responds to users — step by step, node by node.

An agent can contain many workflows, each responsible for a different part of its functionality. Think of them as modular pieces of logic you compose together.

---

What Is a Workflow

A workflow is a directed graph made up of two elements:

Nodes

The building blocks — each one performs a discrete action or logic step

Edges

The connections between nodes that define the execution sequence

Your agent executes the graph step by step, starting from the Start node and chaining through each connected node. A workflow ends when it reaches a node with no outgoing edge or a Redirect node that transfers execution to another workflow.

Types of Workflows

When you create a new workflow, you select one of four types. Each type comes with a preconfigured template and may enable specialized nodes.

Generic

The standard workflow type. Build custom conversation logic using any combination of message, prompt, action, and logic nodes.

Survey

User Feedback

LiveChat

Creating a Workflow

1

Navigate to the workflows hub

Go to Designer > AI > Flows

2

Add a New Workflow

Click the Add Flow button

3

Configure the Workflow

Enter a descriptive name (e.g., Order Tracking or Greeting) and select the workflow type.

4

Create the Workflow

Click Create flow. The new workflow is added to the agent and you can now start building your logic in the canvas.

Managing a Workflow

You can manage a workflow using the Action column buttons.

Icon	Function	Description
	Edit	Open the workflow on the canvas
	Delete	Permanently remove the workflow
	Clone	Duplicate the workflow into the same or a different agent
	Preview	Run the workflow in isolation
	Favourite	Set this workflow as the default for the flow preview

Deleting a workflow is permanent. Make sure you no longer need it before clicking Delete.

Editing a Workflow

Use the Canvas to design your workflow visually. Simply drag and drop nodes, then connect them to define the execution path. To edit a workflow, either select it in Designer > Flows or click the respective edit action button.

Constraints

The canvas enforces various rules to keep your workflows valid. For example:

• Every node must be connected — you cannot leave detached nodes in the workflow

• Only valid connections between compatible node types are allowed

• A node cannot have multiple outgoing edges to different children (unless using a control flow node)

If you try to exit the canvas with errors, you get a warning highlighting the issues. You need to fix all error before saving a workflow.

Life of a Workflow

Each workflow executes according to the visual path established in the graph.

1

Start node

Whenever a workflow is triggered the execution flow begins from the Start node. There is only one Start node per workflow, it cannot be removed and it is automatically created for every new workflow.

2

Step-by-Step Execution

The workflow chains through nodes one at a time, following the edge direction. At each step, the next node is determined by the outcome of the current one. If a node branches into multiple outgoing paths, the workflow follows a single path based on the result. The result is an execution flow that adapts to each conversation rather than following a fixed sequence.

3

End or Redirect

The workflow concludes automatically upon reaching either a node with no further outgoing paths or a Redirect node, which hands off the execution to another workflow.

A single agent response can span multiple workflows chained through Redirect nodes. The response completes when the last workflow in the chain reaches a terminal node.

Special Workflows

There are two specific workflows that are special for every agent: the Start and Default workflow. They are used to manage the execution cycle of the agent and how it responds to new messages.

Start Workflow

The initial workflow triggered the moment a user begins a new conversation. Availability of the start workflow varies depending on the specific channel you choose to deploy.

Default Workflow

The main workflow that triggers automatically whenever a new message pops up from a user in the chat interface. This central sequence handles the bulk of your agent's processing.

Quick Overview

	Start Workflow	Default Workflow
Purpose	Greets the user when a conversation begins	Responds to any new user message
Trigger	Conversation opens (before any user input)	User input
Scope	Per deployment	Global (applies to all deployments)
Where to set	Deployment settings	Designer > AI > Default Flow
Availability	Depends on the channel	All channels

Start Workflow

The start workflow is the initial workflow triggered the moment a user begins a new conversation. It defines the agent's first impression, allowing you to establish context or gather information before the main logic takes over.

Keep It Short

Orient the user in 1–2 messages, not overwhelm them with information

Match the Channel

A Webchat start workflow can be more visual, while a Viber start workflow should stay text-focused

Descriptive Name

Use names like Welcome - EN or Onboarding - Support so they are easy to identify

Understanding the Start Workflow

This workflow is triggered when the user first accesses the agent, such as when they open a webchat interface in their browser. Because this workflow can be any flow you have built, it offers a high degree of flexibility for personalizing the user experience.

Common uses for a start workflow include:

• Send a personalized welcome message

• Setting specific variables to track user context

• Asking for initial feedback or user preferences

• Introduces the agent's capabilities

The start workflow is set per deployment, not globally. Different deployments can trigger different workflows, even on the same channel.

Channel Availability

The availability of the start workflow varies depending on the specific channel you choose for deployment. Some channels do not support the concept of a 'new conversation' session, while others restrict introductory messages to a one-time initial interaction.

Channel	Start Workflow Available
Webchat	✅ Yes
API	❌ No
Microsoft Teams	❌ No
Slack	❌ No
WhatsApp	❌ No
Viber	✅ Yes
Messenger	✅ Yes
Instagram	❌ No
Unity	❌ No

Configure a Start Workflow

You choose the start workflow when you create a deployment in the Designer. If you need to update the initial experience, you can change the assigned workflow at any time from the deployment configuration settings.

1

Create a Workflow

Go to Designer > AI > Flows and build the workflow you want to use as the start flow. A common pattern is a welcome message followed by quick-reply options.

2

Open the Deployment

Go to Designer > Deployments and click the deployment you want to configure or create a new one.

3

Select the Workflow

Find the Flow dropdown (location and name may vary by channel) and select your workflow.

4

Save

Click Save Changes (or Create Deployment if creating a new one).

Default Workflow

The default workflow is the main starting point of your agent. It is the central sequence that triggers automatically whenever a new message is sent to the agent, ensuring a responsive interaction for every user query.

To configure the default workflow, navigate to Designer > AI > Default Flow.

Don't Forget the Redirect

Ensure the workflow ends with a Redirect; without this, the Agent AI won't trigger to process the user's response

Leverage Variables

Use variables like {{user.LastName}} or {{session_topic}} within your response to prove the agent is "listening" rather than just reciting a script

Offline Switch

Use a custom message with a static notification to inform users if and when the agent is available or is undergoing maintenance

Optimize for Brevity

The default workflow should be concise. Let the agent decide how it wants to answer

Understanding the Default Workflow

When a user sends a message, the default workflow is responsible for handling the agent's response. It is defined as a chain of responses that are executed sequentially and you can configure each response separately by selecting one of the following four different types.

Message

Display customized messages to your users with full support for rich formatting, including emojis and lists. You can personalize the response by including agent-specific variables such as user metadata or the current date and time.

For granular control, you can enable or disable thumb ratings for specific messages, allowing you to override your global agent settings.

Redirect

Feedback

Variable

There is only one default workflow allowed for each agent to maintain a clear and consistent logic path.

Build a Default Workflow

1

Navigate to the Default Flow page

Go to Designer > AI > Default Flow.

2

Select the Language

Use the language dropdown at the top to choose which language you are configuring.

Each language has its own independent Default Flow

3

Add a Response

Click Add Agent Response on the top or the bottom of the chain. Select the response type (Message, Redirect, Feedback, or Variable) and fill in the fields.

4

Chain Additional Responses

Click Add Agent Response again to append more responses. They execute top-to-bottom in the order shown.

5

Remove Responses

Click the icon next to any response block to remove it from the chain. The remaining responses shift up automatically.

Deleting a response is immediate. There is no confirmation dialog.

6

Save

Changes save automatically as you edit each response block.

Workflows as Nodes

The Redirect node allows you to trigger a workflow from within another workflow, effectively turning complex sequences into modular "building blocks." This architectural approach is essential for building scalable and maintainable agents.

For example, imagine you have a main routing workflow that acts as a switchboard. Instead of building every single response in one place, you use Redirect nodes to send the user to specialized flows:

• Main Workflow $→$ User asks about a package $→$ Redirect to Order Tracking Flow.

• Main Workflow $→$ User asks to return an item $→$ Redirect to Returns & Refunds Flow.

• Main Workflow $→$ User requests a human $→$ Redirect to Live Support Flow.

Best Practices

• Keep workflows focused: each workflow should handle one task or conversation path, not the entire agent logic

• Name descriptively: use names like Order Tracking or Password Reset instead of Flow 1 or Test

• Set a default workflow: always configure a default workflow to handle unrecognized input gracefully

• Match the channel: a Webchat starting workflow can be more visual, while a Viber starting workflow should stay text-focused

• Use annotation tag: Sticky notes are available in the canvas sidebar. They are very useful for documenting and organizing a workflow and facilitating collaboration between team members.

You now understand how to create, manage, and connect workflows to build your agent's conversational logic.