Telegram CoPilotInstall

Overview

This node integrates with Telegram via the TelePilot API, enabling automation and interaction with Telegram chats, users, messages, files, groups, and login sessions. Specifically, the Search Public Chat (by Username) operation under the Chat resource allows users to search for a public Telegram chat by its username.

Common scenarios where this node is beneficial include:

• Automating Telegram chat management tasks such as searching for public channels or groups.
• Integrating Telegram chat data into workflows, e.g., fetching chat info before sending messages.
• Building bots or services that interact with Telegram chats programmatically.

Practical example:

• You want to find a public Telegram channel by its username to retrieve its details or join it automatically in your workflow. Using this operation, you provide the username, and the node returns the chat information if found.

Properties

Output

The output is an array of JSON objects representing the result of the searchPublicChat invocation. Each object contains detailed information about the found public chat, including metadata such as chat ID, title, type, and other Telegram-specific properties.

If the chat is found, the output JSON will contain the chat's full description as returned by the Telegram API via TelePilot.

No binary data is output by this operation.

Dependencies

• Requires a valid Telegram API authentication credential (an API key credential) configured in n8n.
• Depends on the TelePilot Node Connection Manager to handle Telegram client sessions and API calls.
• The node uses the TelePilot API client internally to invoke Telegram methods.
• Proper login/authentication must be established before using this operation; otherwise, the node will throw errors prompting login.

Troubleshooting

• Error: "Please login" or "Unauthorized"
  This indicates the Telegram session is not authenticated or has expired. Resolve by running the login operation first (e.g., using the loginWithPhoneNumber action) to authenticate the Telegram account.

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

• Empty or no results returned
  Ensure the username provided is correct and corresponds to a public Telegram chat. Private or invalid usernames will not return results.

• API rate limits or network issues
  Temporary failures may occur due to Telegram API limits or connectivity problems. Retry after some time.

Links and References

• TelePilot Documentation — Guide for login and usage instructions.
• Telegram Bot API — Official Telegram API reference (note: TelePilot uses TDLib, which differs but concepts overlap).
• n8n Documentation — For general node usage and credential setup.