Guide
- 1
What an action node does
A message node talks to the person. An action node does the work behind it: it saves an answer, calls an API, tags the contact, waits, or starts a follow-up. Most of the time nothing appears in the chat at all — the flow simply moves on to the next node.
A few actions do send something, and it is worth knowing which. Notify by Tag messages other people, Service Notification pings your team, Emoji Captcha posts a challenge to the user, and Launch Mini App posts a button. Everything else is silent.
On the canvas an action node has two outputs: Next and Failure. If an action fails — an API is down, a script throws — the flow can carry on down the Failure path instead of stopping dead.
- 2
Add one from the canvas
Click the round + button in the bottom-right corner of the canvas. The Add palette opens with every node kind you can create — pick Action.
You can also drag a connection out of an existing node and drop it on empty canvas. The same palette opens, and the node you choose arrives already connected.
- 3
Several actions in one node, top to bottom
Click the node to open its editor. Give it a Node Name you will recognise on the canvas, then fill it using + Add Action. The panel header counts what is inside — Actions (3) below.
Actions run in the order they are listed, one after another. The pencil opens an action for editing, the bin removes it. Keep one job per node: "Save the answer" and "Tag and notify" read far better on a canvas than one node called "Stuff".
- 4
The action menu
+ Add Action opens the catalog. Create New is the built-in list below. Modules groups the actions that came with the modules installed in this bot. Saved Actions appears once you have saved an action for reuse. The search box at the top filters all three at once.
- 5
Set Variable and Read variables
Set Variable writes a value into a variable: a fixed value, text with
{{variable}}placeholders dropped in from the variable picker, or the output of an earlier action. For number variables the editor adds an Operation field, so you can increase or decrease a counter instead of overwriting it.Read variables goes the other way. It loads variables into the node's outputs so later nodes can use them, and it can read another contact's variables, not only the current one's.
- 6
Delay
Delay pauses the flow, either for a relative amount of time (seconds, minutes, hours) or until a specific date and time. A short delay between two messages makes a bot feel less like a wall of text.
For anything longer than a few minutes, a sequence is the better tool — see below.
- 7
External Request, Custom Code and AI Action
External Request sends an HTTP request to any API: method, URL, headers, body. The response lands in the action's outputs, ready to drop into a later message.
Custom Code runs your own TypeScript when a plain request is not enough. AI Action runs a single prompt and stores the raw result — one call, not a conversation.
These three can be slow. Open Additional Options on the node and turn on Run this Action block in background: the flow pauses before the block, does the slow work asynchronously, then resumes. The option is only available when the block contains AI, HTTP request or custom code actions.
- 8
Tags, notifications and live chat
Add Tag and Remove Tag label the current contact. Tags are how you segment people for broadcasts and conditions later.
Notify by Tag sends a message to every contact carrying a tag — the usual way to alert your admins. Service Notification notifies your team through the service bot and by email, and works from any channel. Start Conversation hands the chat to a human: it opens a live chat conversation and assigns it to a team or an agent.
- 9
Sequences: subscribe and unsubscribe
Subscribe to Sequence enrolls the contact in a timed reminder sequence. The steps run in the background, so the flow continues immediately instead of waiting.
Unsubscribe from Sequence takes the contact out and cancels the remaining steps. Put it on the path where the person did the thing you were reminding them about — otherwise they keep getting nudged.
- 10
Set Analytics Goal
Set Analytics Goal records a goal event for the current contact. It shows up under Analytics → Goals, which is how you find out whether the flow you spent an afternoon on actually gets people to the end.
Give goals short, stable keys. Renaming one later splits your history in two.
- 11
Orders
Create Order creates an order for the current contact with an amount and a currency. Update Order changes the status of an existing one, and Remove Order deletes one by id.
These are the bookkeeping half of a checkout: they record what was ordered. Taking the money is a Payment node, which is a separate node kind in the Add palette.
- 12
Launch Mini App and Emoji Captcha
Launch Mini App posts a button that opens a Telegram Mini App, so you can hand a task to a web page and come back with the result.
Emoji Captcha posts a "press the right emoji" grid and only lets verified people through. It is the standard way to keep automated spam out of a group.
- 13
Installed modules add their own actions
Everything above is built in. Installing a module adds its own actions to the same menu, listed under Modules and grouped by module — Google Sheets brings Add Row and Find Row, and so on. They behave like any other action inside the node.
Browse more at the bottom of the menu opens the module marketplace without leaving the editor. Modules: Connect Sheets, AI, Payments and More covers installing and setting them up.
This page is a map, not a manual. Dedicated guides for variables, HTTP requests, custom code, AI, sequences, tags, goals and captcha are on the way.
- 14
Next up
Most of the actions your bot will eventually need come from modules, so that is the next stop.