Telegram CoPilot

Overview

This node integrates 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 important chats as unread to remind yourself or others to revisit them later.

Practical examples include:

• Automatically marking customer support chats as unread when new messages arrive to ensure follow-up.
• Marking group chats as unread based on certain triggers or conditions in your workflow.
• Managing personal chat notifications by toggling unread status through automation.

Properties

Output

The node outputs an array of JSON objects representing the result of the Telegram API call for toggling the unread status of the chat. The exact structure depends on the Telegram API response but generally includes confirmation of the action and updated chat metadata.

No binary data output is produced by this operation.

Dependencies

• Requires an API key credential for authenticating with the TelePilot Telegram API.
• The node depends on the TelePilotNodeConnectionManager service internally to manage Telegram client sessions.
• Proper login/authentication must be established before using this operation; otherwise, the node will throw errors prompting login.

Troubleshooting

• Common Issues:

  • Attempting to mark a chat as unread without a valid session will cause authentication errors.
  • Providing an invalid or non-existent Chat ID will likely result in an error from the Telegram API.
  • Network issues or expired sessions may cause the client to close unexpectedly.

• Error Messages and Resolutions:

  • "Please login": Indicates that the Telegram session is not authenticated. Resolve by running the login operation first.
  • "Session was closed or terminated. Please login again": The client session has ended; re-authenticate.
  • "Unauthorized": Invalid or expired credentials; re-enter API key or refresh authentication.
  • If continueOnFail is enabled, errors are returned as part of the output JSON instead of stopping execution.

Links and References

• TelePilot Login Guide — Instructions for setting up Telegram login and authentication.
• Telegram Bot API Documentation — General reference for Telegram API methods (note: TelePilot uses TDLib under the hood, so some differences apply).