Telegram CoPilot

Overview

This node integrates with Telegram via the TelePilot API, enabling automation of various Telegram operations. Specifically, for the File resource and 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.
• Downloading files for further processing or storage in workflows.
• Integrating Telegram file downloads into larger automation pipelines, such as saving files to cloud storage or triggering other actions based on downloaded content.

Example use case: A user receives files in a Telegram group and wants to automatically download these files to a server for backup or analysis.

Properties

Output

The node outputs an array of JSON objects representing the result of the download operation. Each output item corresponds to the response from the TelePilot API's downloadFile method, which includes metadata about the downloaded file such as its path, size, and status.

If the file is successfully downloaded, the output JSON will contain details about the local file location and related attributes.

The node does not explicitly handle binary data output in this operation; instead, it returns JSON metadata about the downloaded file.

Dependencies

• Requires a valid Telegram API authentication credential (an API key credential) configured in n8n.
• Depends on the TelePilot Node Connection Manager to manage Telegram client sessions and API calls.
• The node uses the TelePilot API internally to invoke Telegram methods.
• No additional external services are required beyond Telegram and the TelePilot API.

Troubleshooting

• Error: "Please login" or "Unauthorized"
  This indicates the Telegram session is not authenticated or has expired. Users should ensure they have completed the login process using the appropriate login operation before attempting to download files.

• Error: "A closed client cannot be reused"
  The Telegram client session was closed unexpectedly. Re-authenticate by logging in again.

• Invalid File ID
  If the provided File ID is incorrect or expired, the download will fail. Verify the File ID is current and correct.

• File Not Found or Access Denied
  The bot or user may not have permission to access the specified file. Check chat permissions and file availability.

• Network or API Errors
  Temporary network issues or Telegram API rate limits can cause failures. Retry after some time or check API usage limits.

Links and References

• TelePilot Documentation — Guide for login and usage.
• Telegram Bot API — Official Telegram API reference.
• n8n Documentation — General information on creating and using nodes.