Telegram CoPilot icon

Telegram CoPilot

Your Personal Telegram CoPilot

Actions26

Overview

This node integrates with Telegram via the TelePilot API, enabling automation of various Telegram actions. Specifically for the Message resource and the Send Message with Photo operation, it allows sending a photo message to a specified chat in Telegram.

Common scenarios where this node is beneficial include:

  • Automatically sending images to Telegram chats as part of notifications or alerts.
  • Sharing photos from workflows triggered by external events (e.g., new files uploaded, monitoring systems).
  • Replying to specific messages with photos in group or private chats.

Example use case: A workflow that monitors a folder for new images and sends each new image as a photo message to a Telegram chat, optionally adding captions or replying to a previous message.

Properties

Name Meaning
Chat ID The unique identifier of the Telegram chat where the photo will be sent.
Message Photo Local file path to the photo to send (e.g., /tmp/my-pic.png).
Photo Caption Optional text caption to accompany the photo message.
Reply to messageId Optional message ID to which this photo message will reply (threaded response).

Output

The node outputs an array of JSON objects representing the result of the Telegram API call to send the photo message. This typically includes metadata about the sent message such as message ID, chat ID, timestamps, and content details.

If the operation succeeds, the output JSON contains the full Telegram message object corresponding to the sent photo message.

Binary data is not directly output by this node; instead, it uses a local file path input to read the photo from disk.

Dependencies

  • Requires an active Telegram API authentication credential (an API key/token) configured in n8n.
  • Depends on the TelePilot Node Connection Manager to handle Telegram client sessions and API calls.
  • The local file path provided must be accessible by the n8n instance running this node.

Troubleshooting

  • "Session was closed or terminated. Please login again": Indicates the Telegram session expired or was disconnected. Resolve by re-authenticating using the login flow described at https://telepilot.co/login-howto.
  • "Please login": The node cannot perform actions without a valid Telegram session. Use the login commands or nodes to authenticate first.
  • File not found or inaccessible: Ensure the localFilePath points to a valid file accessible by n8n.
  • Invalid Chat ID: Verify the chat ID is correct and the bot/user has permission to send messages there.
  • Network or API errors may occur if Telegram services are unreachable or credentials are invalid.

Links and References

Discussion