N8N Tools Telegram icon

N8N Tools Telegram

Interact with Telegram Bot API

Overview

The node interacts with the Telegram Bot API to perform various operations related to Telegram files, specifically including managing stickers within sticker sets. The "Set Sticker Position In Set" operation allows users to change the position of a sticker within an existing sticker set.

This node is beneficial in scenarios where you want to programmatically organize or reorder stickers in your Telegram bot's sticker sets without manual intervention. For example, if you maintain a sticker set and want to highlight certain stickers by moving them to the front or rearranging their order dynamically based on user feedback or events, this operation automates that process.

Practical example: A Telegram bot admin wants to move a newly added sticker to the first position in a sticker set to promote it. Using this node, they can specify the sticker and the desired position, and the node will update the sticker set accordingly.

Properties

Name Meaning
Options Additional options as a JSON object. This can include any extra parameters supported by the Telegram API for the selected operation.

Note: For the "Set Sticker Position In Set" operation under the "Files" resource, the following input properties are used internally (not listed in the provided JSON but inferred from code usage):

  • sticker (string): Identifier of the sticker to reposition.
  • position (number): New zero-based position of the sticker in the set.

These two are required to specify which sticker to move and to what position.

Output

The output is a JSON object representing the response from the Telegram Bot API after attempting to set the sticker position in the set. Typically, this will be a boolean true indicating success or an error message if the operation failed.

No binary data output is involved in this operation.

Example output JSON:

{
  "ok": true,
  "result": true
}

Dependencies

  • Requires an active Telegram Bot API token (provided via credentials).
  • Requires access to the N8N Tools API for subscription validation, which uses an API key credential.
  • The node makes HTTP requests to both the Telegram Bot API and the N8N Tools API.
  • Proper configuration of these credentials in n8n is necessary for successful execution.

Troubleshooting

  • Invalid subscription or API key error: If the node throws an error about invalid subscription or API key, verify that the API key credential for the N8N Tools API is correct and active.
  • Unknown operation error: Ensure that the operation name matches exactly one of the supported operations; typos or unsupported operations will cause errors.
  • Sticker not found or invalid position: If the Telegram API returns an error, check that the sticker identifier is valid and that the position is within the allowed range of the sticker set.
  • Permission issues: The bot must have appropriate rights to modify the sticker set; otherwise, the API call will fail.

Links and References

Discussion