N8N Tools Telegram icon

N8N Tools Telegram

Interact with Telegram Bot API

Overview

This node integrates with the Telegram Bot API to perform various chat-related operations. Specifically, for the Revoke Chat Invite Link operation under the "Chats" resource, it allows you to revoke an existing invite link for a Telegram chat. This is useful when you want to invalidate a previously shared invite link to prevent further users from joining the chat via that link.

Common scenarios include:

  • Managing group or channel membership by invalidating old invite links.
  • Enhancing security by revoking invite links after a certain event or time.
  • Automating chat administration tasks within workflows.

Example: Automatically revoke a chat invite link after a promotional campaign ends to restrict new joiners.

Properties

Name Meaning
Chat ID The unique identifier for the Telegram chat where the invite link exists (required).
Options Additional options as a JSON object (optional), can be used to specify extra parameters.

Note: For this specific operation ("Revoke Chat Invite Link"), the main required property is Chat ID and the invite link string itself (passed as inviteLink parameter internally).

Output

The output of this operation is a JSON object representing the result returned by the Telegram Bot API for revoking the chat invite link. Typically, this will confirm whether the invite link was successfully revoked and may include details about the revoked link.

The output structure is:

{
  // Telegram API response fields related to the revoked invite link
}

No binary data output is involved in this operation.

Dependencies

  • Requires an active Telegram Bot API token credential configured in n8n.
  • Requires a valid subscription and API key for the external "N8N Tools API" service, which validates usage before forwarding requests to Telegram.
  • The node uses the "N8N Tools API" endpoint to validate the API key and subscription status before executing Telegram API calls.

Troubleshooting

  • Invalid subscription or API key error: If you receive an error indicating invalid subscription or API key, verify that your API credentials are correct and that your subscription to the external validation service is active.
  • Unknown operation error: Ensure the operation name is correctly set to "revokeChatInviteLink" under the "Chats" resource.
  • Missing required parameters: Make sure the "Chat ID" and the invite link to revoke are provided.
  • Telegram API errors: Errors from Telegram (e.g., invalid chat ID, invite link not found) will be passed through; check the error message for specifics and verify the input values.

Links and References


If you need details on other operations or resources, please let me know!

Discussion