{"slug":"signalwire-call-flow-builder","title":"SignalWire Call Flow Builder (CFB)","tags":["signalwire","call-flow-builder","no-code","ivr","visual-editor"],"agent_summary":"Drag-and-drop visual editor in the SignalWire portal. Generates valid SWML under the hood. Node taxonomy (Handle Call, AI Agent, Forward, Gather, Conditions, Request, Set Variables), variable substitution with `%{...}`, building and deploying flows, and CFB-vs-SWML decision rules.","trigger_phrases":["call flow builder","CFB SignalWire","visual call flow","no-code IVR","AI Agent node","Forward to Phone node","Gather Input speech DTMF","Set Variables node"],"runnable":false,"markdown":"\n# SignalWire Call Flow Builder\n\nCFB is the drag-and-drop visual editor for voice flows. Lives under the **Tools** tab in the SignalWire portal. Generates valid SWML under the hood, so any flow built in CFB is equivalent to a hand-written script. Useful when non-technical team members need to edit flows, or when the flow is simple enough that visual debugging beats a code review.\n\n## Node taxonomy\n\n### Starting node (always present)\n\n| Node | Description |\n|---|---|\n| **Handle Call** | Entry point for every incoming call. Cannot be deleted. Cannot be duplicated. |\n\n### Action nodes\n\n| Node | Description |\n|---|---|\n| **Answer Call** | Marks the call answered. Optional — most nodes auto-answer when connected after Handle Call. |\n| **Hang Up Call** | Disconnects. Reason field is for logs only. |\n| **Play Audio or TTS** | Plays audio URL, ringtone (`ring:5:jp`), silence (`silence:5`), or TTS. Supports SSML and variables. |\n| **Send SMS** | Sends an SMS mid-flow. Fields: To, From, Text. Supports variables. |\n\n### Forwarding nodes\n\n| Node | Description |\n|---|---|\n| **Forward to Phone** | Forwards to phone(s) or SIP endpoint(s). Outputs: Success, No Answer, Busy, Decline, Error. Supports sequential or simultaneous dialing. Enable Whisper runs SWML before connecting. |\n\n### Recording nodes\n\n| Node | Description |\n|---|---|\n| **Start Call Recording** | Background dual-channel recording. Fields: Name, Stereo, Beep, Terminators, Format. Auto-stops on disconnect. |\n| **Stop Call Recording** | Stops a named recording. URL available as `%{record_call_url}`. |\n| **Voicemail Recording** | Async voicemail record. Fields: Stereo, Beep, Terminators, Max Length, Initial/End Silence Timeout, Format. URL via `%{record_url}`. |\n\n### Input nodes\n\n| Node | Description |\n|---|---|\n| **AI Agent** | Connects the call to a SignalWire AI Agent Resource. Single setting: AI Agent Name (dropdown populated from Resources). Handles NLP, sentiment, SWAIG, multi-turn dialogue. |\n| **Gather Input** | Collects DTMF and/or speech. Outputs: one connector per input option + Unknown + No Input. `%{prompt_value}` holds detected speech for the Unknown path. |\n| **Request** | HTTP GET/POST/PUT/DELETE. Headers and Body configurable. Response in `%{request_response_body}` or `%{request_response.}`. Outputs: user-defined conditions + Else + Failure. |\n\n### Decision / data nodes\n\n| Node | Description |\n|---|---|\n| **Conditions** | JavaScript if/else-if logic over `%{variable}` expressions. JS operators (`&&`, `\\|\\|`, `==`, `.slice()`) work. |\n| **Execute SWML** | Fetches and executes a remote SWML document. Passes Params + Meta. Return values via `%{return_value.}`. |\n| **Set Variables** | Creates named variables accessible as `%{vars.}` for the rest of the flow. |\n| **Unset Variables** | Clears previously set variables. |\n\n## AI Agent node — what it does\n\nReplaces an entire IVR tree with natural-language handling. Setting: `AI Agent Name` (dropdown from Resources).\n\nCapabilities the connected agent handles:\n\n- Natural language processing (free-form speech understanding)\n- Sentiment analysis\n- SWAIG functions (CRM lookup, SMS, transfers)\n- Multi-turn dialogue with context switching\n\nPrerequisites — must exist before the node will work:\n\n1. **Resources → + Add New → AI Agent → Custom AI Agent**.\n2. Configure system prompt, persona, SWAIG functions.\n3. Fund the account (AI agents are billed per minute).\n4. The agent name will appear in the AI Agent node dropdown.\n\n## Variables reference\n\nAll variables use the form `%{}`.\n\n### Built-in call variables (always available)\n\n| Variable | Description |\n|---|---|\n| `%{call.from}` | Caller's number |\n| `%{call.to}` | Number dialed |\n| `%{call.direction}` | Currently always `inbound` |\n| `%{call.call_id}` | Unique call ID |\n| `%{call.state}` | Current call state |\n| `%{call.type}` | Call type |\n\n### Request node variables\n\n| Variable | Description |\n|---|---|\n| `%{request_response_body}` | Full response body |\n| `%{request_response.}` | Specific JSON field |\n| `%{vars.request_response.}` | String field for conditional expressions |\n\n### Recording variables\n\n| Variable | Description |\n|---|---|\n| `%{record_call_url}` | URL of stopped Call Recording |\n| `%{record_url}` | URL of Voicemail Recording |\n\n### Gather Input variables\n\n| Variable | Description |\n|---|---|\n| `%{prompt_value}` | Speech detected on the Unknown output path |\n\n### Custom (Set Variables node)\n\n- Access with `%{vars.}` or `%{}`.\n- JS expressions work: `%{call.from.slice(2,5)}` extracts the area code.\n- String comparisons in conditions: `%{vars.request_response.dayOfWeek == 'Thursday'}`.\n\n## Building a flow\n\n1. Dashboard → **Tools** tab → Call Flow Builder.\n2. **Add New** → name the flow → **Save**.\n3. **More Options → Edit** to open the canvas.\n4. The canvas starts with a single **Handle Call** node — the entry point.\n5. Drag nodes from the left panel.\n6. Connect them: click-drag from output (right side) to input (left side).\n7. Click a node to open its config panel.\n8. Click **Deploy** to make the flow live.\n9. Assign the flow to a phone number.\n\nEvery node has one input on the left and one or more outputs on the right. Multiple outputs = branching logic.\n\n## Assigning a flow to a DID\n\n- **Phone Numbers** in the Dashboard.\n- Select the number → edit **Call Handler**.\n- Set handler to **Call Flow** → select the flow by name.\n- Save.\n\nFlows can also be assigned to SIP Addresses and Domain Applications the same way.\n\n## Versioning\n\n- **Version History** (top-left of CFB) shows all versions with timestamps.\n- Each **Deploy** creates a new version (1.0, 2.0, 3.0…).\n- Roll back via Version History → select old version → **Restore**.\n- Save without deploying to test changes safely.\n\n## CFB vs SWML vs Python SDK\n\n| Situation | Use |\n|---|---|\n| Simple IVR, AI handoff, voicemail, basic branching | **CFB** |\n| Non-technical team members editing flows | **CFB** |\n| Visual debugging matters more than code review | **CFB** |\n| Complex conditionals, loops, dynamic SWML | **SWML directly** |\n| Git-versioned, programmatically generated flows | **SWML directly** |\n| Real-time call control, outbound dialing, browser SDK | **Python / Node SDK** |\n| Hybrid: visual flow + custom logic | **CFB + Execute SWML node** pointing at hosted SWML |\n\n## Common patterns\n\n### Basic AI Agent (simplest)\n\n```\nHandle Call → Answer Call → AI Agent: \"My Agent\"\n```\n\n### IVR with routing\n\n```\nHandle Call → Answer Call → Gather Input (Press 1=Sales, 2=Support)\n → [Sales] → Forward to Phone: sales_number\n → [Support] → Forward to Phone: support_number\n → [No Input] → Play TTS \"No input received\" → Hang Up\n```\n\n### AI Agent with recording\n\n```\nHandle Call → Answer Call → Start Call Recording → AI Agent: \"My Agent\"\n```\n\n### Voicemail with SMS notification\n\n```\nHandle Call → Answer Call → Play TTS \"Leave a message after the beep\"\n → Voicemail Recording (beep on, terminator=#)\n → Send SMS: \"New voicemail from %{call.from}: %{record_url}\"\n```\n\n### Business hours routing (API-based)\n\n```\nHandle Call → Answer Call → Request (GET timeapi.io)\n → Conditions: %{request_response.hour} >= 9 && %{request_response.hour} < 17\n → [Open] → AI Agent or Forward to Phone\n → [Else] → Play TTS \"We're closed\" → Voicemail Recording\n```\n\n### Loop guard on Gather Input\n\n```\nHandle Call → Answer Call → Set Variables: loop_count = 0\n → Gather Input\n → [No Input] → Set Variables: loop_count = %{loop_count} + 1\n → Conditions: %{loop_count} >= 2\n → [True] → Hang Up\n → [Else] → back to Gather Input\n```\n\n### Preserve caller ID on forward\n\n```\nHandle Call → Forward to Phone (From: %{call.from}, To: +15551234567)\n → [Success] → (connected)\n → [No Answer / Busy / Decline / Error] → Hang Up\n```\n\n### Multi-request flow (variable persistence)\n\n```\nHandle Call → Answer Call → Request: API #1\n → Set Variables: my_data = %{request_response.field}\n → Request: API #2 (overwrites %{request_response}; %{vars.my_data} still readable)\n → Play TTS: \"Result: %{vars.my_data}\"\n```\n\n## Anti-patterns\n\n- Not creating the AI Agent Resource before adding the AI Agent node — the dropdown will be empty.\n- Removing **Handle Call** — it can't be removed. Stop trying.\n- Treating **Answer Call** as mandatory — it's optional; other nodes auto-answer.\n- Using `%{request_response.}` after a second Request node — the second call overwrites the variable. Persist with Set Variables.\n- Wiring a Gather Input **No Input** output back to itself with no counter — infinite loop.\n- Deploying without testing — save first, then Deploy after verification.\n- Pointing **Execute SWML** at a URL that returns HTML — it must return JSON or YAML.\n- Assigning a flow to a number before deploying — the flow won't be selectable until deployed.\n\n## See also\n\n- [SWML overview](/topic/swml-overview)\n- [SWML AI verb](/topic/swml-ai-verb)\n- [SWML connect verb](/topic/swml-connect-verb)\n- [Python Agents SDK](/topic/signalwire-python-agents-sdk)\n","html":"

SignalWire Call Flow Builder

\n

CFB is the drag-and-drop visual editor for voice flows. Lives under the Tools tab in the SignalWire portal. Generates valid SWML under the hood, so any flow built in CFB is equivalent to a hand-written script. Useful when non-technical team members need to edit flows, or when the flow is simple enough that visual debugging beats a code review.

\n

Node taxonomy

\n

Starting node (always present)

\n

| Node | Description |\n|---|---|\n| Handle Call | Entry point for every incoming call. Cannot be deleted. Cannot be duplicated. |

\n

Action nodes

\n

| Node | Description |\n|---|---|\n| Answer Call | Marks the call answered. Optional — most nodes auto-answer when connected after Handle Call. |\n| Hang Up Call | Disconnects. Reason field is for logs only. |\n| Play Audio or TTS | Plays audio URL, ringtone (ring:5:jp), silence (silence:5), or TTS. Supports SSML and variables. |\n| Send SMS | Sends an SMS mid-flow. Fields: To, From, Text. Supports variables. |

\n

Forwarding nodes

\n

| Node | Description |\n|---|---|\n| Forward to Phone | Forwards to phone(s) or SIP endpoint(s). Outputs: Success, No Answer, Busy, Decline, Error. Supports sequential or simultaneous dialing. Enable Whisper runs SWML before connecting. |

\n

Recording nodes

\n

| Node | Description |\n|---|---|\n| Start Call Recording | Background dual-channel recording. Fields: Name, Stereo, Beep, Terminators, Format. Auto-stops on disconnect. |\n| Stop Call Recording | Stops a named recording. URL available as %{record_call_url}. |\n| Voicemail Recording | Async voicemail record. Fields: Stereo, Beep, Terminators, Max Length, Initial/End Silence Timeout, Format. URL via %{record_url}. |

\n

Input nodes

\n

| Node | Description |\n|---|---|\n| AI Agent | Connects the call to a SignalWire AI Agent Resource. Single setting: AI Agent Name (dropdown populated from Resources). Handles NLP, sentiment, SWAIG, multi-turn dialogue. |\n| Gather Input | Collects DTMF and/or speech. Outputs: one connector per input option + Unknown + No Input. %{prompt_value} holds detected speech for the Unknown path. |\n| Request | HTTP GET/POST/PUT/DELETE. Headers and Body configurable. Response in %{request_response_body} or %{request_response.<field>}. Outputs: user-defined conditions + Else + Failure. |

\n

Decision / data nodes

\n

| Node | Description |\n|---|---|\n| Conditions | JavaScript if/else-if logic over %{variable} expressions. JS operators (&&, \\|\\|, ==, .slice()) work. |\n| Execute SWML | Fetches and executes a remote SWML document. Passes Params + Meta. Return values via %{return_value.<field>}. |\n| Set Variables | Creates named variables accessible as %{vars.<key>} for the rest of the flow. |\n| Unset Variables | Clears previously set variables. |

\n

AI Agent node — what it does

\n

Replaces an entire IVR tree with natural-language handling. Setting: AI Agent Name (dropdown from Resources).

\n

Capabilities the connected agent handles:

\n
    \n
  • Natural language processing (free-form speech understanding)
    • \n
  • Sentiment analysis
    • \n
  • SWAIG functions (CRM lookup, SMS, transfers)
    • \n
  • Multi-turn dialogue with context switching
    • \n
\n

Prerequisites — must exist before the node will work:

\n
    \n
  1. Resources → + Add New → AI Agent → Custom AI Agent.
    2. \n
  2. Configure system prompt, persona, SWAIG functions.
    3. \n
  3. Fund the account (AI agents are billed per minute).
    4. \n
  4. The agent name will appear in the AI Agent node dropdown.
    5. \n
\n

Variables reference

\n

All variables use the form %{<variable>}.

\n

Built-in call variables (always available)

\n

| Variable | Description |\n|---|---|\n| %{call.from} | Caller's number |\n| %{call.to} | Number dialed |\n| %{call.direction} | Currently always inbound |\n| %{call.call_id} | Unique call ID |\n| %{call.state} | Current call state |\n| %{call.type} | Call type |

\n

Request node variables

\n

| Variable | Description |\n|---|---|\n| %{request_response_body} | Full response body |\n| %{request_response.<field>} | Specific JSON field |\n| %{vars.request_response.<field>} | String field for conditional expressions |

\n

Recording variables

\n

| Variable | Description |\n|---|---|\n| %{record_call_url} | URL of stopped Call Recording |\n| %{record_url} | URL of Voicemail Recording |

\n

Gather Input variables

\n

| Variable | Description |\n|---|---|\n| %{prompt_value} | Speech detected on the Unknown output path |

\n

Custom (Set Variables node)

\n
    \n
  • Access with %{vars.<key>} or %{<key>}.
    • \n
  • JS expressions work: %{call.from.slice(2,5)} extracts the area code.
    • \n
  • String comparisons in conditions: %{vars.request_response.dayOfWeek == 'Thursday'}.
    • \n
\n

Building a flow

\n
    \n
  1. Dashboard → Tools tab → Call Flow Builder.
    2. \n
  2. Add New → name the flow → Save.
    3. \n
  3. More Options → Edit to open the canvas.
    4. \n
  4. The canvas starts with a single Handle Call node — the entry point.
    5. \n
  5. Drag nodes from the left panel.
    6. \n
  6. Connect them: click-drag from output (right side) to input (left side).
    7. \n
  7. Click a node to open its config panel.
    8. \n
  8. Click Deploy to make the flow live.
    9. \n
  9. Assign the flow to a phone number.
    10. \n
\n

Every node has one input on the left and one or more outputs on the right. Multiple outputs = branching logic.

\n

Assigning a flow to a DID

\n
    \n
  • Phone Numbers in the Dashboard.
    • \n
  • Select the number → edit Call Handler.
    • \n
  • Set handler to Call Flow → select the flow by name.
    • \n
  • Save.
    • \n
\n

Flows can also be assigned to SIP Addresses and Domain Applications the same way.

\n

Versioning

\n
    \n
  • Version History (top-left of CFB) shows all versions with timestamps.
    • \n
  • Each Deploy creates a new version (1.0, 2.0, 3.0…).
    • \n
  • Roll back via Version History → select old version → Restore.
    • \n
  • Save without deploying to test changes safely.
    • \n
\n

CFB vs SWML vs Python SDK

\n

| Situation | Use |\n|---|---|\n| Simple IVR, AI handoff, voicemail, basic branching | CFB |\n| Non-technical team members editing flows | CFB |\n| Visual debugging matters more than code review | CFB |\n| Complex conditionals, loops, dynamic SWML | SWML directly |\n| Git-versioned, programmatically generated flows | SWML directly |\n| Real-time call control, outbound dialing, browser SDK | Python / Node SDK |\n| Hybrid: visual flow + custom logic | CFB + Execute SWML node pointing at hosted SWML |

\n

Common patterns

\n

Basic AI Agent (simplest)

\n
Handle Call → Answer Call → AI Agent: \"My Agent\"\n
\n

IVR with routing

\n
Handle Call → Answer Call → Gather Input (Press 1=Sales, 2=Support)\n  → [Sales]   → Forward to Phone: sales_number\n  → [Support] → Forward to Phone: support_number\n  → [No Input] → Play TTS \"No input received\" → Hang Up\n
\n

AI Agent with recording

\n
Handle Call → Answer Call → Start Call Recording → AI Agent: \"My Agent\"\n
\n

Voicemail with SMS notification

\n
Handle Call → Answer Call → Play TTS \"Leave a message after the beep\"\n  → Voicemail Recording (beep on, terminator=#)\n  → Send SMS: \"New voicemail from %{call.from}: %{record_url}\"\n
\n

Business hours routing (API-based)

\n
Handle Call → Answer Call → Request (GET timeapi.io)\n  → Conditions: %{request_response.hour} >= 9 && %{request_response.hour} < 17\n    → [Open]   → AI Agent or Forward to Phone\n    → [Else]   → Play TTS \"We're closed\" → Voicemail Recording\n
\n

Loop guard on Gather Input

\n
Handle Call → Answer Call → Set Variables: loop_count = 0\n  → Gather Input\n    → [No Input] → Set Variables: loop_count = %{loop_count} + 1\n                 → Conditions: %{loop_count} >= 2\n                   → [True] → Hang Up\n                   → [Else] → back to Gather Input\n
\n

Preserve caller ID on forward

\n
Handle Call → Forward to Phone (From: %{call.from}, To: +15551234567)\n  → [Success] → (connected)\n  → [No Answer / Busy / Decline / Error] → Hang Up\n
\n

Multi-request flow (variable persistence)

\n
Handle Call → Answer Call → Request: API #1\n  → Set Variables: my_data = %{request_response.field}\n  → Request: API #2   (overwrites %{request_response}; %{vars.my_data} still readable)\n  → Play TTS: \"Result: %{vars.my_data}\"\n
\n

Anti-patterns

\n
    \n
  • Not creating the AI Agent Resource before adding the AI Agent node — the dropdown will be empty.
    • \n
  • Removing Handle Call — it can't be removed. Stop trying.
    • \n
  • Treating Answer Call as mandatory — it's optional; other nodes auto-answer.
    • \n
  • Using %{request_response.<field>} after a second Request node — the second call overwrites the variable. Persist with Set Variables.
    • \n
  • Wiring a Gather Input No Input output back to itself with no counter — infinite loop.
    • \n
  • Deploying without testing — save first, then Deploy after verification.
    • \n
  • Pointing Execute SWML at a URL that returns HTML — it must return JSON or YAML.
    • \n
  • Assigning a flow to a number before deploying — the flow won't be selectable until deployed.
    • \n
\n

See also

\n\n"}