N8N Tools Telegram icon

N8N Tools Telegram

Interact with Telegram Bot API

Overview

This node integrates with the Telegram Bot API to perform various bot-related actions. Specifically, for the Bots resource and the Set My Profile Photo operation, it allows you to update the profile photo of your Telegram bot.

Use cases include:

  • Automatically updating your bot's profile picture based on external triggers or events.
  • Managing your bot's appearance programmatically without manual intervention.
  • Integrating with workflows that require dynamic branding or seasonal profile photo changes.

For example, you could connect this node to a workflow that updates your bot’s profile photo daily with a new image fetched from an external source.

Properties

Name Meaning
Options Additional options as a JSON object (for Bots resource operations other than messages).

Note: For the Set My Profile Photo operation specifically, the main input property used is:

Name Meaning
photo The photo data representing the new profile photo to set for the bot. This is typically a file identifier or file data accepted by the Telegram API.

The provided properties JSON only shows a generic "Options" property, but the code indicates that the photo parameter is required for setting the profile photo.

Output

The node outputs a JSON object containing the response from the Telegram Bot API after attempting to set the profile photo. This response typically includes information about the success of the operation and any relevant metadata returned by Telegram.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for the Telegram Bot API.
  • Requires a subscription and valid API key for the external "N8N Tools API" service, which validates usage before forwarding requests to Telegram.
  • The node uses HTTP requests to communicate with both the N8N Tools API and the Telegram Bot API endpoints.
  • No additional environment variables are explicitly required beyond the credentials mentioned.

Troubleshooting

  • Invalid Subscription or API Key: If the node throws an error indicating invalid subscription or API key, verify that your API key credential is correct and active.
  • Unknown Operation Error: If an unsupported operation is selected, the node will throw an error. Ensure the operation name matches one of the supported ones listed in the node.
  • Malformed Photo Data: If the photo data is not correctly formatted or missing, the Telegram API may reject the request. Make sure the photo parameter contains valid data according to Telegram's requirements.
  • HTTP Request Failures: Network issues or incorrect API URLs can cause failures. Confirm network connectivity and credential configurations.

Links and References

Discussion