Sign up

Workflows

Chain agents and steps together, start them from events, and decide what happens when someone replies.

A workflow is a series of steps that runs when something happens, such as a new email, a form, a call or a time of day. Each step is an agent or a check.

Falcon shows each workflow as one sentence you can read, and as steps you can open and change.

Like agents, workflows have drafts and a Live version. You can try a workflow before it runs for real.

Workflow steps with retries if a step fails, and two side chains: one for when the person is interested, one for when they reply STOP.
Side chains decide what happens when someone says yes, says STOP, or a step fails.

Workflows and categories

In pilot

See the company's workflows grouped by category, and start a new one.

What you can do

  • Browse workflows by category, with their state
  • Create a workflow with a name and a category, then choose how it starts
  • Move a workflow to another category
  • Ask Studio to describe and build a workflow for you

In Falcon: Workflows · New workflow

In the API: listPipelines, listWorkflowFolders, createWorkflowFolder, moveWorkflowToFolder

Edit a workflow

In pilot

Add, move and remove steps on a canvas, with the chosen step's settings beside it.

What you can do

  • Add an agent step and choose its tools
  • Reorder or remove steps
  • Try the workflow before it is Live

In Falcon: Agent flow

In the API: getPipelineVersion, testPipeline, updateStepToolSettings, getStepToolSettings

How a workflow starts

In pilot

Start a workflow on a schedule, when an app sends an event, when a conversation arrives, or when another system calls it.

What you can do

  • Pick a start from connected apps first
  • Set the start's details inline, with examples
  • See an example of the event that starts it

In Falcon: Agent flow

In the API: listPipelineTriggers, createPipelineTrigger, getPipelineEventExample

Side chains and retries

In pilot

Hang extra steps off a step for when someone is interested, replies STOP, or the step fails.

What you can do

  • Add a side chain to any step
  • Retry a failed step, or run a side chain instead

In Falcon: Agent flow

Hours check

In pilot

A step that checks whether a person or place is open now, and sends the workflow one way or the other.

What you can do

  • Check an identity's working hours
  • Send out-of-hours work down its own path

In Falcon: Agent flow

Front desk

In pilot

A first step that greets the person, looks them up in past conversations, and hands them to the right agent, such as sales or service.

What you can do

  • Name the routes and what each is for
  • Match the person to past conversations first
  • Send each route to its own agent

In Falcon: Agent flow

Engagements

In pilot

Say what counts as someone engaging, such as replying or booking, so each can start a side chain.

What you can do

  • Define what the company counts as engaging
  • Use an engagement to start a side chain

In Falcon: Engagements

Waiting for you

In pilot

Drafts that need a person before they are sent, from every workflow, in one place.

What you can do

  • Send a draft as it is
  • Edit a draft, then send it
  • Decide not to send it

In Falcon: Inbox

In the API: adoptGmailReplyDraftTemplate, installGmailReplyDraftTemplate

Request mapping

In pilot

Give any outside system its own address to call, and map what it sends into a workflow or an agent.

What you can do

  • Create an address for each system and rotate it when needed
  • Map fields from the request into the workflow
  • Start from ready-made settings for Twilio, Zoom or RingCentral recordings
  • Check Stripe, Shopify, GitHub and Slack requests against the signature each one sends
  • Check signatures or a shared key before anything runs
  • Map each value from a body field, query parameter, header or fixed value into a start, identity or customer field, or an outgoing header
  • Name who answers with one header, X-Falcon-Identity (the identity's code), and who is writing in with X-Falcon-User-Email, X-Falcon-User-Phone, X-Falcon-User-Name and X-Falcon-User-Id; the old per-field X-Sender headers work until 2026-12-27
  • See what the target receives, the steps that get it first, and what your system gets back
  • Flag maps for a look when a published workflow changes its start fields or result

In the API: listIncomingRequestMaps, listIncomingRequestTargets, createIncomingRequestMap, updateIncomingRequestMap, revealIncomingRequestMapSecret, rotateIncomingRequestMap, receiveIncomingRequest

Runs

In pilot

See each time a workflow ran, and step in when one needs it.

What you can do

  • Retry or reschedule a run
  • Stop a run at its next step boundary; a call already in progress finishes
  • See who stopped it; unanswered questions are withdrawn without a fallback
  • Run a scheduled run now

In Falcon: Runs

In the API: retryPipelineRun, cancelPipelineRun, reschedulePipelineRun, runnowPipelineRun

Publish and roll back

In pilot

Make a workflow Live, go back to an earlier version, or archive it.

What you can do

  • Make a version Live
  • Roll back to the previous version
  • Archive a workflow you no longer use

In Falcon: Publish

In the API: getPipelineVersion, rollbackPipeline, archivePipeline

Webhooks out

In pilot

Tell your own systems when a workflow does something, by sending them a signed message.

What you can do

  • Add an address to notify
  • Choose which events it receives

In Falcon: Webhooks out

In the API: listPipelineWebhooks, createPipelineWebhook, updatePipelineWebhook

Web chat on your website

In pilot

Put a workflow's chat on your website with one snippet. Each web chat has its own random chat key and only opens on the websites you allow.

What you can do

  • Copy the snippet: one short line, then the script naming this chat's key
  • Allow up to 20 websites: exact https sites like www.acme.com or every subdomain with *.acme.com (a bare * and wildcards like *.co.uk are refused)
  • Open it from your own button, even one added after the page loads, with data-chat-open="<chat key>" and no script, or with the snippet's open call; close, toggle, send, identify and on take the key too
  • Set the greeting, title, subtitle, message box text and up to three suggested questions
  • Choose a floating bubble (corner, distance from the side and bottom, icon, open by itself after some seconds) or always open on the page
  • Pick the main colour and icon colour (the company colour and white by default) and which files visitors can attach
  • Show replies as they are written or all at once, and let returning visitors continue their last chat for a number of days (30 by default, 0 starts fresh)
  • Pause it with the On / Paused switch; removing a website or pausing stops chats on their next message

In Falcon: Ways in

In the API: listPipelineWebChats, createPipelineWebChat, updatePipelineWebChat, deletePipelineWebChat

When a reply could be for more than one

In pilot

If two agents or identities wrote to someone and they reply, choose whether the reply goes to the latest, to both, or is read to decide.

What you can do

  • Set the rule for each channel
  • Override it on a workflow step

In the API: getTextMessagingSettings, putTextMessagingSettings

Taking turns

In pilot

Share new conversations between identities in turn, such as sales reps who are available, and keep returning people with the same one.

What you can do

  • Rotate new leads between identities in turn, to the least busy, or by weight
  • Only give turns to identities that are active, inside their working hours and free on their calendar
  • Set a daily limit per identity, and choose who answers or wait when nobody is available
  • Keep a returning customer with their rep on any channel, and switch them when the rep leaves
  • Move a person to someone else by hand
  • See conversations per identity and why each one got them

In Falcon: Identity

In the API: getIdentityTurns, findIdentityTurn, reassignIdentityTurn

Acting as on a step

In pilot

Pick which identity an agent acts as on each step, so the same agent can appear three times as three people.

What you can do

  • Choose an identity for each agent step, or leave it to the workflow
  • Let a step take turns among identities, keeping returning people with the same one
  • Use the step's identity for its tools, what it remembers and the messages it sends
  • Commit to GitHub as the identity, with the requester credited

In Falcon: Agent flow

Topics and keywords on messages

Coming next

Label outgoing messages with a topic, so opting out of marketing never stops order updates, and route replies by keyword.

What you can do

  • Keep a list of topics for the company
  • Let people opt out of one topic only
  • Route a reply by keyword

In the API: getCompanyMessageTopics, updateCompanyMessageTopics

Evaluate steps

Coming next

A step that scores or checks the work of earlier steps, and workflows that only evaluate.

What you can do

  • Check a plan is complete before it is sent
  • Run an evaluation on its own

Sequences that repeat

Coming next

Repeat a set of steps, such as a follow-up every few days, until someone replies or a limit is reached.

What you can do

  • Repeat steps on a schedule
  • Stop when the person replies

Nudges and review rounds

Coming next

Remind people who haven't answered, and pass work through more than one review before it goes out.

What you can do

  • Send a reminder after a set time
  • Add review rounds

Who can do what

Who may do each thing in this guide, and what an AI assistant connected as that person may do with it. Roles are set in Company settings › Roles.

WhatWho mayAn assistant
Lists the company's workflowsAnyone who can see itReads · needs “look”
List workflow foldersAnyone who can see itReads · needs “look”
Create a workflow folderPeople who can edit itChanges · needs “change settings” · waits for your approval
Move a workflow to a folderPeople who can edit itChanges · needs “change settings” · waits for your approval
Get workflow versionAnyone who can see itReads · needs “look”
Test workflowPeople who can edit itReaches outside · needs “run and test” · waits for your approval
Update step tool settingsPeople who can edit itChanges · needs “change settings” · waits for your approval
Read workflow step tool settingsAnyone who can see itReads · needs “look”
Lists what starts a workflowAnyone who can see itReads · needs “look”
Adds something that starts a workflowPeople who can edit itReaches outside · needs “change settings” · waits for your approval
Get workflow event exampleAnyone who can see itReads · needs “look”
Adopt a Gmail reply draft agentPeople who can edit itChanges · needs “change settings” · waits for your approval
Install the Gmail reply draft workflowPeople who can edit itChanges · needs “change settings” · waits for your approval
List incoming request mapsAnyone who can see itReads · needs “look”
List what request map targets receive and give backAnyone who can see itReads · needs “look”
Create an incoming request mapPeople who can edit itChanges · needs “change settings” · waits for your approval
Update an incoming request mapPeople who can edit itChanges · needs “change settings” · waits for your approval
Show a webhook signing secretPeople who can reveal secretsChanges · needs “change settings” · waits for your approval
Rotate an incoming request addressPeople who can rotate secretsChanges · needs “change settings” · waits for your approval
Receive a mapped incoming requestThe configured sender verification or the API way in's server key; no Studio session is accepted.Not offered to assistants
Retry workflow runPeople who can edit itReaches outside · needs “run and test” · waits for your approval
Stop a workflow runPeople who can edit itCannot be undone · needs “run and test” · waits for your approval
Reschedule workflow runPeople who can edit itChanges · needs “run and test” · waits for your approval
Runnow workflow runPeople who can edit itReaches outside · needs “run and test” · waits for your approval
Restores an older workflow version as the draft. To change Live, make an older version live insteadPeople who can make it LiveReaches outside · needs “change settings” · waits for your approval
Archive a workflowPeople who can edit itCannot be undone · needs “change settings” · waits for your approval
Lists a workflow's webhooksAnyone who can see itReads · needs “look”
Adds a webhook to a workflowPeople who can edit itReaches outside · needs “change settings” · waits for your approval
Changes a workflow webhookPeople who can edit itReaches outside · needs “change settings” · waits for your approval
List a workflow's web chatsAnyone who can see itReads · needs “look”
Add a web chat to a workflowPeople who can edit itChanges · needs “change settings” · waits for your approval
Change a web chatPeople who can edit itChanges · needs “change settings” · waits for your approval
Remove a web chatPeople who can delete itCannot be undone · needs “change settings” · waits for your approval
Read text shared-sender reply settingsAnyone who can see itReads · needs “look”
Set text shared-sender reply settingsPeople who manage toolsChanges · needs “change settings” · waits for your approval
Report on taking turnsAnyone who can see itReads · needs “look”
Find who a person is withPeople who can edit itReads · needs “look”
Move a person to another identityPeople who can edit itChanges · needs “change settings” · waits for your approval
Read company message topicsCompany administratorsReads · needs “look”
Update company message topicsCompany administratorsChanges · needs “change settings” · waits for your approval

Next: Connections