Agents

Workflows

Automate work across your tools: pick a trigger, add steps, test with pretend customers, and publish. Workflows run every time the event happens.

Workflows run a set of steps every time something happens in your business: a new Meta lead, a board item moving to a status, a call ending, a form submission. They reach your team's tools, so a new lead can become an item on your Leads board and a call with a representative in the same minute.

Workflows

How workflows work

Each workflow has two parts:

  1. A trigger: the event that starts the workflow.
  2. Steps: actions and flow steps that run after the trigger fires.

You build workflows on a visual canvas with no code, or describe what you want and Ally builds it.

Workflows run in the background. When a job happens inside a conversation or on a board item and needs fixed steps, use Procedures instead.

Create your first workflow

Open Workflows

Open Workflows in the sidebar.

Start a workflow

Click New Workflow, or select it from the workflow dropdown.

Choose a trigger

Click the trigger node on the canvas and pick a trigger.

Add steps

Click + between steps to add an action or a flow step. Click each step to configure it.

Test it

Click Test workflow and run a full test or a scenario. See Test a workflow.

Publish

Click Publish. The workflow goes Live.

Your changes save automatically. After the first publish, edits stay as Unpublished changes until you click Publish changes, so you can work on a live workflow without affecting it.

Or let Ally build it

Open the prompt

In Workflows, press Cmd+K (or Ctrl+K).

Describe the workflow

For example: "When a Meta lead comes in, create an item on the Leads board and connect a call with a representative."

Review, test, and publish

Review the generated workflow, adjust it if needed, test it, then publish.

Ally can also change one field in an existing workflow when you ask, and it runs a simulation after it builds or edits one.

Workflow states

StateWhat it means
DraftNever published. It does not run.
LivePublished and on. It runs every time the trigger fires.
OffPublished and turned off. Settings are kept.

The workflow list shows a dot for each state: green for Live, amber for Off, and hollow for Draft. Filter the list by All, Live, Off, or Draft. In the editor, the toolbar chip shows the on/off switch, the version, and whether there are unpublished changes.

Triggers

A trigger is the event that starts your workflow. Every workflow has exactly one trigger.

Leads, contacts, and conversations

TriggerWhen it fires
Facebook LeadSomeone submits a Facebook or Instagram Instant Form. With Save the lead as a contact on (the default), the lead is matched to a contact by email or phone, or a new contact is created, and board items the workflow creates link to that contact.
Instagram CommentA comment on your posts matches your settings
Instagram DMA DM matches your keywords. The workflow answers that message, and everything else still goes to the agent.
New ContactA contact is added to your workspace
Contact Opted InA contact agrees to receive messages
Contact TaggedA contact gets a tag
Contact AssignedA contact is assigned to a teammate
Contact RepliedA known contact replies by email, SMS, or WhatsApp
Email OpenedA contact opens an email sent from a template
Email Link ClickedA contact clicks a link in an email sent from a template
Conversation endedA conversation ends: no new messages for a while, closed in the Inbox, the call is over, or the agent marked it resolved. Filter by agent, channel, how it ended, outcome (Resolved, Partly resolved, Unresolved, Escalated, Abandoned), and rating. Gives you the title, summary, outcome, ratings, tags, and next steps.
Conversation goal completedAn agent finishes a conversation started with Start conversation
Call Ended / Outbound Call EndedA call ends and the transcript is ready. Includes the recording and outcome.
Form SubmittedSomeone submits one of your Smart Forms

Boards

Board triggers fire on items of the board you pick. See Boards.

TriggerWhen it fires
Item createdA new item is added
Item enters statusAn item moves to a status. By default it also fires when an item is created in that status.
Field changesA field you pick changes
Person assignedSomeone is assigned to an item
File addedA file is attached to an item
Message arrivesA customer message arrives on a linked conversation
Comment addedSomeone comments on an item
Time in statusAn item stays in a status for a set time. Can repeat and count business hours only.
Date arrivesA date field on an item is reached
Item archived / Item restoredAn item is archived or restored

New Ticket is listed under Legacy when your workspace has the built-in Tickets board. Use Item created on the Tickets board instead.

Bookings, orders, and schedules

TriggerWhen it fires
New AppointmentA new appointment is booked through your calendar
Appointment Status ChangedAn appointment is confirmed, cancelled, or rescheduled
New OrderA customer places a new order
Order Status ChangedAn order's status changes
Scheduled (Recurring)Runs on a schedule: pick days of the week, time, and timezone

Integrations

IntegrationTriggers
ShopifyOrder Created, Order Paid, Order Fulfilled, Product Created, Product Updated, Product Deleted
monday.comItem created, Status changed
Zoho CRMRecord Created, Field Changed, Record Deleted, Lead Converted, User Created
OutlookOutlook Email Received, Outlook Event Created, Outlook Event Updated, Outlook Event Cancelled
HubSpotContact Created, Contact Updated, Contact Deleted, Company Created, Deal Created, Deal Updated, Ticket Created, Conversation Message, Appointment Created
GoHighLevelContact Created, Contact Updated, Contact Tag Updated, Inbound Message, Opportunity Created, Opportunity Updated, Appointment Created
NotionPage Created, Page Updated, Page Deleted, Database Item Created, Comment Created
Planning CenterPerson Created, Person Updated, List Result Created, Note Created, Donation Created, Event Created, Membership Created, Check-In Created, Plan Updated, Signup Created
Custom ConnectionsCustom Connection Event: an outside system posts to your inbound webhook

Trigger filters and variables

Many triggers have filters that narrow when the workflow fires, such as one form, one agent, or one status.

Every trigger gives you data to use in later steps with the {{variable}} syntax. For example:

  • New Order gives {{orderId}}, {{customerName}}, {{customerEmail}}, {{totalAmount}}, and more.
  • Form Submitted gives each answer as {{fields.<name>}}, the person's own words for a choice as {{answers.<name>}}, and {{declined}} for questions they chose not to answer.
  • New Appointment gives {{attendeeName}}, {{attendeeEmail}}, {{startTime}}, {{serviceName}}, and more.
  • Facebook Lead gives {{contactId}} when the lead is saved as a contact.

Actions

Actions are the steps that do the work. Each one can use data from the trigger and from earlier steps.

Messaging

ActionWhat it does
Start conversationAn agent opens a conversation with the contact toward a goal you describe. Optionally wait for the outcome.
Send messageAn agent sends exact text on SMS, WhatsApp, email, or another channel. Turn on Use a template to send an approved template, which reaches WhatsApp contacts outside the 24-hour window.
Send SMSText a contact in their SMS thread
Send templateSend a ready Reach template by SMS, WhatsApp, or email, with no agent needed. Replies go to the agent on that channel.
Link MailEmail from your workspace's Link Mail address

Template fields you leave empty fill themselves from the incoming data with the same name, then from the field's default. The editor marks them (automatic). Promotional emails respect opt-outs and include an unsubscribe footer.

Outbound calls

ActionWhat it does
Connect CallRing your team one by one, then connect the first who presses 1 with the customer. See below.
Voice DropCall and play a recorded message
Live TransferCall and transfer when the person presses a digit
Agent ConnectCall and connect a live agent

Connect Call reports how the call ended in {{customer_outcome}}: connected, no_answer, busy, unreachable, voicemail, declined, no_response, teammate_hung_up, customer_hung_up, or dial_failed. It waits for the voicemail check before the next step, so you can branch on voicemail. Teammate lines can include a desk extension. If a Connect Call already reached the customer in the last 12 hours, the step is skipped. See Human Handoff.

Instagram

ActionWhat it does
Reply to CommentReply to the comment that started the workflow. Needs the Instagram Comment trigger.
Send DMSend a DM, with optional buttons. Needs the Instagram Comment or Instagram DM trigger.

Under After sending, choose Move on, Wait for tap, or Wait for reply, and how long to wait (24 hours by default). A tap gives {{button_payload}} and {{button_title}} for a Switch. A reply gives {{reply_text}}, {{reply_email}}, and {{reply_phone}}.

AI

ActionWhat it does
Trigger AgentSend context to one of your agents
Ask AgentSend a message to an agent and wait for its reply
Use an agent's actionRun one of an agent's actions, such as booking an appointment
Send to Ally AgentSend a message to Ally to analyze, act, or report
AI TransformSummarize, rewrite, extract, or analyze text
AI DecisionClassify or route based on content
Generate Text / Generate Image / Generate VoiceCreate text, an image, or audio with AI
Create DocumentGenerate a shareable document with AI

Timing and approvals

ActionWhat it does
WaitPause for a set time (optionally business hours only), until a date, or until something happens
Wait for ApprovalPause until the workspace owner approves or rejects through Ally or in Workflows. Gives {{approval_status}}.

Wait until something happens waits for an event on the same contact, item, or conversation, such as Contact Replied, with a Give up after limit. Turn on Stop the workflow if it happens to build "send, wait, follow up" sequences: if the customer replies, the follow-up never sends.

Boards

ActionWhat it does
Create itemAdd an item to a board. Matches or creates the contact from an email or phone, or links the run's contact.
Get item / Find itemsLook up items
Update fields / Move to status / Assign personChange an item
Add comment / Attach file / Notify someoneAdd to an item or alert a teammate
Link items / Duplicate item / Move item to boardConnect or copy items
Set date / Increase or decrease number / Clear columnChange one field
Archive item / Restore itemArchive or bring back an item
Ask Ally to work on itAlly works the item in the background and leaves drafts for the item owner to review. Ally never sends anything on its own.

Data

ActionWhat it does
Create ContactCreate a contact, or update the one with the same email or phone
Apply Contact TagTag a contact
Assign TeammateAssign a contact to a teammate
Load ConversationRead a conversation for later steps
Change Order StatusUpdate an order's status
Generate documentCreate a branded PDF for a board item

Formatter, research, and HTTP

ActionWhat it does
Format Text / Format Number / Format Date / Format JSON / Format ListClean up data between steps
Lookup TableMap one value to another
Web SearchSearch the web and return results and a summary
HTTP RequestCall any API or webhook. Use it for tools without a native integration.

Integrations

IntegrationActions
GoogleSend Gmail, Create Calendar Event, Cancel Calendar Event. See Gmail and Google Calendar.
MicrosoftSend Outlook Email, Reply to Outlook Email, Create Outlook Event, Update Outlook Event, Cancel Outlook Event, Create Teams Meeting. See Outlook.
ShopifySync Products, Get Order, Add Order Note
StripeCreate Invoice, Create Payment Link. See Stripe.
monday.comCreate Item, Update Item, Move Item, Create Update, Get Item, List Items
Zoho CRMCreate, update, find, tag, note, convert, relate, attach, and delete records. See Zoho CRM.
HubSpotCreate or Update Contact, Update Contact, Add Note, Add to List, Create Deal, Update Deal, Create Ticket, Create Appointment, Send Conversation Message
GoHighLevelCreate or Update Contact, Update Contact, Add Tag, Add Note, Create Opportunity, Send SMS, Create Appointment
NotionCreate Page, Update Page, Append Content, Create Database Item, Update Database Item, Query Database, Search, Add Comment, Archive Page
Planning CenterCreate Person, Update Person, Find Person, Get Person, Add Note, Add Email, Add Phone, Create Event, Add Group Member, Create Workflow Card

Flow steps

Flow steps control which path a run takes. Add them from the + picker.

StepWhat it does
ConditionOnly continue if the rule is true
SwitchSend the run down different paths, such as one per AI Decision result or button tapped
FilterKeep only the list items that match
LoopRepeat steps for each item in a list
MergeBring paths back together
StopEnd the run here
FailEnd the run and mark it failed

A condition compares a Field to a Value with an operator like equals, contains, or greater than.

Variables

Use data from the trigger and from earlier steps anywhere in a later step: message text, AI prompts, HTTP payloads, and conditions. The variable picker lists what each step gives you. Common outputs:

VariableFrom
{{customer_outcome}}, {{accepted_member_name}}Connect Call
{{approval_status}}Wait for Approval (approved or rejected)
{{ai_decision}}AI Decision
{{stripe_invoice_url}}, {{stripe_payment_url}}Stripe actions
{{results}}, {{summary}}Web Search
{{button_payload}}, {{reply_text}}Instagram Send DM
{{document_url}}, {{document_title}}Create Document
{{zoho_record_id}}, {{zoho_record_url}}Zoho CRM actions
{{calendar_event_id}}, {{teams_join_url}}Outlook Calendar actions

AI Transform and Ask Agent let you name their output, so you choose the variable.

Test a workflow

Click Test workflow in the toolbar to open the test sheet.

TestWhat it does
Full testRuns your draft from the trigger with sample data. Click Ask Ally for a sample or Load sample from a previous run to fill it.
Branch testRuns one part of the workflow
Live published versionRuns the live version as if a real event arrived. It asks you to confirm, because real messages can send.
ScenariosA pretend customer you describe, with what should happen. The workflow runs against them without sending anything real.

Scenarios can include simulated events, like a contact replying, to prove that a Wait until something happens path works.

Checks at publish

Publish stops you when something would fail in production:

  • A template that is missing, paused, or not approved, or a required template field with no value.
  • Send template on a board trigger with no recipient.
  • Reply to Comment or Send DM without an Instagram trigger.

It warns, without blocking, when a form answer is mapped into a board field it may not fit, such as a text answer into a phone field.

Run history

Every time a workflow runs, it creates a run. Open run history in the editor to see each run's status, when it was triggered, and the trigger data.

StatusWhat it means
Completed (green)All steps ran
Failed (red)A step hit an error and the run stopped
Running (blue)The run is in progress
Waiting (yellow)Paused on a Wait, an approval, or a reply

Example workflows

New Meta lead to a call in minutes

Trigger: Facebook Lead, with Save the lead as a contact on

  1. Create item on the Leads board.
  2. Connect Call to your sales team.
  3. Switch on {{customer_outcome}}: if connected, Move to status "Contacted". Otherwise, Send template with a follow-up SMS.

Follow up until they reply

Trigger: Item enters status "Quote sent"

  1. Wait 2 days, until Contact Replied, with Stop the workflow if it happens on.
  2. Send template: a short check-in email.
  3. Wait 3 more days, the same way.
  4. Notify someone: tell the item owner to call.

Unresolved conversations become work

Trigger: Conversation ended, outcome Unresolved or Escalated

  1. Create item on the Support board with the summary.
  2. Ask Ally to work on it so the owner gets a draft reply to review.

High-value order approval

Trigger: New Order, with a condition on {{totalAmount}} greater than 500

  1. Wait for Approval: ask the owner to review the order.
  2. Switch on {{approval_status}}: if approved, Change Order Status to confirmed. If rejected, change it to cancelled and email the customer.

Tips

  • Start small. A trigger and one action, then add steps.
  • Test with scenarios. A pretend customer shows the path without sending anything.
  • Publish changes on purpose. Edits wait as Unpublished changes until you publish.
  • Check run history. It shows exactly where a run failed.

FAQ

How many workflows can I have?

There's no limit on the number of workflows per workspace.

Can I turn a workflow off without deleting it?

Yes. Switch it off in the toolbar chip. It moves to Off and keeps its settings.

What happens if a step fails?

The run stops at that step and is marked Failed. Other runs and workflows aren't affected. Add a Condition or Switch to handle expected cases, like no answer on a call.

How is a workflow different from a procedure?

A workflow runs in the background on an event, with no conversation. A procedure is steps an agent follows in a conversation or on a board item.

Can workflows call external APIs?

Yes. HTTP Request calls any URL with a custom method, headers, and body. For incoming events, use Custom Connections.

Next steps