Node reference
A workflow is a chain of nodes, which the console calls steps. Every run starts at a trigger, and the steps after it change the flow, wait, keep a value, do something or stop. Here are all 24, in the same groups and colours as the console's palette. Open one for its settings, what it adds to the run and an example.
Starts the workflow
5 nodesTriggers. A workflow has exactly one, and what it hands on is the run's input.
Starts when a client sends a message of a type you pick, optionally only when its values match, or have matched for a while.
Outdefaulttrigger:clientStarts when a client comes online or goes offline. Holds back while a client is installing a firmware update.
Outdefaulttrigger:clientPresenceStarts every few minutes, daily at a time, or on a cron expression. Times are UTC.
Outdefaulttrigger:scheduleStarts when something outside WBSKT posts to the workflow's own URL. The body becomes the run's input.
Outdefaulttrigger:webhookStarts from the Run button in the console or from the API, with inputs you define.
Outdefaulttrigger:manualFlow
6 nodesDecide where the run goes next: one way or another, once per item, down several paths at once, or into another workflow.
Checks a condition, or several joined with and or or, and leaves by true or false.
Outtruefalsecontrol:logicRuns the body once per item of a list, one after another, then leaves by done.
Outbodydonecontrol:foreachRuns the body for every item at once. An empty list leaves by empty.
Outbodyemptycontrol:parallelForEachSplits the run into named paths that carry on side by side.
Outone per path you namecontrol:forkWaits for paths to arrive: all of them, the first one, or a number you set.
Outdefaultcontrol:joinStarts another workflow as a child run, with its own credits, and passes the result back.
Outdefaultcontrol:subWorkflowWaits
3 nodesPark the run on the server until a time passes or something calls back, for minutes or days.
Pauses the run for a fixed time. Waiting costs nothing.
Outdefaultcontrol:delayParks the run on a one-off callback URL until something calls it, or the time runs out.
Outdefaulttimeoutcontrol:waitForHttpParks the run until a named signal arrives from the console, the API or another run.
Outdefaultwith Give up aftertimeoutcontrol:awaitSignalData
1 nodeKeep a value for later steps of this run, or for every run of the workflow.
Does something
7 nodesCommand a board, notify someone or call a URL.
Sends a command to a client. Can wait for the client to confirm and leave by what happened.
Outdefaultor, when waitingackedfailedtimeoutaction:clientMessageSends an email through an SMTP integration, with values from the run in the subject and body.
Outdefaultaction:emailSends a message to a Telegram chat through your bot.
Outdefaultaction:telegramCalls any HTTP endpoint, with an HTTP auth integration if it needs one. Errors leave by error.
Outdefaulterroraction:webhookPops a notice in the console for everyone watching the workspace.
Outdefaultaction:toastPosts to a Discord channel, as plain text or an embed.
Outdefaultaction:discordPushes a notification to your phone through an ntfy topic, with priority and tags.
Outdefaultaction:ntfyStops
2 nodesEnd a path on purpose, as a success or a failure.
Ports
A port is where a run leaves a node. Most nodes have one output, default, drawn as a single dot on the card's edge. Nodes with more than one outcome list them, and a run that reaches a port with nothing connected ends there as done. The canvas shows some ports by a friendlier name, given first below; the workflow definition and the API use the id.
| Port | Leaves when |
|---|---|
yes / no true / false | The If node's conditions held, or didn't. |
each item body, done, empty | Once per item; after the last item; when the list had none. |
called, received default | The call or signal a Wait for a call or Wait for signal step was waiting for arrived. |
timed out timeout | A wait ran out before the callback, signal or acknowledgement arrived. |
acked / failed | The client confirmed the command, or refused it (for example because it had expired). |
error | The URL answered with an error after its retries. |