Telegram CoPilot icon

Telegram CoPilot

Your Personal Telegram CoPilot

Actions30

Overview

This node integrates with Telegram via the TelePilot API, enabling automation and interaction with Telegram accounts. Specifically, the Chat - Search Public Chats (Search in Username, Title) operation allows users to search for public Telegram chats by providing a text query that matches usernames or chat titles.

Common scenarios where this node is beneficial include:

  • Finding public Telegram groups or channels related to a specific topic or keyword.
  • Automating discovery of relevant communities for marketing, support, or content sharing.
  • Integrating Telegram chat search into workflows that require dynamic retrieval of chat information.

Example:
A user wants to find all public Telegram chats related to "technology news". They provide the query "technology news" to this node, which returns a list of matching public chats including their usernames and titles.

Properties

Name Meaning
Query The text string used to search public Telegram chats by looking in their username and title.

Output

The output is an array of JSON objects representing the public chats found by the search query. Each object contains details about a public chat such as its username, title, and other metadata returned by the Telegram API.

  • The json field holds the search results.
  • No binary data output is produced by this operation.

Dependencies

  • Requires an active Telegram API authentication token (API key credential) configured in n8n.
  • Depends on the TelePilot Node Connection Manager to handle Telegram client sessions.
  • The node uses the Telegram TDLib-based API via TelePilot for all interactions.
  • Proper login/authentication must be established before performing operations; otherwise, errors will occur.

Troubleshooting

  • Error: "Please login"
    This indicates the Telegram session is not authenticated. Use the login operation with phone number and code first to establish a session.

  • Error: "Session was closed or terminated"
    The Telegram client session has been closed unexpectedly. Re-login is required.

  • No results returned
    Ensure the query string is valid and that there are public chats matching the search terms.

  • Unauthorized errors
    Usually caused by invalid or expired credentials. Refresh or re-enter the API authentication token.

  • Rate limits or API restrictions
    Telegram may limit the frequency of requests. Implement delays or retries if needed.

Links and References

Discussion