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 how they work

In pilot

See the company's workflows, and read a short guide to how a workflow runs.

What you can do

  • Browse workflows and their state
  • Read How workflows work
  • Describe a new workflow in your own words and let Falcon draft it

In Falcon: Workflows · How workflows work

In the API: listPipelines

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: Edit

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: Edit

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: Edit

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: Edit

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: Edit

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: Waiting for you

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
  • 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, rotateIncomingRequestMap, receiveIncomingRequest

Runs

In pilot

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

What you can do

  • Retry, cancel or reschedule a run
  • 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

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: Edit

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”
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
Rotate an incoming request addressPeople who can rotate secretsChanges · needs “change settings” · waits for your approval
Receive a mapped incoming requestThe configured sender verification; 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
Cancel 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
Read text shared-sender reply settingsAnyone who can see itReads · needs “look”
Set text shared-sender reply settingsPeople who manage toolsChanges · needs “change settings”
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