N8N Tools Telegram icon

N8N Tools Telegram

Interact with Telegram Bot API

Overview

This node integrates with the Telegram Bot API via an intermediary service called "N8N Tools API." It allows users to perform various bot-related operations such as retrieving bot information, managing commands, and updating bot descriptions. Specifically, for the Bots resource and the Set My Description operation, it updates the description of the Telegram bot.

Common scenarios where this node is beneficial include:

  • Automating updates to a Telegram bot's profile description based on external data or workflows.
  • Managing bot metadata dynamically without manual intervention.
  • Integrating Telegram bot management into broader automation pipelines.

For example, you could use this node to update your bot’s description daily with new information or promotional text pulled from another system.

Properties

Name Meaning
Options Additional options in JSON format; for the "Set My Description" operation, can include language code to specify the description language.

The Options property accepts a JSON object that may contain optional parameters such as language_code to localize the description.

Example of Options value:

{
  "language_code": "en"
}

Output

The node outputs a JSON object representing the response from the Telegram Bot API after setting the bot description. This typically includes confirmation details or the updated description data.

The output is structured as:

{
  // Telegram API response fields related to the setMyDescription method
}

No binary data output is involved in this operation.

Dependencies

  • Requires an active subscription and valid API key for the "N8N Tools API" service, which acts as a proxy to the Telegram Bot API.
  • The node expects credentials containing the API URL and API key for this service.
  • Proper Telegram Bot API credentials must be configured within the N8N environment to authorize requests.

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 set and active.
  • Unknown operation error: Ensure the operation name matches exactly one of the supported operations for the Bots resource.
  • Malformed JSON in Options: Since the Options parameter expects JSON, ensure it is well-formed. Invalid JSON will cause parsing errors.
  • API request failures: Network issues or incorrect API URLs can cause failures. Confirm connectivity and correct configuration of the API endpoint.

Links and References

Discussion