Telegram CoPilot icon

Telegram CoPilot

Your Personal Telegram CoPilot

Actions27

Overview

This node acts as a personal Telegram assistant, enabling interaction with the Telegram API to perform various actions such as managing chats, users, messages, and files. Specifically, for the Chat resource and the Search Public Chats (Search in Username, Title) operation, it allows users to search for public Telegram chats by querying their usernames and titles.

Common scenarios where this node is beneficial include:

  • Finding public Telegram groups or channels related to a specific topic by searching keywords in their usernames or titles.
  • Automating the discovery of relevant public chats for marketing, community engagement, or research purposes.
  • Integrating Telegram chat search functionality into workflows that require dynamic retrieval of chat information.

Example use case:

  • A user wants to find all public Telegram channels related to "technology" and then process or analyze these channels further within an automated workflow.

Properties

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

Output

The node outputs an array of JSON objects representing the search results from Telegram's public chats matching the query. Each object contains details about a public chat such as its username, title, and other metadata provided by the Telegram API.

If the node supports binary data output (not applicable specifically for this operation), it would typically represent downloaded files or media content.

Dependencies

  • Requires an API key credential for authenticating with the Telegram API.
  • Depends on an internal connection manager to handle Telegram client sessions.
  • The node uses Telegram's TDLib-based API calls to perform operations.
  • Proper login/authentication must be established before performing chat searches; otherwise, the node will throw errors prompting the user to log in.

Troubleshooting

  • Common issues:

    • Not logged in or session expired: The node requires a valid Telegram session. If the session is closed or unauthorized, the node will prompt to log in again.
    • Invalid or missing API credentials: Ensure the API key credential is correctly configured.
    • Empty or invalid query parameter: The Query property must be a non-empty string.

  • Error messages:

    • "Please login: https://telepilot.co/login-howto": Indicates the Telegram session is not authenticated. Follow the linked guide to authenticate.
    • "Session was closed or terminated. Please login again: https://telepilot.co/login-howto": The current session is no longer valid; re-authentication is required.
    • "Unauthorized": The API credentials are invalid or expired; re-enter credentials and log in.

Links and References

Discussion