Telegram CoPilot icon

Telegram CoPilot

Your Personal Telegram CoPilot

Actions27

Overview

This node, part of the "Telegram CoPilot" integration, enables sending a photo message to a Telegram chat. It is useful for automating the sharing of images within Telegram chats, such as sending notifications with visual content, sharing photos in group discussions, or delivering media-rich messages in customer support workflows.

For example, you can use this node to send a product image to a sales team chat automatically when a new item is added to your inventory, or to share event photos in a community group chat.

Properties

Name Meaning
Chat ID The unique identifier of the Telegram chat where the photo message will be sent.
Message Photo Local file path to the photo that will be sent (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, creating a threaded response.

Output

The node outputs an array of JSON objects representing the result of the send message operation. Each object contains details about the sent message, including metadata returned by Telegram's API such as message identifiers and status.

If the node supports binary data output (not explicitly shown here), it would typically represent the photo or related media content, but in this case, the output focuses on JSON metadata about the sent message.

Dependencies

  • Requires an active Telegram API authentication token (API key credential) configured in n8n.
  • Depends on the Telegram client session managed internally; users must be logged in via the node’s login mechanism before sending messages.
  • The local file specified in "Message Photo" must be accessible by the n8n instance running this node.

Troubleshooting

  • Common Issues:

    • Sending fails if the Telegram session is not logged in or has expired. Users should ensure they have completed the login process using the node’s login operations.
    • File path errors occur if the specified photo file does not exist or is inaccessible.
    • Invalid chat IDs or permissions may cause message sending to fail.

  • Error Messages:

    • "Session was closed or terminated. Please login again": Indicates the Telegram client session is no longer valid; re-login is required.
    • "Please login": The node detected an unauthorized state; user must authenticate again.
    • File-related errors usually indicate missing or incorrect file paths.

Links and References

Discussion