Telegram CoPilot icon

Telegram CoPilot

Your Personal Telegram CoPilot

Actions28

Overview

The Mark Chat as Unread operation in the "Telegram CoPilot" (TelePilot) n8n node allows you to programmatically mark a specific Telegram chat as unread or read. This is useful for workflow automations where you want to manage chat states, such as flagging important conversations for follow-up or resetting their unread status after processing.

Practical scenarios:

  • Automatically marking chats as unread if certain keywords are detected, prompting manual review.
  • Resetting the unread status of chats after automated message processing.
  • Integrating with CRM or support systems to track which conversations require attention.

Properties

Display Name Type Description
Chat ID String The unique identifier of the chat to be updated. Example: 122323. Required.
Mark as Unread? Boolean Whether the chat should be marked as unread (true) or not (false). Required.

Output

The output is a JSON object representing the result of the toggle operation. The structure typically includes:

{
  "_": "toggleChatIsMarkedAsUnread",
  "chat_id": "<provided_chat_id>",
  "is_marked_as_unread": <true_or_false>
}
  • _: Operation name (should be "toggleChatIsMarkedAsUnread").
  • chat_id: The ID of the chat that was updated.
  • is_marked_as_unread: Boolean indicating the new unread status.

Additional fields may be present depending on the Telegram API response, but these are the core elements relevant to this operation.

Dependencies

  • External Service: Requires access to the Telegram API via the TelePilot backend.
  • Credentials: You must configure and provide valid TelePilot API credentials (telePilotApi) in n8n.
  • n8n Configuration: No special environment variables are required beyond standard credential setup.

Troubleshooting

Common Issues:

  • Invalid Chat ID: If the provided Chat ID does not exist or is incorrect, the operation will fail.
  • Authentication Errors: If your TelePilot session is expired or not logged in, you'll receive an error instructing you to log in again.
  • Permission Denied: If your account does not have permission to modify the chat's state, the operation will not succeed.

Error Messages & Resolutions:

  • "Please login: https://telepilot.co/login-howto"
    Resolution: Re-authenticate your TelePilot credentials using the provided guide.
  • "Session was closed or terminated. Please login again: https://telepilot.co/login-howto"
    Resolution: Your session has ended; re-login as instructed.
  • Other errors may be returned directly from the Telegram API, such as permission issues or invalid parameters. Double-check your input values and permissions.

Links and References

This summary covers the "Mark Chat as Unread" operation for the "Chat" resource in the TelePilot n8n node, focusing on its usage, configuration, and expected results.

Discussion