Telegram: Send Message

ActionStable

Send messages to Telegram users, groups, or channels from your workflows.

Prerequisites:

A Telegram bot token - Get one here
The Chat ID of the recipient (user, group, or channel)

Overview

The Telegram node lets you send text messages through your Telegram bot. You can send messages to:

Individual users (private chats)
Groups (where your bot is a member)
Channels (where your bot is an admin)

This is perfect for notifications, alerts, reports, or building interactive bots.

Configuration

The Telegram node requires three fields to work:

1. Credential

Type: Telegram Credential (required)

Select a Telegram bot credential that you've set up in Buzz8n. If you haven't created one yet, follow this guide.

2. Chat ID

Type: String or Number (required)

The unique identifier for the chat where you want to send the message. This can be:

User ID: A positive number (e.g., 123456789)
Group ID: A negative number (e.g., -987654321)
Channel username: Starting with @ (e.g., @mychannel)

How to find Chat ID

Send a message to your bot
Visit: https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates
Find the "id" under "chat"

3. Message

Type: String (required)

The text message to send. Supports Telegram's text formatting:

Bold: *text* or **text**
Italic: _text_
Code: `text`
Links: [text](url)

Example Messages

Simple Text Message

Hello from Buzz8n! Your workflow is working. 🎉

Formatted Message

*Workflow Alert*

Your workflow has completed successfully!

Status: _Running_
Duration: 2.5s
Time: `2025-01-15 10:30:00`

[View Dashboard](https://your-domain.com/dashboard)

Using Dynamic Data

You can reference data from previous nodes in your message:

New order received! 🛒

Order ID: {{$node["Webhook"].json.orderId}}
Customer: {{$node["Webhook"].json.customerName}}
Total: {{$node["Webhook"].json.total}}

Please process this order.

Variable syntax may vary based on your workflow configuration. Check the node output data to see available fields.

Output Data

When the message is sent successfully, the node returns:

{
  "ok": true,
  "result": {
    "message_id": 123,
    "from": {
      "id": 1234567890,
      "is_bot": true,
      "first_name": "Your Bot Name",
      "username": "your_bot"
    },
    "chat": {
      "id": 987654321,
      "first_name": "Recipient Name",
      "type": "private"
    },
    "date": 1705315800,
    "text": "Your message content"
  }
}

You can use message_id in subsequent nodes to reference this message.

Common Use Cases

1. Notifications & Alerts

Get notified when important events happen in your app (new orders, errors, form submissions, etc.)

2. Status Reports

Send daily/weekly reports about your system's status, metrics, or analytics directly to Telegram

3. Customer Support

Build a bot that forwards customer messages to your support team via Telegram

4. Monitoring & DevOps

Monitor your servers and get instant alerts about downtime, high CPU usage, or deployment status

Example Workflows

Webhook to Telegram Notification

Receive a Telegram message whenever your webhook receives data:

Webhook Trigger→Send Telegram Message

AI Analysis with Telegram Output

Use AI to analyze data and send the results to Telegram:

Webhook→AI Agent→Send Telegram

Troubleshooting

Error: "Chat not found"

This error occurs when:

The Chat ID is incorrect
The user hasn't started a conversation with your bot
Your bot was removed from the group/channel

Solution: Make sure the user has messaged your bot at least once, and verify the Chat ID using the getUpdates method.

Error: "Forbidden: bot was blocked by the user"

The user has blocked your bot on Telegram.

Solution: Ask the user to unblock your bot before sending messages.

Error: "Unauthorized"

Your bot token is invalid or has been revoked.

Solution: Check your credential in Buzz8n and make sure the bot token is correct. If needed, generate a new token from @BotFather.

Messages aren't being delivered to groups

For groups, make sure:

Your bot is a member of the group
The bot has permission to send messages
Group privacy settings allow bots
You're using the correct negative Chat ID

Best Practices

Keep messages concise: Telegram has a 4096 character limit per message
Use formatting: Make messages easier to read with bold, italic, and code formatting
Handle errors gracefully: Add error handling nodes in case the message fails to send
Test with your own account: Always test messages with your own Chat ID first
Respect rate limits: Don't spam users - Telegram has rate limits to prevent abuse