Skip to main content

Flow Builder

Flow Builder connects the questions, choices, calculations and actions behind a service, rental, event or Stint. Use it to make the path understandable before asking customers or staff to follow it.

Build a customer journey​

Open Flows → New Flow, choose a type, then select a template or Blank Flow. Service templates include Quote & Pay; rental templates provide steps appropriate to their rental kind. A template is an editable starting graph, not a completed offer.

  1. Open Flow Details to give the draft a meaningful name and description.
  2. Connect the page to the intended service, rental, event or Stint.
  3. Configure each collector, resource, price and endpoint.
  4. Follow the connections from the user entry to the outcome.
  5. Inspect Suggestions, Warnings, and Errors, then run Preview with realistic answers.
  6. Save the draft and review the final publishing action separately.

The reviewed local flow is Water heater replacement estimate. It uses a published plumbing intake form, a service-level choice, a fixed-price calculation, scheduling, Quote, Checkout and a Service endpoint. It remains an unpublished flow with its service page unconnected.

Read the connections​

The blue user path determines the order of steps. Pricing and item handles pass values into nodes such as Quote and Checkout. A visually connected user path alone does not prove the downstream money data is correct.

The example sends the user through:

Service Page → Job Details → Service Level → Price → Pick a Time → Quote → Checkout → Service

A separate payment connection feeds the calculator into Quote. Add a node, configure it, and connect it into the path; an unconnected card is only a draft component.

Choose the appropriate elements​

Palette groupPurpose
InformerPresent a page or useful context
CollectorGather forms, service levels, dates, agreements and other choices
ExtractorRead values for later steps
ManipulatorCalculate or transform values
State / Connection / Stream / DefaultBuild the remaining logic, state and outcome path
PresetAdd provider-pool staffing and dispatch behavior where appropriate

Use Zoom In, Zoom Out, Fit View, and Toggle Interactivity to navigate the canvas. Give related cards enough space to edit; the reviewed version initially placed a newly added rental variant card over another card. Moving the card made the configuration accessible.

Save and publish deliberately​

Local flow edits were restored after full reload, including calculator settings, the selected form and deposit percentage. Saving a draft does not publish its linked offer. In service/rental creation, however, Next saves a cloud flow before returning to the creator. Preset publication also freezes an immutable version. Read the screen and context before continuing.

Quote logic​

Build an itemised explanation of the price before the customer reaches checkout. The Calculator offers Fixed Rate, Hourly Rate, Area Rate, Expression, Distance Rate, Tier Based, Function Rate, and AI Suggestion. Each needs the relevant inputs and configuration; selecting a calculation type is not enough.

For the reviewed estimate, Fixed Rate = 1800. The money-settings control sets CAD, two decimal places, half-up rounding and an illustrative 13% tax. The sample breakdown is $1,800 + $234 = $2,034 CAD.

Calculator Money settings in CAD with 13 percent tax and an itemised estimated total of 2034 dollars
Review the currency, adjustments and calculation order, then save the settings. The tax rate shown is an example configuration.
Calculator Money settings in CAD with 13 percent tax and an itemised estimated total of 2034 dollars

Review the currency, adjustments and calculation order, then save the settings. The tax rate shown is an example configuration.

The calculation order is base → discount → service fee → tax → suggested tip → minimum charge. Review rounding and the chosen behavior for missing values and division by zero. A minimum charge can raise the final amount above the ordinary calculated result.

Configure what approval does​

The Quote card offers two independent actions under When the customer approves:

  • Books the job moves the approved order to Active.
  • Sends the invoice right away prepares the invoice for immediate payment; switching it off leaves invoicing for later.
Quote card with Books the job and Sends the invoice right away enabled
Approval behavior is configured here. This canvas preview shows the $1,800 base line; the customer Preview below includes the tax adjustment.
Quote card with Books the job and Sends the invoice right away enabled

Approval behavior is configured here. This canvas preview shows the $1,800 base line; the customer Preview below includes the tax adjustment.

These settings govern what happens after an actual customer approval. Clicking forward in Preview is not proof that a customer received or accepted a quote. See Quotes and approvals for the business workflow.

Verify the runtime total​

Customer Quote preview showing a total of 2034 CAD with separate fixed-rate and tax inputs
The actual customer Preview showed $1,800 plus $234 tax, totaling $2,034 CAD. No quote was sent.
Customer Quote preview showing a total of 2034 CAD with separate fixed-rate and tax inputs

The actual customer Preview showed $1,800 plus $234 tax, totaling $2,034 CAD. No quote was sent.

The runtime calculation uses the answers and choices made on that run. It can differ from a design-time sample or the base lines shown on a canvas card. In this walkthrough, the Quote card initially stayed at zero after the calculator changed; reloading showed its $1,800 base line. The actual Preview correctly carried the $234 tax and $2,034 total. Check that customer-facing result before relying on a canvas number.

Everything calculated in the browser is an estimate. It is not a receipt, a successful payment, or proof of the server-verified amount that a live order will use. AI Suggestion is an estimate workflow requiring business review; the walkthrough did not run an AI pricing request.

Preview the customer path​

Select the play control to open Flow Preview. Restart it after fixing missing resources, and use the expand control or resize the preview window when inspecting a longer step.

The walkthrough first reported No form ID specified in node configuration. Selecting the existing published Plumbing request · service intake form and restarting resolved that error. The run then accepted a demonstration issue description and a public example address, a Standard service level, the fixed estimate, and an October 26 scheduling choice. Quote displayed $2,034 CAD, then Checkout displayed the configured deposit split.

Checkout Preview with the 2034-dollar total split into 508 dollars and 50 cents now and 1525 dollars and 50 cents later
Preview reached Checkout and was closed before its final Next action. This verified the display without submitting an order or payment.
Checkout Preview with the 2034-dollar total split into 508 dollars and 50 cents now and 1525 dollars and 50 cents later

Preview reached Checkout and was closed before its final Next action. This verified the display without submitting an order or payment.

Test required fields, each meaningful branch, unavailable dates, missing price inputs and payment readiness. All checks passed describes graph validation; it does not guarantee that every resource, public listing or external integration is ready. The example's unconnected service page still needs review before live use.

Preset previews require particular care: provider-pool rehearsals can create real work orders. Review Preset services before starting one. No preset dispatch or work-order creation was performed here.

Troubleshoot a flow​

SymptomWhat to check
A step never runsUser-path connections, branching conditions and skipped/off settings
Preview fails at a formThe selected published form and its current fields
A quote has zero or missing amountsCalculator inputs, payment/item connections, result variables and actual runtime choices
A canvas amount stays staleReload the saved draft and compare the actual customer Preview
A page says no offering is connectedBind it to the intended service, rental, event or Stint
Customers cannot pay by cardThe business's verified payment connection and allowed methods, not just the graph's status

Continue with Services, Rentals, Checkout, and the booking-workflow tutorial.