N8N Tools Telegram icon

N8N Tools Telegram

Interact with Telegram Bot API

Overview

This node integrates with the Telegram Bot API via the N8N Tools Telegram service, enabling automation workflows to interact with Telegram bots. Specifically, for the Bots resource and the Set My Short Description operation, it allows users to update the short description of their Telegram bot programmatically.

This is useful in scenarios where you want to dynamically update your bot's short description based on external data or events, such as changing the description to reflect current promotions, status updates, or other contextual information without manual intervention.

Example use cases:

  • Automatically updating a bot’s short description daily to show new features or announcements.
  • Changing the short description based on user interactions or external triggers.
  • Managing multiple bots’ descriptions centrally through automated workflows.

Properties

Name Meaning
Options Additional options for the operation, provided as JSON. For this operation, can include language code or other optional parameters supported by Telegram API.

Note: The node supports many other properties for different resources and operations, but for the Bots - Set My Short Description operation, only the "Options" property is relevant here.

Output

The output of this node is a JSON object representing the response from the Telegram Bot API after setting the short description. This typically includes confirmation of the update or details about the updated description.

The output structure corresponds directly to the Telegram API response for the setMyShortDescription method, which usually returns a boolean true on success or an error message if failed.

No binary data output is involved in this operation.

Dependencies

  • Requires an active Telegram Bot API token configured as credentials in n8n.
  • Requires a valid subscription and API key for the N8N Tools API service, which acts as a proxy/validation layer for Telegram API calls.
  • The node makes HTTP requests to the N8N Tools API endpoint for validation before executing Telegram API calls.
  • Proper configuration of the N8N Tools API credentials (API URL and API key) is necessary.

Troubleshooting

  • Invalid subscription or API key error: If the node throws an error indicating invalid subscription or API key, verify that the N8N Tools API credentials are correctly set and active.
  • Unknown operation error: Ensure the operation name is exactly "setMyShortDescription" when configuring the node.
  • Malformed JSON in Options: The "Options" property expects valid JSON. Invalid JSON will cause parsing errors. Use proper JSON formatting.
  • Telegram API errors: Errors returned from Telegram (e.g., due to invalid bot token, rate limits, or invalid parameters) will be propagated. Check the Telegram Bot API documentation for error meanings.
  • Continue On Fail: If enabled, the node will continue processing subsequent items even if one fails, returning error details in the output JSON.

Links and References

Discussion