Telegram CoPilot

Overview

This node integrates with Telegram via the TelePilot API, enabling automation and interaction with Telegram accounts. Specifically, the File - Get Remote File operation allows users to download a remote file from Telegram by specifying its unique identifier.

Common scenarios where this node is beneficial include:

• Automatically retrieving files shared in Telegram chats for further processing or storage.
• Integrating Telegram file downloads into workflows that require access to media or documents sent via Telegram.
• Building bots or automation that respond to messages by fetching associated files.

Example use case: A workflow that listens for new messages containing file references, then uses this node to fetch those files remotely for analysis or archival.

Properties

Output

The node outputs an array of JSON objects representing the downloaded file's metadata and content information as returned by the TelePilot client. The exact structure depends on the Telegram API response but typically includes file details such as file size, path, type, and possibly a URL or binary data reference.

If the node supports binary data output (not explicitly shown here), it would represent the actual file content downloaded from Telegram.

Dependencies

• Requires a valid 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.
• Network access to Telegram servers is necessary.
• The node expects the user to be logged in via the TelePilot login flow before performing file operations.

Troubleshooting

• Error: "Session was closed or terminated. Please login again"
  This indicates the Telegram session has expired or been closed. Resolve by re-running the login process using the ChatTrigger node and login commands as per https://telepilot.co/login-howto.

• Error: "Please login"
  The node requires an active Telegram session. Ensure you have completed the login steps and the session is active.

• Invalid or missing File ID
  Make sure the "File ID" property is correctly set to a valid remote file identifier.

• Network or API errors
  Check network connectivity and ensure the Telegram API credentials are valid and have sufficient permissions.

Links and References

• TelePilot Login Guide — Instructions for logging in and managing Telegram sessions.
• Telegram Bot API Documentation — For understanding Telegram file identifiers and related concepts.