Actions33
- Chat Actions
- Custom Request Actions
- File Actions
- Group Actions
- Message Actions
- User Actions
Overview
The node provides integration with Telegram via the TelePilot API, enabling automation of various Telegram chat-related actions. Specifically, the "Mark Chat as Unread" operation allows users to toggle the unread status of a specified chat. This is useful in scenarios where you want to programmatically mark chats as unread to remind yourself or others to revisit them later.
Practical examples include:
- Automatically marking important chats as unread when certain keywords appear.
- Resetting the unread status after processing messages to manage notification workflows.
- Integrating with other systems to flag chats that require follow-up.
Properties
| Name | Meaning |
|---|---|
| Chat ID | The unique identifier of the chat to be marked as unread. |
| Mark as Unread? | Boolean option to specify whether to mark the chat as unread (true) or read (false). |
Output
The output is a JSON object representing the result of the toggle operation on the chat's unread status. It typically contains confirmation details from the Telegram API about the updated chat state.
No binary data output is involved in this operation.
Dependencies
- Requires an active Telegram API authentication credential (an API key and associated login).
- Depends on the TelePilotNodeConnectionManager for managing Telegram client sessions.
- The node expects the user to be logged in; otherwise, it will prompt for login using phone number and authentication codes.
- No additional external services beyond Telegram are required.
Troubleshooting
Common Issues:
- Attempting to mark a chat as unread without being logged in will cause errors.
- Invalid or expired session tokens may lead to authorization failures.
- Incorrect or non-existent Chat IDs will result in failed operations.
Error Messages and Resolutions:
"Please login": Indicates the Telegram session is not authenticated. Resolve by performing the login operation first."A closed client cannot be reused, create a new Client": The session was closed or terminated. Re-login is necessary."Unauthorized": Authentication token is invalid or expired. Re-authenticate.- If the node is set to continue on fail, errors will be returned in the output JSON instead of stopping execution.
Links and References
- TelePilot Login Guide — Instructions for logging into Telegram via TelePilot.
- Telegram API Documentation — Official Telegram API reference for deeper understanding of chat operations.