N8N Tools Telegram icon

N8N Tools Telegram

Interact with Telegram Bot API

Overview

The node "N8N Tools Telegram" integrates with the Telegram Bot API, enabling automation workflows to interact with Telegram chats, messages, bots, files, inline queries, callback queries, and updates. Specifically, for the Chats resource and the Export Chat Invite Link operation, this node exports an invite link for a specified Telegram chat.

This operation is useful when you want to programmatically retrieve the current invite link of a Telegram group or channel to share it externally or use it in other automated processes. For example, you might automate sending the invite link to new users via email or post it on a website.

Properties

Name Meaning
Chat ID The unique identifier for the Telegram chat (group or channel) from which to export the invite link. This is required.
Options Additional options as a JSON object. (Not used specifically in this operation but available for extensibility.)

Output

The output is a JSON object representing the response from the Telegram Bot API for the exported chat invite link. Typically, this includes the invite link URL and related metadata about the chat invite link.

Example output structure (simplified):

{
  "invite_link": "https://t.me/joinchat/AAAAAEg...",
  "chat_id": 123456789,
  "other_metadata": { ... }
}

No binary data output is involved in this operation.

Dependencies

  • Requires an active Telegram Bot API token credential to authenticate requests.
  • 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" base URL (https://api.telegram.org) and sends HTTP POST requests to perform operations.
  • Proper configuration of credentials in n8n is necessary for successful execution.

Troubleshooting

  • Invalid subscription or API key error: If the node throws an error indicating invalid subscription or API key, verify that the API key credential is correctly configured and active.
  • Unknown operation error: Ensure the operation name matches exactly "exportChatInviteLink" under the Chats resource.
  • Missing Chat ID: The Chat ID property is required; missing or incorrect Chat ID will cause errors.
  • API rate limits or Telegram restrictions: Telegram may restrict invite link exports based on bot permissions or chat type; ensure the bot has appropriate admin rights.
  • Network or connectivity issues: Since the node depends on external API calls, network problems can cause failures.

Links and References


This summary focuses on the "Chats" resource and the "Export Chat Invite Link" operation as requested.

Discussion