Telegram CoPilotInstall

Overview

This node integrates with the Telegram platform 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 unique file identifier.

Common scenarios where this node is beneficial include:

• Automating retrieval of media or documents shared in Telegram chats.
• Archiving files received on Telegram into other systems.
• Processing downloaded files further in an n8n workflow (e.g., analyzing images, storing documents).

Example: A user can provide a Telegram file ID to this node, which then downloads the corresponding file content, allowing subsequent nodes to process or store the file.

Properties

The File ID property is a required string that uniquely identifies the file within Telegram to be downloaded.

Output

The node outputs an array of JSON objects representing the result of the download operation. The exact structure depends on the TelePilot API response but generally includes metadata about the downloaded file such as file path, size, and status.

If the file is binary (e.g., image, document), the node will handle the binary data accordingly, making it available for downstream processing in the workflow.

Dependencies

• Requires a valid Telegram API authentication token (an API key credential) configured in n8n credentials.
• Depends on the TelePilotNodeConnectionManager class to manage Telegram client sessions and API calls.
• The node uses the TelePilot API internally to perform operations; thus, internet access and proper Telegram API credentials are necessary.

Troubleshooting

• Session Closed or Unauthorized Errors:
  If the error message indicates "A closed client cannot be reused" or "Unauthorized," it means the Telegram session has expired or is invalid. The user must re-authenticate using the login procedure described at https://telepilot.co/login-howto.

• Invalid File ID:
  Providing an incorrect or non-existent file ID may cause the download to fail. Verify the file ID is correct and accessible by the authenticated Telegram account.

• Network Issues:
  Ensure stable internet connectivity since the node communicates with Telegram servers.

• Missing Credentials:
  The node requires a valid Telegram API credential. Without it, operations will not succeed.

Links and References

• TelePilot Login Guide — Instructions for authenticating Telegram accounts.
• Telegram Bot API Documentation — General reference for Telegram API capabilities (note: TelePilot uses TDLib under the hood, which differs slightly).
• n8n Documentation on Credentials — How to configure API keys and tokens in n8n.