Node Types
Complete reference for all node types in StarHash.
Node Types
StarHash provides six node types to build any USSD flow.
Configuration
| Field | Description |
|---|---|
| Title | Text displayed above options |
| Options | Menu options (label + where it goes) |
| Footer | Optional text below options (e.g., "0. Back") |
What Users See
Welcome! Select an option:
1. Check Balance
2. Send Money
3. Buy Airtime
4. Help
0. Back
Tips
- Keep options to 5-7 items max for readability
- Use "0" for back/cancel actions
- Keep labels short (USSD has 182 char limit)
Configuration
| Field | Description |
|---|---|
| Prompt | The question or instruction |
| Variable Name | Where to store the response |
| Validation | Optional rules (number, phone, etc.) |
| Next Node | Where to go after input |
Validation Types
| Type | Description |
|---|---|
| Text | Free text with optional min/max length |
| Number | Numeric input with optional min/max value |
| Phone | Phone number format |
| PIN | PIN code (for secure input) |
Configuration
| Field | Description |
|---|---|
| Message | Text to display (can include variables) |
| Next Node | Where to go next (automatic) |
Configuration
| Field | Description |
|---|---|
| Conditions | List of if/then rules |
| Default | Where to go if no conditions match |
Example Setup
| Condition | Then go to |
|---|---|
| balance >= amount | "Sufficient Funds" node |
| balance > 0 | "Insufficient Funds" node |
| (default) | "Zero Balance" node |
Condition Operators
| Operator | Description | Example |
|---|---|---|
== | Equals | status == "active" |
!= | Not equals | type != "guest" |
> | Greater than | balance > 100 |
>= | Greater or equal | age >= 18 |
< | Less than | attempts < 3 |
<= | Less or equal | count <= 5 |
&& | And | age >= 18 && verified == true |
|| | Or | role == "admin" || role == "manager" |
Configuration
| Field | Description |
|---|---|
| Action Type | What to do (HTTP, SMS, Set Variable) |
| Configuration | Settings for the action |
| Result Variable | Where to store the result |
| Success Node | Where to go on success |
| Error Node | Where to go on failure |
Action Types
Make an API call to your backend:
| Setting | Example |
|---|---|
| URL | https://api.example.com/balance/${phone} |
| Method | GET, POST, PUT, DELETE |
| Headers | Authorization tokens, etc. |
| Body | JSON data to send |
Tips
- Always provide a clear final message
- Include transaction references when applicable
- Keep within the 182 character limit