Skip to main content

Workflows

A workflow is a set of steps that VoisX runs in order, drawn as a graph on a canvas. Each step is a node: an agent, a tool call, a decision, a loop, an outbound call and so on. Workflows give you a fixed, repeatable path through a process, where a single agent would decide the path on its own.

When to use a workflow​

Use a workflow when:

  • A process always follows the same steps, such as intake, qualification or follow-up.
  • Tools must run in a set order, or only after a condition is met.
  • You want to run something on a schedule or when another system calls a URL.
  • You want to call a list of numbers one after another.

Use an agent on its own when the conversation is open-ended and the agent should choose what to do next. See Agents.

Create a workflow​

  1. In your project, open Workflows (under Build in the sidebar).
  2. Click New workflow, or open the Workflow gallery and pick a ready-made template to start from.
  3. Drag nodes from the palette onto the canvas, or click the + button, then connect them.
  4. Click a node to set its properties in the side panel.
  5. Click Save.
  6. Add a trigger on the Triggers tab so the workflow runs by itself. See Triggers and runs.

You need the Contributor role or higher in the project to create or edit workflows.

tip

Auto layout arranges the nodes top to bottom. You can copy and paste nodes with ⌘C / ⌘V (Ctrl+C / Ctrl+V on Windows).

Nodes​

The palette groups nodes into four categories.

Triggers​

NodeWhat it does
StartThe entry point of the flow.
Webhook TriggerMarks that the flow starts from a webhook. The webhook URL itself is set up on the Triggers tab.

Actions​

NodeWhat it does
Voice AgentRuns one of your agents on the current input, with its own prompt, skills, tools and knowledge base. You can set retries and a retry delay.
Tool / APIRuns an action of a tool or integration in your project, for example looking up a CRM record.
CalendarFinds available slots, books an appointment or cancels one, using VoisX's built-in calendar.
Outbound CallPlaces a phone call through an agent that has a phone line, waits for the call to end and returns the outcome.
Text ListA list of values you paste in, one per line, such as phone numbers. Feed it into a Loop.
Sub-workflowRuns another saved workflow as a step.

Logic​

NodeWhat it does
DecisionTwo-way branch on a condition, for example whether a value equals something.
SwitchRoutes to one of several paths, one per case.
LoopRepeats the connected steps for each item in a list, up to a maximum number of iterations.
CodeRuns a short Python snippet to reshape data. The node's panel lists the variables you can use.
ParallelRuns every outgoing branch at the same time.
MergeWaits for all incoming branches to finish, then combines their results.

System​

NodeWhat it does
Human HandoffHands the conversation to a person, with a reason and a department. The run pauses at this step.
Error HandlerCatches a failure in a step so the flow can take another path instead of failing.
EndEnds the flow.

Outbound calls in a workflow​

The Outbound Call node dials through an agent's own number, carrier and voice settings. The agent's Conversation Goal decides whether the outcome counts as positive or negative.

To call a list, connect a Text List to a Loop and put the Outbound Call inside the loop. Each number is called in turn.

note
  • The calling agent needs a phone line first: a Twilio or Plivo number, or your own carrier over a SIP trunk. Set one up under Channels.
  • If your project limits outbound calling hours, calls outside those hours are refused. The node reports the call as blocked, with the next time calling opens.
  • Start calling workflows from a schedule. A webhook caller waits for the whole run to finish, which takes as long as the calls do.

Test a workflow​

  • Test tab: type a message and click Run to run the whole workflow.
  • Run from here: in a node's panel, switch to Test, give mock input and run the flow from that node onward.

Tests run the saved workflow. Save first to include your latest changes.

Control which tools a workflow can use​

On the Tools tab, set each tool in the project to Allow or Deny for this workflow. Agents inside the workflow never call a denied tool, even if asked to. Tools with no setting are allowed.

Versions​

Each time you save, VoisX keeps a snapshot on the Versions tab. Click Restore on an earlier version to put it back on the canvas. Restoring is itself saved as a change, so you can go forward again by restoring a later version.

Export​

Click Export JSON to download the workflow, including unsaved changes, as a JSON file.

Next steps​

Was this page helpful?