BuildBetter Docs

Creating Workflows

Use Create Composable to build a v2 workflow from a blank graph or from a prebuilt graph template. Use Create from Template only when you specifically need the older legacy workflow templates.

Create a Composable Workflow

1. Open Workflows

Navigate to Workflows in the main menu.

2. Choose Create Composable

Pick a blank workflow or select a v2 template from the template picker.

3. Add a Trigger

Drag one trigger onto the canvas: Call Completed, Signals Extracted, Signal Created, Feedback Created, Manual Trigger, or Schedule.

4. Add Data and Logic

Add blocks that fetch context, filter results, ask an LLM, branch, or format output.

5. Add an Action

End with a side effect such as Send Webhook, Send to Slack, Send Email, Add to Folder, or Add Tag.

6. Test, Save, Enable

Run a test, inspect Run History, save the graph, then switch Enabled on when it is ready.

Starting From a v2 Template

V2 templates seed the graph with working nodes and edges. Current templates include:

After selecting a template, BuildBetter creates a disabled draft and redirects you to /workflows/v2/:id. Edit the graph, point actions at the right destination, test it, then enable it.

Building by Hand

1. Pick the Right Trigger

Trigger Use When
Call Completed You need call metadata, transcript, summary, participants, or call-scoped signals.
Signals Extracted You want one digest-style run for a batch of newly extracted signals.
Signal Created You want one run per individual signal.
Feedback Created You want to react when new feedback is added from a selected feedback source.
Manual Trigger You want an on-demand workflow.
Schedule You want hourly, daily, weekly, or custom cron-based automation.

2. Connect Blocks

Drag from one block to another to create edges. The editor prevents invalid graph structure:

3. Configure Inputs

Config fields can be filled three ways:

Input Type Example Use It For
Literal https://example.com/webhook Hardcoded values like URLs, channel selections, limits, or labels.
Reference trigger.callId Passing one upstream field directly into a block.
Template Call {{get_call.title}} ended with {{get_summary.summary}} Combining text with multiple upstream fields.

The variable picker lists valid upstream outputs, so you do not need to memorize field paths.

4. Use Specialized Inputs

Some blocks expose richer controls:

Email and Attachment Actions

The Send Email action can notify one or more active organization members. Workflow emails render Markdown as styled HTML and can include attachments for rendered signals, signal lists, calls, or recordings.

Recipients are checked again at send time, so disabled or removed members do not receive workflow email.

Signed Webhooks

Webhook actions can include BuildBetter signature headers. Configure the signing secret in the webhook step, then use the verification guide in the editor to validate signatures in your receiving service.

5. Test Safely

Click Test before enabling the workflow. Test runs are stored as normal run records with a test badge, and the drawer highlights per-node output and errors.

Warning: Test runs execute real actions. A test webhook posts to the URL you configure, and a test Slack action posts to the selected channel.

Managing Workflows

From the Workflows list you can:

Inside the v2 editor you can:

Migrating a Legacy Pattern

Legacy Pattern v2 Starting Point
Transcript to Webhook Send Transcript to Webhook template
Send Call to Webhook Send Full Call Data to Webhook template
Recording Summary to Webhook Conditional Summary to Webhook or blank Call Completed graph
Answer Questions to Webhook Ask LLM About Call template
Recording to Folder Organize Calls into Folder template
Recording to Folder by Title Folder by Title Match template
Recording to Tag Apply Tag Conditionally template
Signal to Webhook Blank graph with Signals Extracted or Signal Created trigger
Feedback to Slack Feedback Created trigger with the Feedback to Slack template
Email a summary Trigger plus Send Email action

Tip: For a first workflow, use a template and change only the destination. Once the test run succeeds, add filtering or formatting one block at a time.