Actions26
- Chat Actions
- File Actions
- Group Actions
- Message Actions
- User Actions
Overview
The "Telegram CoPilot" node enables interaction with Telegram through various resources and operations, acting as a personal assistant for managing Telegram chats, messages, users, groups, files, and login sessions. Specifically, the Chat - Open Chat operation opens a specified chat by its ID, which can be useful to programmatically access or activate a chat session within Telegram.
Common scenarios where this node is beneficial include:
- Automating chat management tasks such as opening, closing, or joining chats.
- Integrating Telegram chat interactions into workflows, e.g., opening a chat before sending messages or retrieving chat history.
- Building custom Telegram bots or automation tools that require direct control over chat sessions.
Practical example:
- Automatically open a chat by its ID when a certain event occurs in your workflow, preparing it for subsequent message sending or data retrieval.
Properties
| Name | Meaning |
|---|---|
| Chat ID | The unique identifier of the Telegram chat to open. This is required to specify which chat to open. |
Output
The node outputs an array of JSON objects representing the result of the invoked Telegram API call for opening the chat. The exact structure depends on Telegram's response but typically includes details about the chat such as its ID, type, title, participants, and other metadata.
If the node supports binary data output (not explicitly shown for this operation), it would represent files or media related to chats or messages, but for the "Open Chat" operation, the output is purely JSON-based.
Dependencies
- Requires an active Telegram API authentication credential (an API key and associated credentials).
- Depends on the TelePilotNodeConnectionManager to manage Telegram client sessions.
- Requires proper login/authentication via phone number and code before performing chat operations.
- The node uses the Telegram TDLib API under the hood, so network connectivity to Telegram servers is necessary.
Troubleshooting
- Session Not Logged In: If the Telegram account is not logged in, the node will throw an error prompting to log in first. Use the login operation with phone number and authentication code to establish a session.
- Closed Client Error: If the client session was closed or terminated, the node will instruct to log in again.
- Unauthorized Error: Indicates invalid or expired credentials; re-authentication is required.
- Invalid Chat ID: Providing an incorrect or non-existent chat ID may cause the operation to fail or return empty results.
- Network Issues: Connectivity problems with Telegram servers can cause timeouts or failures.
To resolve these issues:
- Ensure the Telegram account is properly logged in using the login flow.
- Verify the chat ID is correct and accessible by the authenticated user.
- Check network connectivity.
- Follow the provided guide at https://telepilot.co/login-howto for detailed login and troubleshooting instructions.
Links and References
- TelePilot Login Guide
- Telegram TDLib Documentation
- Telegram Bot API Overview (for general Telegram bot concepts)