Customers & CRM
Intake Flows
Custom forms that guide new jobs from first contact through scheduling.
6 min readIntake Flows
Build checklist-style flows that guide staff from first contact through customer creation, job setup, and scheduling.
Overview
Intake Flows live under Settings → Intake Flows (
/settings/intake-flows). Staff run flows at /intake during live intake calls or counter visits. Each flow is a ordered set of steps; progress is saved so incomplete intakes can be resumed.How to access
| Area | Menu path | Route |
|---|---|---|
| Manage flows | Settings → Intake Flows | /settings/intake-flows |
| Create flow | New Flow on settings page | /settings/intake-flows/new |
| Edit flow | Row action | /settings/intake-flows/:id |
| Run flow | Start on a flow or resume instance | /intake?flowId=… or /intake?instanceId=… |
Admin access to Settings is required to build flows. Running intake requires appropriate staff permissions.
What you can do today
- Create, edit, and delete intake flow definitions.
- Mark one flow as the default.
- Start a new instance from Settings or navigate to
/intake?flowId={id}. - Resume in-progress instances from the Active Instances tab or
/intake?instanceId={id}. - Complete steps in a modal; link created customers and jobs when steps require them.
- Complete or Abandon instances from Settings or the runtime page.
- On completion, navigate automatically to the created job or customer when applicable.
Prerequisites
- Admin role for flow builder access.
- At least one published intake flow before staff can run intake.
- Customer and job permissions for steps that create those records.
Step-by-step
Create an intake flow
- Go to Settings → Intake Flows.
- Click New Flow →
/settings/intake-flows/new. - Name the flow and add steps (customer lookup/create, job details, scheduling, etc.).
- Save and optionally Set as Default.
Run intake with a customer on the phone
- From Settings → Intake Flows, click Start on the desired flow
— or open/intake?flowId={flowId}. - ServiceFlow creates an instance and updates the URL to
?instanceId=…. - Click each step in the checklist; complete the modal fields.
- When all required steps are done, click Complete Intake.
- You are sent to the new job (
/jobs/:id) or customer (/customers/:id) when the flow creates one.
Resume an interrupted intake
- Go to Settings → Intake Flows → Active Instances tab.
- Click Resume on the in-progress row
— or open/intake?instanceId={instanceId}. - Finish remaining steps and complete or abandon.
Delete a flow
- On the flows list, choose Delete.
- If active instances exist, review the warning; complete or abandon instances first when possible.
Current limitations
- Flow builder step types depend on what your admin configured; not every step auto-creates both customer and job.
- Instance management UI shows all instance statuses for troubleshooting; primary staff workflow focuses on in_progress items.
- Intake is staff-facing in the main web app, not a public customer self-service URL.
Related features
- Customer Management — records created during intake
- Jobs List & Detail — jobs created at flow completion
- Customer Forms — customer-facing forms (portal) vs staff intake