Sparki Docs

Workflow

Build questions, conditions, endings, and customer results.

Configuration

Workflows are guided question flows that send customers to the right next step.

Use them for qualification, offer flows, pre-validation before appointments, document intake, and routing customers to the right action.

Build the Flow

Open Workflows in the dashboard. A workflow starts with a name, description, active state, and translation text. Inside the builder, a workflow is made from steps and elements.

Questions

Text, long text, number, select, date, time, file upload, and checkbox elements collect customer answers.

Conditions

Rules decide whether later fields, steps, or endings apply based on earlier answers.

Endings

Send customers to a message, portal content, appointment, request, URL, bid flow, or another next step.

The same flexible question system is used for workflows, bidding, and pre-validation. The available question list is the same in all three places. File upload is the exception: it only appears when document uploads are enabled for the portal. Add translations for the languages your customers use before publishing a public flow.

Question and Content Types

Use questions to collect customer input and content blocks to explain what the customer should do next.

Workflow question and content types

The same question and content list is used for normal workflows, bidding questions, and pre-validation questions.

Questions that collect answers:

  1. Text for short one-line answers.
  2. Long text for explanations, notes, or motivation.
  3. Number for budgets, income, household size, or thresholds.
  4. Select for controlled choices that can drive conditions and endings.
  5. Date for a calendar date.
  6. Date & time for a specific moment.
  7. Time for time-only preferences.
  8. Checkbox for confirmations, consent, or yes/no acknowledgements.
  9. File upload for documents, only when document uploads are enabled in the portal settings.

Content blocks that do not collect answers:

  1. Explanation for extra instructions.
  2. Warning for important constraints or notices.

Forms can include required questions, optional questions, conditional follow-up questions, document uploads, and fallback endings. This makes workflows useful for intake, qualification, document collection, bidding preparation, and administrative processes.

Conditional Logic

Conditions can check whether an answer equals a value, does not equal a value, contains a value, is greater than or less than a number, is empty, or is not empty. Several conditions can be combined as all conditions must match or at least one condition must match.

Endings and Navigation

Endings decide what happens after a customer submits the answers. Depending on the workflow type and project setup, an ending can send the customer to an appointment, appointment request, bid flow, question form, external URL, or end page message. Fallback endings are useful when no other rule matches.

Workflow and bidding standard endings

Normal workflows and bidding question flows can use these standard endings:

  1. Redirect to an external URL sends the customer outside Sparki.
  2. Show an end page shows a custom title, message, and button label.
  3. Make an appointment sends the customer to booking for a selected project.
  4. Request an appointment creates an appointment request for team follow-up.
  5. Make a bid sends the customer to an open bidding flow for a selected project.
  6. Ask a question opens a project question flow.

Appointment, appointment request, bid, and question endings need a selected project. Bid endings only show projects with open bidding.

Use endings to filter visitors, route customers to the right next step, or stop a customer from continuing when the answers do not meet your requirements.

Where Workflows Are Used

Workflows can be published as portal content. They can also be connected to projects, bidding flows, or pre-validation before customers reach appointment booking.

When a customer completes a workflow, Sparki stores the answers and matching ending as an Answer interaction. Review those results from Inbox or the customer timeline.

Workflow results, bidding data, and pre-validation answers are linked to the related appointment or interaction flow when they are part of that flow. This keeps the submitted answers close to the action the customer was trying to complete.

Pre-Validation Before Viewings

Use pre-validation when a customer should answer qualifying questions before booking a viewing or open-house appointment. The project still owns the appointment agenda, but the customer must complete the workflow first.

Pre-validation workflow builder

A pre-validation workflow combines the questions customers answer with endings that decide whether they can book, should send a request, or should stop.

To set this up, create the project and connect its agenda first. Then open the project settings, enable Pre-validation, add the questions, and configure the endings.

Project pre-validation settings

Project settings are where the pre-validation flow is attached to the viewing project.

Pre-validation uses the same question and content types as other workflows. Use questions such as selected qualification status, household size, budget, preferred date, uploaded documents, or a confirmation checkbox. File upload is available only when document uploads are enabled for the portal.

Pre-validation endings

Pre-validation endings are more limited because pre-validation sits directly before appointment booking:

  1. Only make an appointment lets qualified customers continue to normal booking.
  2. Only sign up for the wait list creates an appointment request instead of direct booking.
  3. Not allowed to continue shows a message and blocks the customer from booking.
  4. Continue the flow is the fallback when no rule matches, allowing the customer to continue with booking or viewing request flow.

On the customer side, Sparki adds the pre-validation questions to the booking flow before the appointment can be submitted. Only a matching appointment ending lets the customer finish the normal booking step.

Customer pre-validation form

Customers complete the pre-validation questions before they can confirm the appointment.

You can copy bidding questions or pre-validation questions from another project when a similar project already has the right setup. After copying, save the project so Sparki creates its own workflow for that project.

Plan and Role Notes

Workflows are available on Pro and Custom portals. Members need Edit workflows to create or change workflows.

On this page