Overview
This node sends a simple text message to a specified Telegram chat or channel using the Telegram Bot API. It is useful for automating notifications, alerts, or any kind of messaging directly into Telegram chats or channels by specifying the target chat ID or username.
Common scenarios include:
- Sending alerts from monitoring systems to a Telegram group.
- Notifying users about workflow results or status updates.
- Broadcasting messages to Telegram channels automatically.
For example, you can configure this node to send a message "Backup completed successfully" to your admin Telegram group after a backup workflow finishes.
Properties
| Name | Meaning |
|---|---|
| Chat ID | Unique identifier of the target chat or the username of the target channel (to get the ID use @get_id_bot). |
| Text | The text content of the message to be sent. |
| Reply Markup (JSON) | JSON object defining custom reply interface options like keyboards. Example: { "keyboard": [["Button 1"]], "resize_keyboard": true } |
Output
The node outputs an array of JSON objects representing the response from the Telegram API for each input item processed. Each output item contains the full JSON response returned by the Telegram sendMessage method, which includes details such as message ID, chat info, date, and the sent message content.
No binary data is produced by this node.
Dependencies
- Requires a valid Telegram Bot API token configured in the node credentials.
- Access to the Telegram Bot API endpoint (
https://api.telegram.org) is needed. - The user must provide the correct chat ID or channel username where the bot has permission to send messages.
Troubleshooting
- Invalid Chat ID or Username: If the chat ID or username is incorrect or the bot is not a member of the chat/channel, the API will return an error. Verify the chat ID using the recommended bot (@get_id_bot) and ensure the bot has permissions.
- Malformed JSON in Reply Markup: If the Reply Markup JSON is invalid, the node throws an error indicating JSON parsing failure. Ensure the JSON syntax is correct.
- API Request Failures: Network issues or invalid tokens will cause request errors. Check the API token validity and network connectivity.
- Empty Input: If no input items are provided, the node returns an empty array without sending any messages.
Links and References
- Telegram Bot API - sendMessage
- Telegram Bot FAQ on getting chat IDs (bot to retrieve chat IDs)