Telegram CoPilot icon

Telegram CoPilot

Your Personal Telegram CoPilot
Join our community

Actions33

Overview

This node enables sending a photo message to a Telegram chat using the Telegram CoPilot API integration. It is useful for automating the sharing of images in Telegram chats, channels, or groups directly from workflows. Common scenarios include sending notifications with images, sharing product photos, or posting event pictures automatically.

For example, you can use this node to send a promotional image to a marketing group chat whenever a new campaign starts, or to share a photo update in a project channel.

Properties

Name Meaning
Chat ID The unique identifier of the Telegram chat where the photo will be sent.
Message Photo Local file system path to the photo file that will be uploaded and sent.
Photo Caption Optional text caption to accompany the photo message.
Reply to threadID (Optional) Identifier of a message thread within the chat to send the photo as a reply in that thread. If 0 or empty, sends to main chat.
Reply to messageId (Optional) Identifier of a specific message to reply to with the photo.

Output

The node outputs an array of JSON objects representing the response from the Telegram API after sending the photo message. Each output item contains details about the sent message, including message identifiers and metadata returned by Telegram.

No binary data is output by this node; it only returns JSON describing the result of the send operation.

Dependencies

  • Requires a valid Telegram API authentication credential (an API key/token) configured in n8n.
  • The local file path specified must be accessible by the n8n instance running the workflow.
  • The Telegram CoPilot service handles communication with Telegram's API.

Troubleshooting

  • File Not Found: If the specified photo file path does not exist or is inaccessible, the node will fail. Ensure the file path is correct and readable by n8n.
  • Invalid Chat ID: Providing an incorrect or unauthorized chat ID will cause the Telegram API to reject the request. Verify the chat ID is valid and the bot/user has permission to send messages there.
  • Caption Issues: Empty captions are treated as null; ensure captions are properly formatted if used.
  • Reply IDs: If message_thread_id or reply_to_msg_id refer to non-existent threads or messages, the send may fail or the reply will not be attached correctly.
  • Authentication Errors: If the Telegram API credentials are invalid or expired, the node will throw errors indicating login is required. Re-authenticate using the recommended login flow.
  • API Limits: Large files or frequent requests may hit Telegram limits; check error messages for size or rate limit issues.

Links and References

Discussion