Telegram CoPilotInstall

Overview

This node integrates with Telegram via the TelePilot API, enabling automation and interaction with Telegram accounts. Specifically, for the File resource with the Download File operation, it allows users to download a file from Telegram by specifying its file identifier.

Common scenarios where this node is beneficial include:

• Automating retrieval of media or documents shared in Telegram chats.
• Archiving files from Telegram channels or groups.
• Processing downloaded files further in an n8n workflow (e.g., saving to cloud storage, analyzing content).

Example: A user can input a Telegram file ID to download that file directly within an n8n workflow, then pass the file data to subsequent nodes for processing or storage.

Properties

The File ID property is required and should be the unique identifier of the Telegram file you want to download.

Output

The node outputs a JSON array containing the result of the download operation. The JSON structure corresponds to the Telegram file object returned by the TelePilot API, which typically includes metadata about the file such as its path, size, and other attributes.

If the file contains binary data, the node handles downloading it synchronously, but the output shown here is JSON metadata describing the file rather than raw binary content.

Dependencies

• Requires an API key credential for the TelePilot Telegram API integration.
• The node depends on the TelePilotNodeConnectionManager to manage Telegram client sessions.
• Proper login/authentication with Telegram is necessary before performing file downloads.
• No additional environment variables are explicitly required beyond the API credentials.

Troubleshooting

• Error: "Session was closed or terminated. Please login again"
  This indicates the Telegram session has expired or been closed. Re-authenticate using the login flow described at https://telepilot.co/login-howto.

• Error: "Please login"
  The node cannot perform operations without a valid Telegram session. Use the ChatTrigger node with the login operation to authenticate first.

• Unauthorized errors
  Usually caused by invalid or expired credentials. Verify your API key and re-login if needed.

• Invalid File ID
  If the file ID does not exist or is incorrect, the download will fail. Double-check the file identifier.

Links and References

• TelePilot Login Guide — Instructions for authenticating Telegram accounts.
• Telegram Bot API Documentation — For understanding Telegram file objects and related concepts.
  (Note: TelePilot uses TDLib under the hood, so some API calls differ from the Bot API.)