Telegram CoPilotInstall

Overview

This node integrates with Telegram via the TelePilot API, enabling automation of various Telegram operations. Specifically, for the File resource and Get Remote File operation, it allows users to download a remote file from Telegram by specifying its unique remote file identifier.

Common scenarios where this node is beneficial include:

• Automating retrieval of files shared in Telegram chats or channels.
• Integrating Telegram file downloads into workflows that process or archive media.
• Fetching remote files for further processing, such as analysis or forwarding.

Example use case: A user wants to automatically download images or documents sent to a Telegram bot and then upload them to cloud storage or analyze their content.

Properties

Output

The node outputs an array of JSON objects representing the downloaded remote 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 URLs or binary data references if applicable.

If the node supports downloading the actual file content (binary), it would be included in the output for further workflow usage, but this specific operation focuses on retrieving the remote file metadata and access information.

Dependencies

• Requires an active Telegram API credential configured in n8n, including necessary authentication tokens.
• Depends on the TelePilotNodeConnectionManager to manage Telegram client sessions and API calls.
• The node requires the Telegram account to be logged in and authorized; otherwise, it will prompt for login via the ChatTrigger node or similar mechanism.
• Network access to Telegram servers is required.

Troubleshooting

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

• Error: "Please login"
  The node cannot perform the operation because the Telegram client is not authenticated. Use the ChatTrigger node to complete login steps.

• Invalid or missing File ID
  Ensure the "File ID" property is correctly set and corresponds to a valid remote file on Telegram.

• 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 authenticating your Telegram account.
• Telegram Bot API Documentation — General reference for Telegram API methods and file handling.
• TelePilot GitHub Repository (if available) — For source code and issues related to the TelePilot integration.