Skip to Content
Simulate

Simulate your Flow App

The built-in simulator lets you test your flow interactively before publishing. You play the role of a user — type responses and watch the engine traverse your nodes in real time.

Simulation runs against the Draft version of your flow. You don’t need to publish to simulate.


Opening the Simulator

With a project open in the canvas, click the Simulate button in the top toolbar. A simulator panel opens alongside the canvas.


How it works

Start a session

Click Start or send an empty message. The simulator calls the Flow Engine’s simulator endpoint and begins a new session at the Start Node.

Read the response

The engine returns the content of the current node — the same text a real user would see on their device.

Type a reply

Enter a response in the input field and press Send. The engine processes your input, evaluates any branching conditions, and advances to the next node.

Trace the path

The canvas highlights the active node as you step through the flow, so you can see exactly which branch was taken.

Reach an End Node

When the engine hits an End Node, the session closes. Click Restart to run through the flow again from the beginning.


Pagination testing

If a node’s content is long enough to trigger pagination, the simulator shows it page-by-page using the characters you configured in your Access Point (default # for next, 0 for previous). Type those characters as your input to navigate between pages.


Common issues to test

  • Dead ends — nodes with no outgoing edge that are not End Nodes
  • Unmatched input — user types something that doesn’t match any response option
  • Empty responses — nodes with blank content
  • Long content — verify pagination works correctly for USSD
  • Variable resolution — confirm {{session.input}} and other variables resolve correctly
  • API call failures — if an API Call node’s endpoint is unreachable, check the fallback behaviour

AI Flow Creator

The builder includes an AI Creator that can generate a draft flow from a natural language description. Use it to bootstrap a new flow quickly, then refine with the visual editor and simulator.

Last updated on