# Get a workflow running

} from '../../../components/docs';

A workflow is a graph: one **trigger**, then nodes. Building it under **Work Flows** is not enough. A phone trigger does nothing until the workflow is **on** for that agent under **Skills - Tools & Workflows**. An unsaved canvas does not run.

The node catalog (API, email, SMS, HubSpot, branches) is [Workflow Nodes](https://docs.voicelogica.ai/workflow-nodes/). This section is *when* the graph starts.

## Why setup matters

Three things have to be true or the graph is decoration:

1. A **trigger** sits on the canvas.
2. You clicked **Save & go live** (or saved a version).
3. For a phone trigger - the workflow toggle is **on** for *this* agent under **Business Workflows**.

**Run test** in the builder proves the graph. It does not prove a live caller will hit it.

## Open Work Flows

Sidebar - **Work Flows**. Page line: *Automations that connect systems, fetch live data, send messages and run logic — triggered by calls, schedules or events.*

Empty state: **Build your first workflow**. Button: **+ Workflow**.

  <ShotPlaceholder
    src="/assets/workflows/list.png"
    name="wf-list"
    alt="Work Flows empty state Build your first workflow"
    capture="Sidebar Work Flows."
  />

**+ Workflow** opens **Create new workflow** (*Name it now — configure capabilities in the builder.*). Beta note: limited to **5 workflows during beta**. Enter **Workflow name**, then **+ Create workflow** (or Cancel).

  <ShotPlaceholder
    src="/assets/workflows/create-workflow.png"
    name="wf-create"
    alt="Create new workflow dialog with beta limit"
    capture="Create new workflow."
  />

You can also **+ Add workflow** from the agent's **Skills - Tools & Workflows** - that creates *and* lists it under **Business Workflows**.

## Which trigger

In the builder, **+ Add Trigger** opens **Phone Triggers** (and more as you scroll):

- **Know who is calling before the AI speaks** — turn on **Call Start Trigger** (needs Start the workflow when a call is received. [On Call Start](https://docs.voicelogica.ai/workflows/on-call-start/).)
- **Act only after someone actually answers** — turn on **When Call Connects** (needs Start when a call is connected. [When Call Connects](https://docs.voicelogica.ai/workflows/when-call-connects/).)
- **The caller asked for something you must look up live** — turn on **During Call Trigger** (needs The model decides when. Adds latency. [During Call](https://docs.voicelogica.ai/workflows/during-call/).)
- **They said a phrase (emergency, cancel)** — turn on **Keyword Detected** (needs Start when caller says specific words. [Keyword Detected](https://docs.voicelogica.ai/workflows/keyword-detected/).)
- **They typed digits (# / timeout)** — turn on **On Key Pressed** (needs Start when caller presses a key. Needs keypad settings on the agent. [On Key Pressed](https://docs.voicelogica.ai/workflows/keyword-pressed/).)
- **After hang-up: CRM, email, webhook** — turn on **Call Ends Trigger** (needs Start when a call is ended. [On Call End](https://docs.voicelogica.ai/workflows/on-call-end/).)
- **Nobody picked up** — turn on **Missed Call Trigger** (needs Start when a call is missed. [Missed Call](https://docs.voicelogica.ai/workflows/missed-call/).)
- **My system starts the graph** — turn on **On API Call** (needs [On API Call](https://docs.voicelogica.ai/workflows/on-api-call/). Does not need an agent attach.)

  <ShotPlaceholder
    src="/assets/workflows/add-trigger.png"
    name="wf-triggers"
    alt="Add a Trigger Phone Triggers catalog"
    capture="Workflow Add Trigger."
  />

- **Call Start** — before pickup
- **When Call Connects** — after answer
- **During Call** — the model invokes it
- **Call Ends** — after hang-up
- **Keyword Detected** — spoken phrase
- **On Key Pressed** — DTMF
- **Missed Call** — unanswered inbound
- **On API Call** — POST run-workflow

HubSpot created / property-changed, WooCommerce, and similar event triggers appear in the same catalog when those [integrations](https://docs.voicelogica.ai/integrations/) are connected.

**AI Response to Caller** only exists under a live-audio trigger (Start, Connect, During, Keyword, Key Pressed) - not End or Missed. **Transfer Call** only under Start, Connect, or During.

## First setup - one Call Start, attach, prove it

1. **Sidebar - Work Flows - + Workflow**

   Name it after the job (for example Caller lookup). **+ Create workflow**.

2. **+ Add Trigger - Call Start Trigger**

   Phone Triggers. Leave it empty - this trigger has no required fields.

3. **Save & go live** (top right)

   Use **Save as version** when you want a named checkpoint. Run a builder test if available - dry-run keeps Email / SMS from sending.

4. **My Agents - this agent - Skills - Tools & Workflows**

   Under **Business Workflows** (`N/M active`), turn the row **on**. Or use **+ Add workflow** if you created it from here.

     <ShotPlaceholder
       src="/assets/workflows/index-attach.png"
       name="index-attach"
       alt="Business Workflows with workflow toggle off"
       capture="Agent Tools and Workflows Business Workflows."
     />

5. **A real inbound call** (or **Try this agent**)

   Open **Calls**. If nothing ran, the toggle is off, you tested a different agent, or you never saved.

Workspaces are on a beta workflow cap (**Limited to 5 workflows during beta**). If **Create workflow** is blocked, delete an unused graph or wait for the cap to lift.

## Troubleshooting

**The workflow never runs on a live call**

1. **Save & go live** in the builder.
2. The workflow is **on** for *this* agent (**Business Workflows**).
3. The trigger matches the event (Start vs End vs During).
4. You called the agent that has the toggle, not a second one.

**Builder test works, callers do not**

Builder tests skip the agent attach. Turn the toggle on, then place a real call.

## Next Steps

[On Call Start](https://docs.voicelogica.ai/workflows/on-call-start/) - first useful graph (lookup before pickup).  
[During Call](https://docs.voicelogica.ai/workflows/during-call/) - only when the ask is not known in advance.  
[Workflow Nodes](https://docs.voicelogica.ai/workflow-nodes/) - API, email, SMS, branches.  
[Tools & Workflows](https://docs.voicelogica.ai/agent-configuration/built-in-tools/) - attach + built-in tools.