N8N Tools TelegramInstall

Overview

The node "N8N Tools Telegram" enables interaction with the Telegram Bot API, providing a wide range of operations across multiple Telegram resources such as messages, updates, chats, bots, files, inline queries, and callback queries. Specifically for the Bots resource with the Get My Commands operation, this node retrieves the list of commands that the bot has registered for itself.

This operation is useful when you want to programmatically fetch the current set of commands your Telegram bot supports, which can be helpful for synchronization, auditing, or displaying available commands dynamically in your workflows.

Practical example:
You might use this node to periodically check and log the commands your bot offers, or to verify that commands have been correctly set after an update.

Properties

Output

The output is a JSON object representing the response from the Telegram Bot API for the "getMyCommands" method. This typically includes an array of command objects, each describing a command supported by the bot, including fields like command name and description.

Example output structure (simplified):

{
  "ok": true,
  "result": [
    {
      "command": "start",
      "description": "Start interacting with the bot"
    },
    {
      "command": "help",
      "description": "Get help information"
    }
  ]
}

No binary data output is involved in this operation.

Dependencies

• Requires an API key credential for the "N8N Tools API" service, which acts as a proxy/validation layer before calling the Telegram Bot API.
• Requires Telegram Bot API credentials (an API token for the Telegram bot).
• The node internally uses a helper class to interact with Telegram's API endpoints.
• The node performs a validation request to the external N8N Tools API service before executing the Telegram API call.

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 for the N8N Tools API is correct and active.

• Unknown operation error:
  If the operation name is incorrect or unsupported, the node will throw an "Unknown operation" error. Ensure the operation parameter is set exactly to "getMyCommands" for this resource.

• Malformed JSON in Options:
  The "Options" property expects valid JSON. Invalid JSON syntax will cause parsing errors. Use proper JSON formatting.

• API rate limits or network issues:
  As the node depends on external APIs, network failures or rate limiting by Telegram or the N8N Tools API may cause errors. Check connectivity and API usage quotas.

Links and References

• Telegram Bot API - getMyCommands
• Telegram Bot API Documentation
• n8n Documentation