Telegram CoPilot icon

Telegram CoPilot

Your Personal Telegram CoPilot

Actions30

Overview

This node integrates with Telegram via the TelePilot API, enabling automation of various Telegram chat-related actions. Specifically, for the Chat resource and Delete Chat operation, it allows users to delete a specified chat by its ID. This is useful in scenarios where you want to programmatically manage your Telegram chats, such as cleaning up old or unwanted conversations automatically.

Practical examples include:

  • Automatically deleting chats after processing messages for privacy or organizational purposes.
  • Managing chat lifecycle in bots or automated workflows that interact with multiple Telegram groups or private chats.

Properties

Name Meaning
Chat ID The unique identifier of the chat to be deleted. This is a required string input.

Output

The output is a JSON object representing the result of the delete chat operation returned from the Telegram API via TelePilot. It typically contains confirmation details about the deletion or any relevant metadata returned by the API.

No binary data output is produced by this operation.

Example output structure (simplified):

{
  "id": 123456789,
  "type": "...",
  "title": "...",
  "is_deleted": true,
  ...
}

(The exact fields depend on the Telegram API response for the delete chat request.)

Dependencies

  • Requires an active Telegram API authentication credential (an API key/token) configured in n8n.
  • Depends on the TelePilot Node Connection Manager to handle client sessions and API calls.
  • The node expects the Telegram account to be logged in and authorized; otherwise, it will prompt for login.

Troubleshooting

  • Error: Please login
    Occurs if the Telegram session is not authenticated. Resolve by using the login flow with the ChatTrigger node or following the login guide at https://telepilot.co/login-howto.

  • Session was closed or terminated
    Indicates the client session expired or was closed. Re-login is required.

  • Unauthorized
    The provided credentials are invalid or expired. Re-authenticate your Telegram account.

  • Invalid Chat ID
    If the chat ID does not exist or is incorrect, the API may return an error. Verify the chat ID before attempting deletion.

  • Permission errors
    If the bot/account does not have permission to delete the chat, the operation will fail. Ensure appropriate rights.

Links and References

Discussion