Docs

RunMacro Documentation

Learn RunMacro from basics to advanced.

Everything you need to start and master RunMacro — from basic commands to advanced automation workflows.

Ctrl K

📨 Debug

Send a Telegram notification from a RunMacro workflow

Telegram Notification sends a bot message when the run hits this step, then continues, pauses, stops, or jumps to a label. Telegram must be configured in Settings.

Prerequisites

Telegram enabled in Settings (bot token + chat id).
Internet access.

Supported modes

Desktop Mode — Runs in both Desktop and Browser modes.
Browser Mode

What it does

The Telegram Notification command sends a message via your Telegram bot when the workflow reaches this step. The message includes machine, macro name, row, and time, plus the content you enter (variables allowed). After sending, it performs an action: continue, pause, stop, or go to a label.

When to use it

Notify when a workflow finishes or hits a milestone.
Alert on a state that needs attention, then pause/stop.
Monitor a long run remotely.

When not to use it

You only need a local message — use Show Message.
You do not want to use an external service.

Configuration steps

Open Settings › Telegram and enable notifications (enter bot token + chat id).
Add a Debug › Telegram Notification command.
Enter the message (variables allowed).
Choose the action after sending: continue, pause, stop, or go to label.
For go-to-label, enter the target label. (Optional) enable a blocking popup. Save.

Every option explained

Message

The text to send. Insert variables with {name}.

Action

continue, pause, stop, or goto (jump to a label).

Target label

The label to jump to when the action is goto.

Blocking popup

If on, shows a popup and waits before continuing.

Expected result

A Telegram message is sent (if enabled), then the workflow performs the chosen action.

Real example

Example: notify done, then stop

Telegram Notification: message "Processed {count} items", action = stop.

Limitations and failure cases

Depends on Telegram and the network.
Skipped during test runs.

Tips & common mistakes

Per Play, it sends one message per step (no repeats within the same run). Configure Telegram in Settings first.

If Telegram is disabled/unset, it skips sending and logs a note; the bot token is always redacted from logs.

Verification details

commands/telegram.py