N8N Tools Telegram icon

N8N Tools Telegram

Interact with Telegram Bot API

Overview

The node provides integration with the Telegram Bot API, enabling various operations on Telegram resources such as messages, updates, chats, bots, files, inline queries, and callback queries. Specifically, for the Chats resource and the Unpin All Chat Messages operation, this node allows you to remove all pinned messages from a specified Telegram chat.

This operation is useful when you want to clear all pinned messages in a group or channel chat, for example, to reset announcements or important messages that are no longer relevant.

Practical Example

  • Automatically unpin all messages in a Telegram group chat at the end of an event.
  • Clear pinned messages in a channel before posting new important updates.

Properties

Name Meaning
Chat ID The unique identifier for the target Telegram chat where messages will be unpinned. This is required.
Options Additional optional parameters in JSON format (not specifically used for this operation but available for other operations).

Output

The output of the node is a JSON object representing the response from the Telegram Bot API for the unpinning operation. Typically, this will confirm whether the unpinning was successful.

  • The json field contains the API response data.
  • 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 validation layer before making Telegram API calls.
  • The node uses the external Telegram Bot API via HTTP requests wrapped by an internal helper class.

Troubleshooting

  • Invalid subscription or API key error: If you receive errors about invalid subscription or API key, verify that your API key credential for the N8N Tools API is correct and active.
  • Unknown operation error: Ensure the operation name matches exactly "unpinAllChatMessages" when configuring the node.
  • Chat ID issues: Make sure the Chat ID is correct and the bot has permission to manage messages in that chat.
  • Permission errors: The bot must have appropriate admin rights in the chat to unpin messages; otherwise, the API call will fail.

Links and References

Discussion