Visual Builder Playbook

When to Use Which Node

• send_text: short one-way message.
• ask_* nodes: collect user input in expected format.
• ask_button: up to 3 quick choices.
• ask_list: more options (up to 10) or longer labels.
• condition: split path with true/false/default branches.
• set_variable: compute value for later logic or operations.
• human_handoff: pass control to team.
• end: close flow cleanly.

UI Layout Best Practice

1. Keep happy-path nodes in one straight line (top to bottom).
2. Put branch paths to the right side.
3. Use clear node labels in message text for easier scanning.
4. Merge branches before handoff or end when possible.

Pre-Publish Validation Checklist

• Start node exists and connected.
• No orphan/disconnected nodes.
• Choice nodes have options and mapped branches.
• Condition node has required branch coverage.
• end node has no outgoing edge.

Example Expression for UI Rule

if(gt({{score}}, 80), "priority", "standard")

More expressions:Function reference