Actions26
- Chat Actions
- File Actions
- Group Actions
- Message Actions
- User Actions
Overview
This node, named "Telegram CoPilot," provides extensive interaction capabilities with the Telegram platform via its API. It acts as a personal assistant for Telegram, enabling automation and management of various Telegram resources such as chats, users, messages, groups, contacts, and files.
The specific operation "Search Public Chat (by Username)" under the "Chat" resource allows users to search for public Telegram chats by providing a username. This is useful when you want to find and interact with public channels or groups on Telegram without manually searching in the app.
Common scenarios:
- Automating the discovery of public Telegram channels or groups by username.
- Integrating Telegram chat search into workflows that require fetching chat details dynamically.
- Building bots or services that respond based on public chat information.
Example:
You want to automatically find a public Telegram channel by its username to fetch its metadata or join it programmatically as part of a larger automation workflow.
Properties
| Name | Meaning |
|---|---|
| Chat Username | The username of the public chat to search for. This is a required string input. |
Output
The output is a JSON array containing the result of the searchPublicChat API call. This typically includes detailed information about the found public chat, such as its ID, title, type (channel, group), and other metadata provided by Telegram's API.
No binary data output is indicated for this operation.
Dependencies
- Requires an API key credential for Telegram (referred generically as "an API key credential").
- Depends on the TelePilotNodeConnectionManager to manage Telegram client sessions and API calls.
- Requires proper login/authentication to Telegram via phone number and code before performing operations.
- The node uses the Telegram TDLib API internally through the connection manager.
Troubleshooting
- Not logged in error: If the Telegram account session is not active or has been closed, the node will throw errors prompting to log in again. Users should follow the login instructions at https://telepilot.co/login-howto.
- Unauthorized error: Indicates invalid or expired credentials; re-authentication is needed.
- Session closed error: Happens if the client session was terminated unexpectedly; requires re-login.
- Invalid username or no results: If the username does not correspond to any public chat, the output may be empty or contain an error message from Telegram.
- Ensure the username is correctly formatted and corresponds to a public chat.
Links and References
- TelePilot Login Guide — Instructions for logging in and managing Telegram sessions.
- Telegram TDLib Documentation — For understanding the underlying Telegram API used.
- Telegram Bots FAQ — General info about Telegram bot interactions.