Telegram Notification Node

The Telegram Notification node sends messages to Telegram users, groups, and channels through a bot you create. Use it to get instant trading alerts, execution summaries, and portfolio updates delivered straight to your phone.

Configuration

Bot Setup

Before you can send messages, you need a Telegram bot and a chat ID. Follow these steps:

Step 1: Create a Bot

1. Open Telegram and search for @BotFather (or tap this link ↗).
2. Send the /newbot command.
3. Choose a display name for your bot (e.g., "My Trading Alerts").
4. Choose a username ending in bot (e.g., my_trading_alerts_bot).
5. BotFather will reply with your bot token -- it looks like 123456789:ABCdefGHIjklMNOpqrsTUVwxyz-1234567890. Copy it.

Step 2: Save the Token in NickAI

1. Go to Credentials in NickAI.
2. Click Add Credential and select Telegram.
3. Paste your bot token and give the credential a name (e.g., "My Trading Bot").
4. Click Save. The token is encrypted at rest.

Step 3: Get Your Chat ID

You need the numeric chat ID for the recipient. Here is how to find it:

For your personal account:

1. Open Telegram and search for @userinfobot.
2. Send it any message -- it will reply with your user ID (a number like 123456789).

For a group:

1. Add your bot to the group.
2. Send a message in the group.
3. Open https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates in a browser.
4. Find the "chat" object -- the "id" field is your group chat ID (it starts with -100).

For a channel:

1. Add your bot as an admin of the channel.
2. Use the channel's @username as the chat ID (e.g., @mychannel), or use the numeric ID from the getUpdates method above.

Step 4: Start a Conversation with Your Bot

1. Search for your bot by its username in Telegram.
2. Tap Start or send any message (e.g., /start).
3. Your bot can now send you messages.

Template Interpolation

Use double curly braces to inject live data from upstream nodes into your message text and chat ID fields.

Trading Alert Example

*BTC/USD Alert*

Price: ${{price_data.data.prices[0].current}}
24h Change: {{price_data.data.prices[0].changePercent24h}}%
RSI: {{price_data.data.prices[0].indicators.rsi}}

Signal: {{llm.output}}

Order Confirmation Example

*Order Executed*

Action: {{exchange.side}}
Symbol: {{exchange.symbol}}
Quantity: {{exchange.quantity}}
Price: ${{exchange.price}}
Status: {{exchange.status}}

Portfolio Summary Example

*Daily Portfolio Update*

Total Value: ${{portfolio.netWorth}}
Cash: ${{portfolio.cashBalance}}
Positions: {{portfolio.positionCount}}

Top Holding: {{portfolio.positions[0].symbol}} ({{portfolio.positions[0].percentage}}%)

Workflow Example

A common pattern is to run analysis, check a condition, and send a Telegram alert when something noteworthy happens:

In this workflow:

1. Price Data fetches live BTC/USD market data.
2. LLM analyzes the price, volume, and indicators to produce a signal with a confidence score.
3. Conditional checks if confidence exceeds 80%.
4. Telegram Notification sends the alert to your phone -- only when the signal is strong.

You can also place Telegram at the end of both branches to send different messages for true and false conditions:

Output

After execution, the node produces the following data that downstream nodes can reference:

Parse Mode Reference

Telegram supports three formatting modes. Choose the one that fits your message style:

Next Steps

• Email Notification Node -- Send alerts via email as a backup channel.
• Discord Notification Node -- Post alerts to Discord servers.
• Slack Notification Node -- Send alerts to Slack channels.
• Conditional Node -- Route workflows based on conditions before sending notifications.
• Credentials -- Manage your Telegram bot token and other API keys.