The Action Node: Everything Your Bot Can Do

Message nodes talk. Action nodes work. Here are the built-in actions you can add to a flow, and what each one is for.

9 min read·Last updated: 2026-11-19

01What an action node does

A message node talks to the person. An action node does the work behind it: it saves an answer, fetches data from another service, 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, Launch Mini App posts a button, and Launch Broadcast (only inside Operations) sends a broadcast to many people. The rest work quietly in the background.

On the canvas an action node has two outputs: Next and Failure. If an action fails — another service is down, your code hits an error — the flow can carry on down the Failure path instead of stopping dead. The exception is a quick check alone in its node; see "Quick checks" below.

Two action nodes on the FlowCastle canvas, between a welcome message and a confirmation

02Add 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.

The Add palette on the canvas, with Action among the node types

03Several 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".

The action node editor showing three actions listed in the order they run

04Quick checks: one yes/no question, two exits

Some actions ask one yes/no question and change nothing. Put one of them alone in an action node and the node shows its own exits, so you do not need a Condition node after it.

ActionExits
Telegram Check MemberIs a member / NOT a member
Telegram Check Channel BoostBoosted / Not boosted
Gmail Find And Get MessageFound / Not found
TomoAds Fetch sponsored message (manual placement)Ad found / No ad
Check subscriptionHas access / No access
Emoji CaptchaPassed / Failed

Draw one link from each exit. Only let channel members in? One Check Member node: Is a member goes to the content, NOT a member goes to a "please subscribe" message.

If you draw no link from an exit, the run simply ends there.

If the check itself cannot run, for example the bot is not an admin of the channel, the flow never takes the "NOT" exit. It goes to the node's fallback flow, then to the app's fallback flow. If neither is set, the bot tells the person: "Couldn't check right now. Please try again later."

New action nodes start this way. To use several actions in one node, open Additional options and turn on Multiple actions. The exits go back to Next and Failure, and your links stay where they are: the first exit becomes Next, the second becomes Failure. If you add a second action to a quick-check node, the editor asks first (Use multiple actions?). To go back to one action, remove the extra actions first.

Nodes you built before this feature are not changed. They keep Next and Failure.

05The 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.

The Add Action menu showing the built-in action list, a Modules group and Browse more

06Set 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.

The Set Variable action open in the editor, with a variable and a value

07Delay

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.

08External Request, API with fallback, Custom Code and AI Action

External Request asks another service for data over the web. In technical terms it sends an HTTP request to that service's API (the address programs use to talk to it): method, URL, headers, body. The response lands in the action's outputs, ready to drop into a later message. The address must start with http:// or https:// and point to a public server. Private and internal addresses are refused, both in the editor Test and in live bots.

API with fallback does the same with several interchangeable services. It tries them in order until one answers, with retries and caching.

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. For a back-and-forth conversation there is a separate node kind: The AI Chat Agent Node: Answer Questions From Your Knowledge Base.

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 in the background, then resumes. The option is only available when the block contains AI, HTTP request or custom code actions.

09Tags, 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 on Telegram 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. The bot keeps answering until someone from your team writes; turn on Bot goes quiet right away to stop it at the handoff instead (how it works).

10Sequences: 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.

11Set Language

Set Language chooses which language the bot uses with this contact, from the languages your app supports. Multilingual Bots: One Bot, Many Languages shows where it fits.

12Record Event

Record Event marks that the current contact reached a moment that matters: started, filled in the form, asked for a person, paid. It shows up under Analytics → Events, which is how you find out whether the flow you spent an afternoon on actually gets people to the end.

Give events short, stable names, like qualification_completed. Renaming one later splits your history in two. Turn on Only the first time per contact for a moment that happens once, like a first purchase. Leave it off for a moment that can repeat, like asking for a person.

Events also give your leads their stages. On the Leads page, the events people reach in the same order become stages, and you can make one event the win. Not every event has to be a stage: you choose them in Stage setup. See Leads: See Whose Turn It Is With Every Customer.

13Orders

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 — Accept Payments in Telegram: Stars and Card Providers covers it.

Create Shop order, Prepare Shop payment and Confirm Shop payment are for the Shop Mini App checkout. They only work in flows that the Shop Mini App starts, so you can ignore them unless you run a shop.

14Launch 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.

15Only inside Operations

Operations are flows that run on a schedule, without a person in the chat. Two actions appear only there:

  • Launch Broadcast creates and sends a broadcast. A broadcast flow is the message, and its own audience is the starting list. The filter you add here only narrows that list.
  • Operation Guard stops the operation unless a condition holds. Use it as a safety check before anything goes out.

16Installed 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 Insert Row, Update Row and Delete 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 most of these actions are on the way.

17Next up

Most of the actions your bot will eventually need come from modules, so that is the next stop.

Modules: Connect Sheets, AI, Payments and More

Try it in your own bot

Build it on the free plan while the steps are fresh. No card required.

Build Your First Bot Free