Agentic Workflows → New workflow in your OpenCX dashboard. Requires the Workflows permission (Write).
Create a workflow
1
Open a new workflow
In Agentic Workflows, click New workflow. The workflow is named Untitled Workflow until you rename it: click the name at the top left, enter a new name and click Rename.
2
Build it with Companion, or build it yourself
An empty canvas shows Build it with Companion. Describe what should happen, for example “Escalate angry customers to a human”, and Companion adds the trigger, conditions and steps for you. Click or build it yourself to start from a blank canvas. Once the workflow has steps, ask Companion for changes from the bar at the bottom (Ask Companion to edit this workflow…, or press alt+Space). Check every step Companion adds before you activate the workflow.
3
Save the first version
A new workflow exists only in your browser until you click Save. After the first save, every edit autosaves to your draft.
Pick a trigger
Click Add a trigger on the empty canvas, or the + button at the top left (shortcut A). The picker lists TRIGGERS, ACTIONS, BLOCKS and MISC; search by name. A workflow has exactly one trigger. Click the trigger on the canvas to configure it in the side panel. Most session triggers can be narrowed before they start a run:
Some triggers add their own settings, such as Inactive For and Unit on Customer Inactive, Cron Expression on Cron Trigger, or The Goal of the Workflow on AI Trigger. See Triggers and steps for each one.
Add steps
You can add a step three ways:- Drag from the output handle of a step or trigger. A menu opens with BLOCKS and ACTIONS; pick one and it’s connected for you.
- Hover a connection between two steps and click Insert step to put a step in between. Remove deletes the connection.
- Use the + button and connect the new step yourself.
Branch with an If Block
An If Block checks a condition and sends the run down its true path or its false path. Steps on the other path don’t run.1
Add the block
Add If Block from BLOCKS and connect it after the step whose data it checks.
2
Write the condition
Click Add and choose Condition, AND Group, OR Group or NOT Group. For a condition, pick the value to check (usually a variable), an operator and, if the operator needs one, a value to compare with.
3
Connect both paths
Connect steps to the true and false handles. Leave a path empty to end the run there.
Pause a run with Wait
The Wait step pauses the run for an Amount of Seconds, Minutes, Hours or Days, up to 30 days in total. While it waits, the run shows as Waiting in the Runs tab with the time it picks up again, and you can cancel it there.Pass data between steps with variables
Any step input that accepts a variable shows a braces button (Insert variable). Click it, or type{{ in the field, to pick a value. The picker shows the type the input expects and flags values of the wrong type.
A variable is a path in double braces. The first part names where the value comes from:
run, workflow and organization hold details about the current run, the workflow and your workspace.
A step can only use the trigger and the steps that run before it on the same path. A step’s ID is set when you add it, from the step type: the first Ask AI step is ask_ai, the second ask_ai_1. Right-click a step and choose Copy step ID to get it.
To keep a value for later steps under a name you choose, add Hold Variable. To translate one value into another (for example a country code into a team), use Map Lookup.
Fix validation issues
Save and Activate both check the workflow first. If something is wrong, the Validation Issues Found dialog lists each issue; click Fix to jump to the step. Steps with problems also show a warning badge on the canvas; hover it to see why.Save, test and activate
1
Save a version
Click Save (tooltip: Save the draft as a new version). Your draft becomes the next version, such as v3. New versions start inactive.
2
Test it
With a saved version selected, click Test to run it once on data you choose. A test runs every step for real. See Test and monitor workflows.
3
Activate it
Click Activate and confirm. This deactivates any other active version of the workflow. From now on the trigger starts real runs.
Test and Activate need a saved version on screen. While you are looking at your draft, the editor shows Save instead.
Version history and restoring a version
Every Save creates a version. Edits never change a saved version: they go to your draft, which is based on the version you were viewing.- Switch versions. Use the version menu next to the workflow name. Draft appears when you have unsaved edits. The active version is marked Active.
- See history. Click the history icon (Version history) for every saved version, newest first, with who created it and when.
- Restore an older version. Select it in the version menu or history, then click Activate. To change it first, edit it, click Save to make a new version, then activate that.
- Throw away your edits. In the version menu, choose Discard draft. Your unsaved changes are deleted and the editor shows the version they were based on. This can’t be undone.
Duplicate or delete a workflow
In the workflow list, hover a workflow and click Duplicate workflow or Delete workflow. A copy is marked Cloned. Deleting can’t be undone.Related Documentation
Test and monitor
Test runs, Runs tab, failures.
Triggers and steps
Every trigger and step, with requirements.
Workflows overview
Life cycle and permissions.
Global variables
Shared credentials for steps.