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 specified 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.

A practical example: Automatically send a photo from a local file path to a Telegram chat when a new image is generated or uploaded elsewhere in your workflow.

Properties

Name Meaning
Chat ID The unique identifier of the Telegram chat where the photo message will be sent.
Message Photo Local filesystem path to the photo file that will be sent in the message (e.g., /tmp/my-pic.png).
Photo Caption Optional text caption to accompany the photo in the message.
Reply to messageId Optional message ID to which this photo message will be a reply (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 the Telegram API such as message identifiers and status.

No binary data output is produced by this node; it only sends a photo from a local file path and returns JSON metadata about the sent message.

Dependencies

  • Requires a valid Telegram API authentication credential (an API key/token) configured in n8n.
  • Access to the local file system path where the photo is stored.
  • The node depends on an internal connection manager to handle Telegram client sessions.

Troubleshooting

  • Common issues:

    • Invalid or missing Chat ID can cause failure to send the message.
    • Incorrect or inaccessible local file path for the photo will prevent sending.
    • Not logged in or expired Telegram session will cause authorization errors.

  • Error messages:

    • "Session was closed or terminated. Please login again": Indicates the Telegram session is no longer active; re-authentication is required.
    • "Please login": The node cannot perform actions without a valid Telegram login session.
    • File not found or permission denied errors if the local photo path is incorrect or inaccessible.

To resolve these:

  • Ensure the Chat ID is correct and the bot/user has access to the chat.
  • Verify the local file path exists and is readable by n8n.
  • Re-login using the Telegram login flow if session errors occur.

Links and References

Discussion