Actions26
- Chat Actions
- File Actions
- Group Actions
- Message Actions
- User Actions
Overview
This node integrates with Telegram via the TelePilot API, enabling automation and interaction with Telegram chats, users, messages, groups, files, and contacts. Specifically, the "Mark Chat as Unread" operation allows users to toggle the unread status of a chat by marking it as read or unread.
Common scenarios for this node include:
- Automating Telegram chat management workflows.
- Marking important chats as unread to remind users to revisit them later.
- Integrating Telegram chat status updates into broader automation pipelines.
For example, you could use this node to mark a chat as unread when a certain keyword is detected in incoming messages, ensuring that the chat remains highlighted for follow-up.
Properties
| Name | Meaning |
|---|---|
| Chat ID | The unique identifier of the Telegram chat to operate on (e.g., "122323"). |
| Mark as Unread? | Boolean flag indicating whether to mark the chat as unread (true) or read (false). |
Output
The node outputs an array of JSON objects representing the result of the invoked Telegram API method. For the "Mark Chat as Unread" operation, the output JSON contains the response from the Telegram API confirming the updated unread status of the specified chat.
The exact structure depends on the Telegram API response but generally includes fields related to the chat's current state after toggling the unread mark.
No binary data output is produced by this operation.
Dependencies
- Requires an active Telegram API credential with appropriate permissions (an API key credential).
- Depends on the TelePilot Node Connection Manager to handle client sessions and API invocations.
- Requires proper login/authentication to Telegram via phone number and code before operations can be performed.
- The node uses environment/session management internally; users must ensure their Telegram session is active and valid.
Troubleshooting
- Session Closed or Unauthorized Errors: If the error message states "A closed client cannot be reused" or "Unauthorized," it means the Telegram session has expired or was terminated. The user should re-authenticate using the login flow described at https://telepilot.co/login-howto.
- Invalid Chat ID: Providing an incorrect or non-existent chat ID will cause the operation to fail. Verify the chat ID is correct.
- Missing Credentials: Ensure the Telegram API credentials are configured correctly in n8n.
- Network Issues: Connectivity problems may prevent the node from communicating with Telegram servers.
- Command Not Supported: When using commands in login flows, unsupported commands will return guidance messages.
Links and References
- TelePilot Login Guide — Instructions for authenticating your Telegram account.
- Telegram API Documentation — Official Telegram API reference.
- TelePilot GitHub Repository — Source and additional documentation for TelePilot.